介绍
JNI是我喜欢的java编程框架;它让你你自由的使用本地编写的代码。例如,如果你想要在你的java程序中使用Windows API(不如说dll),那么你就要用JNI。
Java最受欢迎的特性就是它的平台无关性。但是,有时候这一特性也会使你将Java程序与本地平台整合变得困难。
例如,在我们的工程中,将消息添加到数据库之前,我们使用MSM Q(Microsoft Messaging Que)的队列机制来维护消息(为了避免消息丢失)。Microsoft提供了MSM Q API,它是Windows的API。但是我们的程序使用Java来处理消息的,并且Java不能直接访问这样的API(dll)。因此我们决定做一个中间DLL,它能够作为Java和VC++之间的桥(我们用过的技术Java Native Inteface或JNI)。
在进一步介绍之前,你应该知道或熟悉的下面一些知识:
1.本地方法:本地方法是一个用在.Java文件中声明的方法,并且这个声明将在你的本地代码(对于Windows来说是在VC++中)中定义。
2. 静态块:Java中的静态块是指在任何其他事情发生前就能够被执行的代码块。
那么让我们开始吧。首先,用本地方法声明来写你的Java程序。下面代码来自源代码中的例子:
public class JNITest
{
static
{
System.loadLibrary("JNITest"); // Loading dll in memory
}
native void showMessage( String str); // Declaring native method
public JNITest()
{
System.out.println( "In the constructor of the Java program" );
}
public static void main( String s[] )
{
JNITest JNT = new JNITest();
JNT.showMessage("Passing string from Java");
}
}
在上面的代码中我们声明了showMessage方法,它是本地的方法,然后调用它,w.r.t 类JNITest的对象。
执行下面的步骤:
1.编译代码生成.class文件
2.在JDK文件夹中找到javah命令
3.在Dos命令行下执行javah -jni JNITest
执行完上面的步骤将产生JNITest .h文件。这个.h文件包含了在Java代码中声明的本地方法的VC++中的函数名。
创建JNI DLL
我已经完成了一半了。
现在,在Visual Studio(和其他任何win32 IDE)创建一个简单的dll工程然后添加上面的.h文件到工程中。
为了获得包含的文件jni.h,添加JRE\INCLUDE文件夹的路径到你的includes中。
现在你会发现在.Java文件中声明的方法的命名,稍微有些不同。
在上面的例子中你会得到:
JNIEXPORT void JNICALL Java_JNITest_showMessage(JNIEnv *, jobject, jstring);
这里,第三个参数是你的从Java中输入的参数。你能转换它成本地的形式如下:
const char *strS1 = env->GetStringUTFChars( s1, 0);
这里,你能够在程序中使用steS1作为C++字符串。在demo程序中我使用了它,把它显示在MessageBox中。有许多JNIEnv的方法,通过这些方法我们可以将多种Java数据类型转换成C++数据类型。
使用完字符串之后必须释放它,字符串不会自用释放。JNI的行为被假设为JVM的外部行为,因此它不会抛任何类型的能够被Java代码捕捉的异常。如果在离开函数前,你忘记了释放字符串,那么这可能会导致你的JVM的crash。
你可以使用函数ReleaseStringUTFChars释放字符串:
env->ReleaseStringUTFChars( s1, strS1);
整个代码可能会是这样:
JNIEXPORT void JNICALL Java_JNITest_showMessage(
JNIEnv * env, jobject job, jstring str )
{
const char *strMsgPtr = env->GetStringUTFChars( str , 0);
//Converting string to C++ character pointer
MessageBox( 0, strMsgPtr,"Message box from VC++ ", 0 );
//Using the string
env->ReleaseStringUTFChars( str, strMsgPtr);
// Releasing the string ( character pointer )
}
现在你可以自由的使用Windows(或VC++)组件做任何事情了??现在你可以使用Windows API了。
编译一个dll然后放在Java程序的文件夹中(这个文件夹包含你的.class文件)。
现在运行你的Java程序。
注意:如果你得到了UnSatisfiedLinkError错误,那么检查你的方法原型,它必须与你在.h文件中提供的一样。
使用JNI你可以在Java程序中使用许多Windows提供的工具。