JNI的使用

創(chuàng)建：2005-10-28 00:34:31
作者：Unlinux
來自: http://www.Unlinux.com

一．系統(tǒng)環(huán)境 2
二．JNI的簡(jiǎn)要使用例子 2
三．JNI調(diào)用中考慮的問題 3
四．JNI中對(duì)JAVA傳入數(shù)據(jù)的處理 5
五．JAVA調(diào)用本地接口后的數(shù)據(jù)處理問題 5
六．JAVA中的一些小東西 5

一．系統(tǒng)環(huán)境
linux操作系統(tǒng)kernel2.4.2，安裝j2sdk1.4.0
二．JNI的簡(jiǎn)要使用例子
下面是一個(gè)簡(jiǎn)單的例子實(shí)現(xiàn)打印一句話的功能，但是用的c的printf最終實(shí)現(xiàn)。一般提供給java的jni接口包括一個(gè)so文件（封裝了c函數(shù)的實(shí)現(xiàn)）和一個(gè)java文件（需要調(diào)用path的類）。
1． JNI的目的是使java方法中能夠調(diào)用c實(shí)現(xiàn)的一些函數(shù)，比如以下的java類，就需要調(diào)用一個(gè)本地函數(shù)testjni（一般聲明為private native類型），首先需要?jiǎng)?chuàng)建文件weiqiong.java，內(nèi)容如下：
class weiqiong
{
static
{
System.loadLibrary("testjni");//載入靜態(tài)庫，test函數(shù)在其中實(shí)現(xiàn)
}
private native void testjni(); //聲明本地調(diào)用
public void test()
{
testjni();
}
public static void main(String args[])
{
weiqiong haha = new weiqiong();
haha.test();
}
}

2．然后執(zhí)行javac weiqiong.java，如果沒有報(bào)錯(cuò)，會(huì)生成一個(gè)weiqiong.class。

3．然后執(zhí)行javah weiqiong，會(huì)生成一個(gè)文件weiqiong.h文件，其中有一個(gè)函數(shù)的聲明如下：
JNIEXPORT void JNICALL Java_weiqiong_testjni
(JNIEnv *, jobject);

4．創(chuàng)建文件testjni.c將上面那個(gè)函數(shù)實(shí)現(xiàn)，內(nèi)容如下：
#include <stdio.h>
#include <weiqiong.h>
JNIEXPORT void JNICALL Java_weiqiong_testjni
(JNIEnv *env, jobject obj)
{
printf("haha---------go into c!!!n");
}

5．為了生成.so文件，創(chuàng)建makefile文件如下：
libtestjni.so:testjni.o makefile
gcc -Wall -rdynamic -shared -o libtestjni.so testjni.o
testjni.o:testjni.c weiqiong.h
gcc -Wall -c testjni.c -I./ -I/usr/java/j2sdk1.4.0/include -I/usr/java/j2sdk1.4.0/include/linux
cl:
rm -rf *.o *.so
注意：gcc前面是tab空，j2sdk的目錄根據(jù)自己裝的j2sdk的具體版本來寫，生成的so文件的名字必須是loadLibrary的參數(shù)名前加“l(fā)ib”。

6．export LD_LIBRARY_PATH=.，由此設(shè)置library路徑為當(dāng)前目錄，這樣java文件才能找到so文件。一般的做法是將so文件copy到本機(jī)的LD_LIBRARY_PATH目錄下。

7．執(zhí)行java weiqiong，打印出結(jié)果：“haha---------go into c!!!”
三．JNI調(diào)用中考慮的問題
在首次使用JNI的時(shí)候有些疑問，后來在使用中一一解決，下面就是這些問題的備忘：

1。 java和c是如何互通的？
其實(shí)不能互通的原因主要是數(shù)據(jù)類型的問題，jni解決了這個(gè)問題，例如那個(gè)c文件中的jstring數(shù)據(jù)類型就是java傳入的String對(duì)象，經(jīng)過jni函數(shù)的轉(zhuǎn)化就能成為c的char*。
對(duì)應(yīng)數(shù)據(jù)類型關(guān)系如下表：
Java 類型 本地c類型 說明
boolean jboolean 無符號(hào)，8 位
byte jbyte 無符號(hào)，8 位
char jchar 無符號(hào)，16 位
short jshort 有符號(hào)，16 位
int jint 有符號(hào)，32 位
long jlong 有符號(hào)，64 位
float jfloat 32 位
double jdouble 64 位
void void N/A

JNI 還包含了很多對(duì)應(yīng)于不同 Java 對(duì)象的引用類型如下圖：


2。 如何將java傳入的String參數(shù)轉(zhuǎn)換為c的char*，然后使用?
java傳入的String參數(shù)，在c文件中被jni轉(zhuǎn)換為jstring的數(shù)據(jù)類型，在c文件中聲明char* test，然后test = (char*)(*env)->GetStringUTFChars(env, jstring, NULL);注意：test使用完后，通知虛擬機(jī)平臺(tái)相關(guān)代碼無需再訪問：(*env)->ReleaseStringUTFChars(env, jstring, test);

3. 將c中獲取的一個(gè)char*的buffer傳遞給java？
這個(gè)char*如果是一般的字符串的話，作為string傳回去就可以了。如果是含有’’的buffer，最好作為bytearray傳出，因?yàn)榭梢灾贫╟opy的length，如果copy到string，可能到’’就截?cái)嗔恕?有兩種方式傳遞得到的數(shù)據(jù)：
一種是在jni中直接new一個(gè)byte數(shù)組，然后調(diào)用函數(shù)(*env)->SetByteArrayRegion(env, bytearray, 0, len, buffer);將buffer的值copy到bytearray中，函數(shù)直接return bytearray就可以了。
一種是return錯(cuò)誤號(hào)，數(shù)據(jù)作為參數(shù)傳出，但是java的基本數(shù)據(jù)類型是傳值，對(duì)象是傳遞的引用，所以將這個(gè)需要傳出的byte數(shù)組用某個(gè)類包一下，如下：
class RetObj
{
public byte[] bytearray;
}
這個(gè)對(duì)象作為函數(shù)的參數(shù)retobj傳出，通過如下函數(shù)將retobj中的byte數(shù)組賦值便于傳出。代碼如下：
jclass cls;
jfieldID fid;
jbyteArray bytearray;
bytearray = (*env)->NewByteArray(env,len);
(*env)->SetByteArrayRegion(env, bytearray, 0, len, buffer);
cls = (*env)->GetObjectClass(env, retobj);
fid = (*env)->GetFieldID(env, cls, "retbytes", "[B"]);
(*env)->SetObjectField(env, retobj, fid, bytearray);

4。 不知道占用多少空間的buffer，如何傳遞出去呢？
在jni的c文件中new出空間，傳遞出去。java的數(shù)據(jù)不初始化，指向傳遞出去的空間即可。
四．JNI中對(duì)JAVA傳入數(shù)據(jù)的處理
1． 如果傳入的是bytearray的話，作如下處理得到buffer：
char *tmpdata = (char*)(*env)->GetByteArrayElements(env, bytearray, NULL);
(*env)->ReleaseByteArrayElements(env, bytearray, tmpdata, 0);
五．JAVA調(diào)用本地接口后的數(shù)據(jù)處理問題
1． java得到的數(shù)據(jù)是String的話，直接處理就可以了。
2． 得到的如果是bytearray的話，作如下處理：
DataInputStream in = new DataInputStream(new ByteArrayInputStream(bytearray));
byte []byte1 = new byte[36]; 
in.read(byte1,0,36);
String string = new String(byte1);
System.out.println("讀出的第一個(gè)字段為："+string);
六．JAVA中的一些小東西
1．JAVA中常用數(shù)據(jù)類型轉(zhuǎn)換函數(shù)
string->byte
Byte static byte parseByte(String s) 

byte->string 
Byte static String toString(byte b) 

char->string 
Character static String to String (char c) 

string->Short 
Short static Short parseShort(String s) 

Short->String 
Short static String toString(Short s) 

String->Integer 
Integer static int parseInt(String s)

Integer->String 
Integer static String tostring(int i) 

String->Long 
Long static long parseLong(String s) 

Long->String 
Long static String toString(Long i) 

String->Float 
Float static float parseFloat(String s) 

Float->String 
Float static String toString(float f) 

String->Double 
Double static double parseDouble(String s)

Double->String
Double static String toString(Double d) 

2． 類的數(shù)據(jù)類型轉(zhuǎn)換
//轉(zhuǎn)換string為int
public static int stringToInt(String intstr)
{
Integer integer;
integer = Integer.valueOf(intstr);
return integer.intValue();
}
//轉(zhuǎn)換int為string
public static String intToString(int value)
{
Integer integer = new Integer(value);
return integer.toString();
}
//轉(zhuǎn)換string為float
public static float stringToFloat(String floatstr)
{
Float floatee;
floatee = Float.valueOf(floatstr);
return floatee.floatValue();
}
//轉(zhuǎn)換float為string
public static String floatToString(float value)
{
Float floatee = new Float(value);
return floatee.toString();
}
//change the string type to the sqlDate type
public static java.sql.Date stringToDate(String dateStr)
{
return java.sql.Date.valueOf(dateStr);
}
//change the sqlDate type to the string type
public static String dateToString(java.sql.Date datee)
{
return datee.toString();
}
六．參考文檔
1．JAVA本地接口規(guī)范
http://www.iplab.is.tsukuba.ac.jp/~liuxj/jdk1.2/zh/docs/guide/jni/spec/jniTOC.doc.html

2．JAVA與C++::關(guān)于JNI中文字符串操作問題總結(jié)
http://dev.csdn.net/Develop/article/17/17157.shtm