JNIEnv對象

對於本地函數

JNIEXPORT void JNICALL Java_video1_TestNative_sayHello(JNIEnv * env, jobject obj)

{

cout<<"Hello Native Test !"<<endl;

}

JNIEnv類型代表Java環境。通過這個JNIEnv*指針，就可以對Java端的代碼進行操作。如，創建Java類得對象，調用Java對象的方法，獲取Java對象的屬性等。

JNIEnv的指針會被JNI傳送到本地方法的實現函數中來對Java端的代碼進行操作

JNIEnv類中的函數：

NewObject/NewString/New<TYPE>Array ：new新對象

Get/Set<TYPE>Field：獲取屬性

Get/SetStatic<TYPE>Field ：獲取靜態屬性

Call<TYPE>Method/CallStatic<TYPE>Method：調用方法

2. Java數據類型與C/C++數據類型的對應關係

可以參考 jni.h 文件：http://home.pacifier.com/~mmead/jni/cs510ajp/jni.h

Java類型      別名　　           C++本地類型　　        字節(bit)  
boolean      jboolean            unsigned char8, unsigned  
byte         jbyte               signed char8
char         jchar               unsigned short16, unsigned  
short        jshort              short16
int          jint                long32
long         jlong               __int64　　　　     64
float        jfloat              float　　　
       32
double       jdouble             double64
voidvoid        　　　　      
                n/a　　 

Object _jobject *jobject

3. 獲取jclass

爲了能夠在C/C++使用Java類，jni.h頭文件中專門定義了jclass類型來表示Java中的Class類

jclass的取得：

JNIEnv類中有如下幾個簡單的函數可以取得jclass

jclass FindClass(const char* clsName) 根據類名來查找一個類，完整類名。

jclass GetObjectClass(jobject obj) 根據一個對象，獲取該對象的類

jclass GetSuperClass(jclass obj) 獲取一個類的父類

FindClass 會在classpath系統環境變量下尋找類，需要傳入完整的類名，注意包與包之間是用"/"而不是"."來分割

如：jclass cls_string= env->FindClass("java/lang/String");

獲取jclass又什麼用，比如你要調用類的靜態方法，靜態屬性就需要通過這個方法來獲取一個類。

4. 本地代碼訪問Java類中的屬性與方法

有了類和對象之後，如何才能訪問java中的對象的屬性和方法呢，這就需要用到以下這些方法了。

JNI在jni.h頭文件中定義了jfieldID，jmethodID類表示Java端的屬性和方法

如何獲取屬性：在訪問或設置Java屬性的時候，首先就要現在本地代碼中取得代表Java屬性的jfieldID，然後才能在本地代碼中進行Java屬性操作。

如何調用java的方法：調用Java端的方法時，需要取得代表方法的jmethodID才能進行Java方法調用

JNIEnv獲取相應的fieldID和jmethodID的方法：

GetFieldID/GetMethodID

GetStaticFieldID/GetStaticMethodID

GetMethodID也可以取得構造函數的jmethodID。創建Java對象時調用指定的構造函數。

如：env->GetMethodID(data_Clazz,"method_name","()V")

(*jniEnv)->GetMethodID(jniEnv, Clazz,"<init>", "()V");

這個比較特殊，這個是默認構造函數的方法，一般用這個來初始化對象，但是再實際過程中，爲了快速生成一個實例，一般通過工廠方法類創建jobject

jni.h 對GetMethodID的定義：

jmethodID (JNICALL *GetMethodID)

(JNIEnv *env, jclass clazz, const char *name, const char *sig);

這就引入了一個新的問題，什麼是sig，我們後面再說，舉個例子說明

前提說明： JAVA類 TestProvider ,該類有2個方法分別爲String getTime( ) , void saysayHello( String str)

jclass TestProvider;

jobject mTestProvider;

jmethodID getTime;

jmethodID sayHello;

C 中映射類

TestProvider = (*jniEnv)->FindClass(jniEnv,"com/duicky/TestProvider");

C中新建對象

      //默認構造函數，不傳參數
       jmethodID construction_id = (*jniEnv)->GetMethodID(jniEnv, TestProvider,"<init>", "()V");

       //通過NewObject來創建對象
       jobject mTestProvider = (*jniEnv)->NewObject(jniEnv, TestProvider,construction_id);

C 中映射方法

       靜態：

getTime = (*jniEnv)->GetStaticMethodID(jniEnv, TestProvider, "getTime","()Ljava/lang/String;");

       非靜態：

sayHello = (*jniEnv)->GetMethodID(jniEnv, TestProvider, "sayHello","(Ljava/lang/String;)V");

C 中調用 Java的方法

       靜態：

(*jniEnv)->CallStaticObjectMethod(jniEnv, TestProvider, getTime);

       非靜態：

(*jniEnv)->CallVoidMethod(jniEnv, mTestProvider, sayHello,jstrMSG);

注意 GetXXXMethodID 和 CallXXXMethod 。

第一個XXX 表示的是映射方法的類型，如：靜態跟非靜態

第二個 XXX 表示調用方法的返回值，如：Void,Object,等等。（調用靜態方法的時候Call後面要加Static）

5. sign簽名

對於 jmethodID GetMethodID(jclass clazz, const char *name, const char *sign)

clazz代表該屬性所在的類，name表示方法名稱，sign是簽名

那什麼是簽名，簽名是對函數參數和返回值的描述，對同一個函數，在java中允許重載，這個時候就需要這個sign來進行區分了。

以下是java類型簽名的描述

用來表示要取得的屬性/方法的類型

類型           相應的簽名  
boolean        Z  
byte           B  
char           C  
short          S  
int            I  
long           J  
float          F  
double         D  
void           V  
object         L用/分隔包的完整類名：   Ljava/lang/String; 
Array          [簽名          [I      [Ljava/lang/Object;  
Method         (參數1類型簽名 參數2類型簽名···)返回值類型簽名  

特別注意：Object後面一定有分號（；）結束的,多個對象參數中間也用分號(;)來分隔

例子：

方法簽名

void f1()                         ()V
int f2(int, long)
                (IJ)I
boolean f3(int[])                 ([I)B
double f4(String, int)
           (Ljava/lang/String;I)D
void f5(int, String [], char)    (I[Ljava/lang/String;C)V

圖解簽名：

使用javap命令來產生簽名

javap -s -p [full class Name]

-s 表示輸出簽名信息

-p 同-private,輸出包括private訪問權限的成員信息

例子：

 C:\E\java\workspaces\myeclipseblue\JNITest\bin>javap -s -private video1.TestNative  

Compiled from "TestNative.java"  
public class video1.TestNative extends java.lang.Object{  
public java.lang.String name;  

  Signature: Ljava/lang/String;  
public video1.TestNative();  

  Signature: ()V  
public int signTest(int, java.util.Date, int[]);  

  Signature: (ILjava/util/Date;[I)I  
public native void sayHello();  

  Signature: ()V  
public static void main(java.lang.String[]);  

  Signature: ([Ljava/lang/String;)V  

}   

TestNative完整代碼：

package video1;  
import java.util.Date;  
public class TestNative {  

    public String name="Test";  

    public int number =100;  

    public int signTest(int i,Date date,int[] arr){  

        System.out.println("Sign Test");  

        return 0;  

    }  

    //native關鍵字修飾的方法，其內容是C/C++編寫的，java中不必爲它編寫具體的實現  
    public native void sayHello();  

    public static void main(String[] args) {  

        System.loadLibrary("NativeCode");  

        TestNative tn = new TestNative();  

        tn.sayHello();  

    }  

}

C/C++代碼

#include "video1_TestNative.h"  

#include <iostream>  
using namespace std;  

JNIEXPORT void JNICALL Java_video1_TestNative_sayHello(JNIEnv * env, jobject obj){  

    cout<<"Hello Native Test !"<<endl;  

    //因爲test不是靜態函數，所以傳進來的就是調用這個函數的對象  

    //否則就傳入一個jclass對象表示native()方法所在的類  
    jclass native_clazz = env->GetObjectClass(obj);  

    //得到jfieldID  
    jfieldID fieldID_prop = env->GetFieldID(native_clazz,"name","Ljava/lang/String;");  

    jfieldID fieldID_num = env->GetFieldID(native_clazz,"number","I");  

    //得到jmethodID  
    jmethodID methodID_func=env->GetMethodID(native_clazz,"signTest","(ILjava/util/Date;[I)I");  

    //調用signTest方法  
    env->CallIntMethod(obj,methodID_func,1L,NULL,NULL);  

    //得到name屬性  
    jobject name = env->GetObjectField(obj,fieldID_name);  

    //得到number屬性  
    jint number= env->GetIntField(obj,fieldID_num);   

    cout<<number<<endl;//100  

    //修改number屬性的值  
    env->SetIntField(obj,fieldID_num,18880L);    

    number= env->GetIntField(obj,fieldID_num);    

    cout<<number<<endl;//18880  
 }