介紹
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提供的工具。
Download source files - 14.1 Kb
Download demo project - 10.3 Kb
PrafullaVedante
|
Click here to view PrafullaVedante's online profile. |