作者：陳健明

作者簡介

陳健明，華中師范大學(xué)網(wǎng)絡(luò)與通訊研究所，您可以通過chenjm2000@hotmail.com和作者取得聯(lián)系。

內(nèi)容摘要

JNI是JDK的一部分，用于為Java提供一個本地代碼的接口。通過使用JNI編寫的程序能夠確保你的代碼能夠完全的移植到所有的平臺。JNI使得運行在JVM虛擬機上的Java代碼能夠操作使用其它語言編寫的應(yīng)用程序和庫，比如C/C++以及匯編語言等。此外JNI提供的某些API還允許你把JVM嵌入到本地應(yīng)用程序中。下圖表達(dá)了JNI所扮演的角色。

本文將通過一個實例來闡述使用VC++6.0來實現(xiàn)JNI的完整過程。使用JNI來整合本地代碼和Java代碼的步驟是確定的，沒有再創(chuàng)作的余地，所以讀者可以通過本文的步驟來逐步認(rèn)識到，其實Java也是"沒有什么不可以"的。

一、JNI的實現(xiàn)

任務(wù)描述：在Java中調(diào)用windows下的消息框函數(shù)，并且從Java中傳遞一個字符串作為MessageBox函數(shù)的顯示文本參數(shù)，顯示在消息框的中間。下面讓我們一起進(jìn)入這一奇妙的旅程。

Step 1：寫一個Java類，在這個類中包含了需要調(diào)用的本地方法的描述。

//WinMsgBox.java
package edu.netcom.jni;
public class WinMsgBox  
{
	static{
		System.loadLibrary("WinMsgDll");    // (1)
	}
	public native void showMsgBox(String str);  // (2)
}

(1)中WinMsgDll是動態(tài)鏈接文件的文件名，不用加擴(kuò)展名，因為在不同的平臺下動態(tài)鏈接文件擴(kuò)展名是不同的，由JVM自動識別，比如在Solaris下，會被轉(zhuǎn)換為WinMsgDll.so；而Win32環(huán)境下會轉(zhuǎn)換為WinMsgDll.dll。這個文件名必須和Step 4中生成的文件名一致。這個文件的存放位置也很重要，它只能被放在JVM屬性值java.library.path中指定的文件夾中。這個屬性值可以使用System.getProperty("java.library.path");來查看。一般情況下，至少放在這幾個位置是確定可靠的，windows安裝目錄下的system32下面，JDK安裝目錄下的bin下面，以及調(diào)用主類文件的當(dāng)前目錄。

(2)中指明了你必須用本地代碼實現(xiàn)的方法。

Step 2：提示符下使用命令javac -d . WinMsgBox.java編譯Step 1編寫的java文件。

此時會在當(dāng)前目錄下建立一個edu\netcom\jni目錄結(jié)構(gòu)，并且一個WinMsgBox.class文件存在其中。

Step 3：提示符下使用命令javah -jni edu.netcom.jni.WinMsgBox，此時會在當(dāng)前目錄下產(chǎn)生一個edu_netcom_jni_WinMsgBox.h文件，注意這個文件名是由（包名+類名）組成，中間用（_）隔開。此文件內(nèi)容如下：

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>                       // (1)
/* Header for class edu_netcom_jni_WinMsgBox */

#ifndef _Included_edu_netcom_jni_WinMsgBox
#define _Included_edu_netcom_jni_WinMsgBox
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     edu_netcom_jni_WinMsgBox
 * Method:    showMsgBox
 * Signature: (Ljava/lang/String;)V       // (2)
 */
JNIEXPORT void JNICALL Java_edu_netcom_jni_WinMsgBox_showMsgBox
  (JNIEnv *, jobject, jstring);           // (3)

#ifdef __cplusplus
}
#endif
#endif

(1)包含的jni.h存在于JDK安裝目錄下的include下面。

(2)(Ljava/lang/String;)V這是函數(shù)的標(biāo)記符，當(dāng)從本地方法端訪問Java端的方法時，會用到這個標(biāo)記符。JNI中為每種數(shù)據(jù)類型也定義了標(biāo)記符，標(biāo)記符的規(guī)則請查看JNI標(biāo)準(zhǔn)文檔。

(3)在WinMsgBox.java中本地方法void showMsgBox(String str);的定義，被映射為JNIEXPORT void JNICALL Java_edu_netcom_jni_WinMsgBox_showMsgBox(JNIEnv *, jobject, jstring); 其中函數(shù)名的映射規(guī)則是（Java_包名_類名_方法名），如果存在重載的方法，則在后面還會增加每個參數(shù)的標(biāo)記符。每一個方法映射到本地C函數(shù)后都會增加兩個參數(shù)：JNIEnv *和jobject，關(guān)于這兩個參數(shù)的用法將在后面闡述。另外，所有Java中的數(shù)據(jù)類型都會按一定規(guī)則進(jìn)行映射為本地數(shù)據(jù)類型，這些數(shù)據(jù)類型都是在jni.h中定義的。下面分別按照基本數(shù)據(jù)類型，和對象類型列出。

表1 Java基本類型到本地類型的映射

表2 Java中的類到本地類型的映射

Step 4：使用VC來編寫本地方法的實現(xiàn)函數(shù)，最后編譯成.dll文件。過程如下：

1) 選擇new->projects(選擇Win32 Dynamic-Link Library，以Step 1中指定的庫名WinMsgDll作為工程名)->OK->An ampty DLL project->Finish。

2) 選擇Tools->Options->Directories(添加目錄D:\J2SDK1.4.2_03\INCLUDE和D:\J2SDK1.4.2_03\INCLUDE\WIN32)。在這些目錄中包含JNI所需的頭文件。

3) 將Step 3生成的edu_netcom_jni_WinMsgBox.h拷貝到WinMsgDll工程文件夾中。然后FileView中添加這個頭文件。

4) 添加源文件WinMsgDll.cpp，內(nèi)容如下：

#include "windows.h"
#include "edu_netcom_jni_WinMsgBox.h"
/*
 * Class:     edu_netcom_jni_WinMsgBox
 * Method:    showMsgBox
 * Signature: (Ljava/lang/String;)V
 */
JNIEXPORT void JNICALL Java_edu_netcom_jni_WinMsgBox_showMsgBox
(JNIEnv * env, jobject obj, jstring str){
	const char *msg;
	msg = env->GetStringUTFChars(str,0);
	MessageBox(NULL,msg,"Java invoke",MB_OK);
	env->ReleaseStringUTFChars(str,msg);
}

5) 編譯生成WinMsgBox.dll文件。并將這個.dll文件拷貝到Step 1中說明的目錄中。

注意：

1) 我們知道dll文件有兩種指明導(dǎo)出函數(shù)的方法，一種是在.def文件中定義，另一種是在定義函數(shù)時使用關(guān)鍵字__declspec(dllexport)。而在JNI中函數(shù)定義中的關(guān)鍵字JNIEXPORT實際在jni_md.h中如下定義，#define JNIEXPORT __declspec(dllexport)，可見JNI默認(rèn)的導(dǎo)出函數(shù)使用第二種。使用第二種方式產(chǎn)生的導(dǎo)出函數(shù)名會根據(jù)編譯器發(fā)生變化，在有的情況下會發(fā)生找不到導(dǎo)出函數(shù)的問題（我們在JSP中使用JNI時就發(fā)生了這種問題，百思不得其解，后來強行加入一個.def文件就解決了）。因此最好是使用第一種方法自己定義一個.def文件來指明導(dǎo)出函數(shù)，這種情況下會強制使用第一種方式產(chǎn)生導(dǎo)出函數(shù)。本例中可以加入一個WinMsgDll.def文件，內(nèi)容如下：

LIBRARY      "WinMsgDll"
DESCRIPTION  'message Windows Dynamic Link Library'
EXPORTS
    ; Explicit exports can go here
	Java_edu_netcom_jni_WinMsgBox_showMsgBox

2) 從本例中，我們可以看到WinMsgBox.java決定了edu_netcom_jni_WinMsgBox.h，而后者又決定了WinMsgDll.dll，也就是說，這是一個"牽一發(fā)而動全身"的過程，如果你改動了WinMsgBox.java，就一定要把整個步驟都走一遍（這一點一定要切記，因為這也是我們跌得鼻青臉腫后才得出的警世良言）。

3) 生成的.dll文件一定要正確拷貝到Step 1說明的目錄中，本例中是將生成的WinMsgDll.dll和Step 5中的測試文件放在同一個目錄下的（這也是我們困惑了很久才解決的問題）。

Step 5：編寫一個測試文件來測試對WinMsgDll.dll的調(diào)用。測試文件TestJNI.java內(nèi)容如下：

//TestJNI.java
import edu.netcom.jni.WinMsgBox;
public class TestJNI 
{
	public static void main(String[] args) 
	{
		     WinMsgBox box = new WinMsgBox();
		box.showMsgBox("Wonderful!!");
	}
}

編譯，運行，windows下的對話框躍然屏幕中間。到此為此，整個JNI的實現(xiàn)過程就已經(jīng)完成了。

二、補充說明

JNI為程序員提供了一種方法，使得他們能夠充分利用JVM以外的，完全由平臺決定的功能。但是你不應(yīng)該濫用JNI。大多數(shù)情況可能是因為這樣而必須使用JNI，如你已經(jīng)有做好了的本地.dll文件，其中已經(jīng)包含了大量嘔心瀝血的函數(shù)，而你不愿意，也不可能完全用Java重寫它們，那么此時你應(yīng)該用JNI。但是你必須按前面的步驟來進(jìn)行，只是在Step 4中編寫的.dll要調(diào)用已有的本地.dll，也就是說用Step 4中的.dll"封裝"已有的.dll。

在Java中定義的本地方法映射到本地C函數(shù)后都會增加兩個參數(shù)：JNIEnv *和jobject。第一個參數(shù)JNIEnv是一個指針，指向在jni.h中定義的一個數(shù)據(jù)結(jié)構(gòu)，結(jié)構(gòu)中包含了一系列的函數(shù)的指針，我們把它們稱之為JNI函數(shù)。使用這些JNI函數(shù)可以使程序員從本地函數(shù)這一側(cè)完成對Java的操作，如訪問Java字符串、數(shù)組、調(diào)用Java的方法、成員變量、甚至處理Java端的異常等。第二個參數(shù)會根據(jù)Java類中本地方法的定義不同而不同，如果是定義為static方法，類型會是jclass，表示對特定Class對象的引用，如果是非static方法，類型是jobject，表示當(dāng)前對象的引用（本例中就是對WinMsgBox對象的引用），相當(dāng)于this。

C函數(shù)通過JNI接受來自Java的傳參也是按基本類型直接傳值，對象傳引用。對于基本類型可以按照表1來使用，其它類型都必須使用JNI函數(shù)進(jìn)行轉(zhuǎn)換后才能在C函數(shù)中使用。如本例中從Java中傳遞了一個字符串，映射為JNI類型jstring。使用JNI函數(shù)GetStringUTFChars將jstring轉(zhuǎn)換為UTF-8字符串，然后便可以使用C語言中的任何字符串操作函數(shù)進(jìn)行操作。由于JVM在調(diào)用本地方法時，是在虛擬機中開辟了一塊本地方法棧供本地方法使用，當(dāng)本地方法使用完UTF-8串后，必須使用ReleaseStringUTFChars，通過它來通知虛擬機去回收UTF-8串占用的內(nèi)存，否則將會造成內(nèi)存泄漏，最終導(dǎo)致系統(tǒng)崩潰。同樣的，如果需要將C函數(shù)返回的返回值能夠正確通過JNI傳給Java，也要使用JNI函數(shù)轉(zhuǎn)換為前面兩個表中的類型。

關(guān)于 JNI 函數(shù)的權(quán)威文檔請參閱 Java Native Interface 1.5 Specification

關(guān)于 JNI 函數(shù)的教程請參閱 Java Native Interface Tutorial