JNI是我喜欢的java编程框架;它让你你自由的使用本地编写的代码。例如,如果你想要在你的java程序中使用Windows API(不如说dll),那么你就要用JNI。
GrvhjrGl jG6 + Java最受欢迎的特性就是它的平台无关性。但是,有时候这一特性也会使你将Java程序与本地平台整合变得困难。
Z\HQ2 9e\^]-~ 例如,在我们的工程中,将消息添加到数据库之前,我们使用MSM Q(Microsoft Messaging Que)的队列机制来维护消息(为了避免消息丢失)。Microsoft提供了MSM Q API,它是Windows的API。但是我们的程序使用Java来处理消息的,并且Java不能直接访问这样的API(dll)。因此我们决定做一个中间DLL,它能够作为Java和VC++之间的桥(我们用过的技术Java Native Inteface或JNI)。
\GK!{HeO $R ")AK(! 在进一步介绍之前,你应该知道或熟悉的下面一些知识:
|=LN5@p %rDrty -B 1.本地方法:本地方法是一个用在.Java文件中声明的方法,并且这个声明将在你的本地代码(对于Windows来说是在VC++中)中定义。
x*ny#C 4[?-K_5X 2. 静态块:Java中的静态块是指在任何其他事情发生前就能够被执行的代码块。
`?dnxVX^ &qfBm\Y$ 那么让我们开始吧。首先,用本地方法声明来写你的Java程序。下面代码来自源代码中的例子:
R*H#,.<6 Goc+]@K :
n7 2K:
public class JNITest j m$j|Z,
{ 9EWXS)+-|
static %Igl `+mE
{ &v,H'%eTe
System.loadLibrary("JNITest"); // Loading dll in memory 0w XR_JzR
} wOJ 9\
8$e) Z0
native void showMessage( String str); // Declaring native method *# ZXuVI"
public JNITest() Y%wh5,73F
{ |K'vS$%
System.out.println( "In the constructor of the Java program" ); vO{3f||
} XKJ^5zSn
)S;Bt#!$G
public static void main( String s[] ) M ,1bE!
{ (k_Ro-Fw`
JNITest JNT = new JNITest(); ykd}Mz"
JNT.showMessage("Passing string from Java"); ^9UxJ-}
} NlQ]1@)
} CM9r`]kr
PbDq%P?>2 在上面的代码中我们声明了showMessage方法,它是本地的方法,然后调用它,w.r.t 类JNITest的对象。
}g olVWl x>VSpO&2/ 执行下面的步骤:
LP{;Wnp p$Z2p/;YuP 1.编译代码生成.class文件
FAK Dr4 A_+#zi?@@ 2.在JDK文件夹中找到javah命令
4%^z^*P&4 S0J!7l) 3.在Dos命令行下执行javah -jni JNITest
DRV t) pr==A0\#] 执行完上面的步骤将产生JNITest .h文件。这个.h文件包含了在Java代码中声明的本地方法的VC++中的函数名。
r0-8jj;;A $mXR9N[ u 创建JNI DLL
qIFg;zcGT bxg~uB: 我已经完成了一半了。
B7j i0 wEv >#R 现在,在Visual Studio(和其他任何win32 IDE)创建一个简单的dll工程然后添加上面的.h文件到工程中。
8Kgi&:~0 wW >%<YP 为了获得包含的文件jni.h,添加JRE\INCLUDE文件夹的路径到你的includes中。
lPSfCO%tU ~ %v~N[( 现在你会发现在.Java文件中声明的方法的命名,稍微有些不同。
I_C2MTT f `~N93v 在上面的例子中你会得到:
2HfYjo7" KZ:;gL]]I JNIEXPORT void JNICALL Java_JNITest_showMessage(JNIEnv *, jobject, jstring);
vEN>2/a X[Y&bQe- 这里,第三个参数是你的从Java中输入的参数。你能转换它成本地的形式如下:
]7tKd]y* rlq=qp const char *strS1 = env->GetStringUTFChars( s1, 0);
-P=CxxQQ[ A9/L_ L9 这里,你能够在程序中使用steS1作为C++字符串。在demo程序中我使用了它,把它显示在MessageBox中。有许多JNIEnv的方法,通过这些方法我们可以将多种Java数据类型转换成C++数据类型。
"xr4WC W2! Bu< 使用完字符串之后必须释放它,字符串不会自用释放。JNI的行为被假设为JVM的外部行为,因此它不会抛任何类型的能够被Java代码捕捉的异常。如果在离开函数前,你忘记了释放字符串,那么这可能会导致你的JVM的crash。
\.l DwYDN\X[Oy 你可以使用函数ReleaseStringUTFChars释放字符串:
ccR|s<\ env->ReleaseStringUTFChars( s1, strS1);
:;B?Nh 4O ,|9]kKkm 整个代码可能会是这样:
`PX9D{!p W(xv6 -,C
G*6 Q?'6+
JNIEXPORT void JNICALL Java_JNITest_showMessage( >S=k{vS(
JNIEnv * env, jobject job, jstring str ) R]|!tnn ry
{ l"f$5a
const char *strMsgPtr = env->GetStringUTFChars( str , 0); hQK HI
//Converting string to C++ character pointer fIXD/%v"
527 ;(I
MessageBox( 0, strMsgPtr,"Message box from VC++ ", 0 ); jq|f.gQ
//Using the string S#k5LTn
2K%3{Pgyj
env->ReleaseStringUTFChars( str, strMsgPtr); G2/{\Qi
// Releasing the string ( character pointer ) dF{]:[Zo
} tPyNS^U
m%-<7.7 9^v's4x 现在你可以自由的使用Windows(或VC++)组件做任何事情了??现在你可以使用Windows API了。
1[!'\;LC\ 'JJ83 <7 编译一个dll然后放在Java程序的文件夹中(这个文件夹包含你的.class文件)。
G[P&_5 %58u>^L6 现在运行你的Java程序。
gR7L-=I Yi*%m8lFn 注意:如果你得到了UnSatisfiedLinkError错误,那么检查你的方法原型,它必须与你在.h文件中提供的一样。
\=Vpy|~ + *a4_`KASg 使用JNI你可以在Java程序中使用许多Windows提供的工具。