java挪用固有要领
我们先从一个简朴的例子开始:一个Java措施挪用固有要领,后者再挪用Win32的API函数MessageBox(),显示出一个图形化的文本框。这个例子稍后也会与J/Direct一志利用。若您的平台不是Win32,只需将包括了下述内容的C头:
#include <windows.h>
替换成:
#include <stdio.h>
并将对MessageBox()的挪用换成挪用printf()即可。
第一步是写出对固有要领及它的自变量举办声明的Java代码:
class ShowMsgBox { public static void main(String [] args) { ShowMsgBox app = new ShowMsgBox(); app.ShowMessage("Generated with JNI"); } private native void ShowMessage(String msg); static { System.loadLibrary("MsgImpl"); } }
在固有要领声明的后头,跟从有一个static代码块,它会挪用System.loadLibrary()(可在任何时候挪用它,但这样做更得当)System.loadLibrary()将一个DLL载入内存,并成立同它的链接。DLL必需位于您的系统路径,可能在包括了Java类文件的目次中。按照详细的平台,JVM会自动添加适当的文件扩展名。
1. C头文件生成器:javah
此刻编译您的Java源文件,并对编译出来的.class文件运行javah。javah是在1.0版里提供的,但由于我们要利用Java 1.1 JNI,所以必需指定-jni参数:
javah -jni ShowMsgBox
javah会读入类文件,并为每个固有要领声明在C或C++头文件里生成一个函数原型。下面是输出功效——ShowMsgBox.h源文件(为切合本书的要求,稍微举办了一下修改):
/* DO NOT EDIT THIS FILE - it is machine generated */ #include <jni.h> /* Header for class ShowMsgBox */ #ifndef _Included_ShowMsgBox #define _Included_ShowMsgBox #ifdef __cplusplus extern "C" { #endif /* * Class: ShowMsgBox * Method: ShowMessage * Signature: (Ljava/lang/String;)V */ JNIEXPORT void JNICALL Java_ShowMsgBox_ShowMessage (JNIEnv *, jobject, jstring); #ifdef __cplusplus } #endif #endif
从“#ifdef_cplusplus”这个预处理惩罚引导呼吁可以看出,该文件既可由C编译器编译,亦可由C++编译器编译。第一个#include呼吁包罗jni.h——一个头文件,浸染之一是界说在文件其余部门用到的范例;JNIEXPORT和JNICALL是一些宏,它们举办了适当的扩充,以便与那些差异平台专用的引导呼吁共同;JNIEnv,jobject以及jstring则是JNI数据范例界说。
2. 名称打点和函数签名
JNI统一了固有要领的定名法则;这一点长短常重要的,因为它属于虚拟机将Java挪用与固有要领链接起来的机制的一部门。从基础上说,所有固有要领都要以一个“Java”起头,后头跟从Java要领的名字;下划线字符则作为脱离符利用。若Java固有要领“过载”(即定名反复),那么也把函数签名追加到名字后头。在原型前面的注释里,各人可看到固有的签名。欲相识定名法则和固有要领签名更具体的环境,请参考相应的JNI文档。
3. 实现本身的DLL
此时,我们要做的全部工作就是写一个C或C++源文件,在个中包括由javah生成的头文件;并实现固有要领;然后编译它,生成一个动态链接库。这一部门的事情是与平台有关的,所以我假定读者已经知道如何建设一个DLL。通过挪用一个Win32 API,下面的代码实现了固有要领。随后,它会编译和链接到一个名为MsgImpl.dll的文件里:
#include <windows.h> #include "ShowMsgBox.h" BOOL APIENTRY DllMain(HANDLE hModule, DWORD dwReason, void** lpReserved) { return TRUE; } JNIEXPORT void JNICALL Java_ShowMsgBox_ShowMessage(JNIEnv * jEnv, jobject this, jstring jMsg) { const char * msg; msg = (*jEnv)->GetStringUTFChars(jEnv, jMsg,0); MessageBox(HWND_DESKTOP, msg, "Thinking in Java: JNI", MB_OK | MB_ICONEXCLAMATION); (*jEnv)->ReleaseStringUTFChars(jEnv, jMsg,msg); }
若对Win32没有乐趣,只需跳过MessageBox()挪用;最有趣的部门是它周围的代码。通报到固有要领内部的自变量是返回Java的大门。第一个自变量是范例JNIEnv的,个中包括了回调JVM需要的所有挂钩(下一节再具体报告)。由于要领的范例差异,第二个自变量也有本身差异的寄义。对付象上例那样的非static要领(也叫作实例要领),第二个自变量等价于C++的“this”指针,并雷同于Java的“this”:都引用了挪用固有要领的谁人工具。对付static要领,它是对特定Class工具的一个引用,要领就是在谁人Class工具里实现的。
剩余的自变量代表通报到固有要领挪用里的Java工具。主范例也是以这种形式通报的,但它们举办的“按值”通报。
在后头的小节里,我们筹备报告如何从一个固有要领的内部会见和节制JVM,同时对上述代码举办更详尽的表明。