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程序。下面代碼來自源代碼中的例子:
CODE:
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");
}
}
[Copy to clipboard]
在上面的代碼中我們聲明了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,添加JREINCLUDE文件夾的路徑到你的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);
整個代碼可能會是這樣:
CODE:
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 )
}
[Copy to clipboard]
現在你可以自由的使用Windows(或VC++)組件做任何事情了??現在你可以使用Windows API了。
編譯一個dll然後放在Java程序的文件夾中(這個文件夾包含你的.class文件)。
現在運行你的Java程序。
注意:如果你得到了UnSatisfIEdLinkError錯誤,那麼檢查你的方法原型,它必須與你在.h文件中提供的一樣。
使用JNI你可以在Java程序中使用許多Windows提供的工具。