JNI傳遞引數

工程師WWW發表於2015-09-01

最近作一個tiemsten資料庫的專案,用到了jni技術。在這個專案中,我們用java來寫介面和業務邏輯,用c語言寫資料庫odbc訪問。單純的odbc其實沒有什麼難的,但是在java和c之間進行資料傳遞是比較麻煩的事情。兩者之間資料的傳遞有這樣幾種情況:java和c之間基本資料型別的互動,java向c傳遞物件型別,c向java返回物件型別,c呼叫java類。下面就這樣幾種情況分類說明。

1、java 向c傳遞基本資料型別

對於基本資料型別,java和c是相互對應的,所以可以直接使用。它們的對應關係為;

------------------------------------------------------------------------

Java型別      本地型別   位元組(bit)

-------------------------------------------------------------------------
  
  boolean   jboolean   8, unsigned
  byte    jbyte     8
  char    jchar    16, unsigned
  short    jshort    16
  int     jint     32
  long    jlong    64
  float    jfloat    32
  double   jdouble   64
  void    void     n/a

------------------------------------------------------------------------

2.java向c傳遞物件型別

對於java傳遞進來的java物件模型,c要載入java類的原型,根據建立相應的c物件,獲取java物件的方法的id,然後呼叫java物件的方法。舉例說明:比如有個java類customer物件作為jni引數傳遞到c程式,customer有方法String getName()。

JNIEXPORT jobject JNICALL Java_com_oracle_estt_sc_db_impl_SCQueryODBC__1getCustomer
(JNIEnv *env, jobject,  jobject customer){

jmethodID methodId; 
 //獲得customer物件的控制程式碼
    jclass cls_objClass=env->GetObjectClass(customer); 
 //獲得customer物件中特定方法getName的id 
 methodId=env->GetMethodID(cls_objClass,"getName","()Ljava/lang/String;");
 //呼叫customer物件的特定方法getName
 jstring  js_name=(jstring)env->CallObjectMethod(customer,methodId,NULL);

...

}

3.c向java返回物件型別

在c程式中首先要建立要返回的java物件,得到每個屬性的id,然後給每個屬性賦值,最後返回。舉例說明:同樣是customer物件,有name等屬性值,需要在c程式中給每個屬性賦值後返回。

JNIEXPORT jobject JNICALL Java_com_oracle_estt_sc_db_impl_SCQueryODBC__1getCustomer
(JNIEnv *env, jobject,  jobject customer){

......

//發現java Customer類,如果失敗,程式返回 
 jclass   clazz = env->FindClass("com/oracle/estt/sc/busi/Customer");   
 if(clazz == 0)  
  return   0;    
 //為新的java類物件obj分配記憶體    
 jobject   obj = env->AllocObject(clazz);     
 //發現類中的屬性,如果失敗,程式返回   
 jfieldID   fid_id = env->GetFieldID(clazz,"customerID","I");  
 if (fid_id  ==  0)  
  return   0;
 jfieldID   fid_name = env->GetFieldID(clazz,"name","Ljava/lang/String;");  
 if (fid_name  ==  0)  
  return   0;
......

 env->SetIntField(obj, fid_id, 1
 env->SetObjectField(obj, fid_name, jname);

......

return obj;

}

4.c向java傳遞一個含有java物件的陣列

對於這種情況,先得到陣列的大小,接下來取出陣列中的物件,取得物件的屬性值或者呼叫物件的方法,將獲得值存到本地陣列中,然後可以靈活使用這些資料了。舉例說明:java向c傳遞一個含有多個customer物件的陣列,在c中將這個陣列的分解出來,存到本地的臨時陣列中去。

JNIEXPORT void JNICALL Java_com_oracle_estt_sc_db_impl_SCInsertODBC__1insertCustomeRequest___3Lcom_oracle_estt_sc_busi_CustomerRequest_2
(JNIEnv *env, jobject, jobjectArray oa){

...... 

//宣告customerrequest物件
 jobject o_customer;

 int i;
 jmethodID methodId; 
 jint size=env->GetArrayLength(oa);

_tmp_bind[0]= (char *)malloc(size*sizeof(int));
 _tmp_bind[1]= (char *)malloc(size*sizeof(char)*( 20 + 1));

...

//將輸入陣列的資料拷貝到臨時陣列中去
 for(i=0;i<size;i++){
 //從陣列中獲得customerrequest物件
    o_request=env->GetObjectArrayElement(oa,i);
 //獲得customerrequest物件的控制程式碼
 jclass cls_objClass=env->GetObjectClass(o_request);
 
 //獲得customerrequest物件的特定方法getCustomerID的id
 methodId=env->GetMethodID(cls_objClass,"getCustomerID","()I");
 //呼叫customerrequest物件的特定方法getCustomerID
 int_customerID=env->CallIntMethod(o_request,methodId,NULL); 
 //獲得customerrequest物件中特定方法getTelNum的id 
 methodId=env->GetMethodID(cls_objClass,"getTelNum","()Ljava/lang/String;");
 //呼叫customerrequest物件的特定方法getTelNum
 str_telNum=(jstring)env->CallObjectMethod(o_request,methodId,NULL); 

...

//將使用者id拷貝到臨時陣列
 memcpy(_tmp_bind[0]+i*sizeof(int),&int_customerID,sizeof(int));

 //將電話號碼拷貝到臨時陣列,如果電話號碼字串超長,報錯返回
 if(sizeof(char)*strlen(chr_tel)<=sizeof(char)*( 20 + 1)){
 memcpy(_tmp_bind[1]+i*sizeof(char)*( 20+1 ),chr_tel,strlen(chr_tel)+1);
 }else{
 printf("%s too long!\n",chr_tel);
 return;
 }

...

}

...

}

5.c向java返回一個陣列

先建立陣列,然後載入java物件,給每個java物件的屬性賦值,新增到陣列中,最後返回陣列。如下例:

JNIEXPORT jobjectArray JNICALL Java_com_oracle_estt_sc_db_impl_SCQueryODBC__1getCustomerRequest
(JNIEnv *env, jobject, jint customerid){

......

 //宣告存放查詢結果的objectarray
 jobjectArray jo_array = env->NewObjectArray(MAX_LINE,env->FindClass("com/oracle/estt/sc/busi/CustomerRequest"), 0);  jobject obj;
 //發現java Customerrequest類,如果失敗,程式返回 
 jclass   clazz = env->FindClass("com/oracle/estt/sc/busi/CustomerRequest");   
 if(clazz == 0)  
  return   0;

 while ((rc = SQLFetch(hstmt)) == SQL_SUCCESS ||rc == SQL_SUCCESS_WITH_INFO) {

 obj = env->AllocObject(clazz);

jfieldID   fid_customerID = env->GetFieldID(clazz,"customerID","I");  
  if (fid_customerID  ==  0)  
   return   0;

jfieldID   fid_priority = env->GetFieldID(clazz,"priority","I");  
  if (fid_priority  ==  0)  
   return   0;

...

env->SetIntField(obj, fid_customerID, col_customerID);

env->SetIntField(obj, fid_priority, col_priority);

...

//將物件obj新增到object array中
  if(j<MAX_LINE){
   env->SetObjectArrayElement(jo_array, j, obj);
  }else{
   break;
  }

}

return jo_array;

}

6.jstring向char* 的轉換

jstring不能直接在c程式中使用,需要轉換成char*。重要的一點是,在使用完char*之後,一定要記得將其釋放,以免發生記憶體洩漏。如下例:

JNIEXPORT jobjectArray JNICALL Java_com_oracle_estt_sc_db_impl_SCQueryODBC__1getCustomerRequestByCondition
(JNIEnv *env, jobject, jstring condition, jint customerid){

//將jstring轉換為cha*
 char* str_condition=(char*) env->GetStringUTFChars(condition,JNI_FALSE);

......

//釋放變數
 env->ReleaseStringUTFChars(condition,str_condition);

......

}

7.char*轉換成jstring

這個轉換就比較麻煩了,但是在資料庫操作時會用到。比如,從資料庫查詢得到的是char*,但是給物件屬性賦值的時候需要用jstring,這是需要用到這種轉換。具體如下例:

char* col_timestamp=.....;

//載入string類
 jclass strClass = env->FindClass("Ljava/lang/String;");
 //獲得方法id
 jmethodID ctorID = env->GetMethodID(strClass, "<init>", "([BLjava/lang/String;)V");

//將字串轉換為jstring  
  bytes_time = env->NewByteArray(strlen(col_timestamp));
  env->SetByteArrayRegion(bytes_time, 0, strlen(col_timestamp), (jbyte*)col_timestamp);
  jstring js_time = env->NewStringUTF("utf-8");

js_time=(jstring)env->NewObject(strClass, ctorID, bytes_time, js_time)


8.java類的原型獲取方法

在c中建立java物件和呼叫java物件方法時需要用到java類的原型,特別是其方法簽名。具體辦法是:到java類所在的目錄下,鍵入名命令:

>javap -s -p 包路徑.java類名

以上幾點是我這兩天寫jni程式的一點總結,寫出來與大家分享,歡迎批評指導。

推薦資料:

Java Native Interface Specification.http://java.sun.com/j2se/1.5.0/docs/guide/jni/spec/jniTOC.html

相關文章