傳遞和使用Java對象

在前例中，我們將一個字串傳遞給固有方法。事實上，亦可將自己建立的Java對象傳遞給固有方法。
在我們的固有方法內部，可訪問已收到的那些對象的欄位及方法。
為傳遞對象，聲明固有方法時要採用原始的Java文法。如下例所示，MyJavaClass有一個public（公用）欄位，以及一個public方法。UseObjects類聲明了一個固有方法，用於接收MyJavaClass類的一個對象。為調查固有方法是否能控制自己的自變數，我們設定了自變數的public欄位，調用固有方法，然後列印出public欄位的值。
 

class MyJavaClass {  public void divByTwo() { aValue /= 2; }  public int aValue;}public class UseObjects {  public static void main(String [] args) {    UseObjects app = new UseObjects();    MyJavaClass anObj = new MyJavaClass();    anObj.aValue = 2;    app.changeObject(anObj);    System.out.println("Java: " + anObj.aValue);  }  private native void   changeObject(MyJavaClass obj);  static {    System.loadLibrary("UseObjImpl");  }}

編譯好代碼，並將.class檔案傳遞給javah後，就可以實現固有方法。在下面這個例子中，一旦取得欄位和方法ID，就會通過JNI函數訪問它們。
 

JNIEXPORT void JNICALLJava_UseObjects_changeObject(  JNIEnv * env, jobject jThis, jobject obj) {  jclass cls;  jfieldID fid;  jmethodID mid;  int value;  cls = env->GetObjectClass(obj);  fid = env->GetFieldID(cls,        "aValue", "I");  mid = env->GetMethodID(cls,        "divByTwo", "()V");  value = env->GetIntField(obj, fid);  printf("Native: %d\n", value);  env->SetIntField(obj, fid, 6);  env->CallVoidMethod(obj, mid);  value = env->GetIntField(obj, fid);  printf("Native: %d\n", value);}

除第一個自變數外，C++函數會接收一個jobject，它代表Java對象引用“固有”的那一面——那個引用是我們從Java代碼裡傳遞的。我們簡單地讀取aValue，把它列印出來，改變這個值，調用對象的divByTwo()方法，再將值重新列印一遍。
為訪問一個欄位或方法，首先必須擷取它的標識符。利用適當的JNI函數，可方便地取得類對象、元素名以及簽名資訊。這些函數會返回一個標識符，利用它可訪問對應的元素。儘管這一方式顯得有些曲折，但我們的固有方法確實對Java對象的內部布局一無所知。因此，它必須通過由JVM返回的索引訪問欄位和方法。這樣一來，不同的JVM就可實現不同的內部物件版面配置，同時不會對固有方法造成影響。
若運行Java程式，就會發現從Java那一側傳來的對象是由我們的固有方法處理的。但傳遞的到底是什麼呢？是指標，還是Java引用？而且垃圾收集器在固有方法調用期間又在做什麼呢？
垃圾收集器會在固有方法執行期間持續運行，但在一次固有方法調用期間，我們的對象可保證不會被當作“垃圾”收集去。為確保這一點，事先建立了“局部引用”，並在固有方法調用之後立即清除。由於它們的“生命期”與調用過程息息相關，所以能夠保證對象在固有方法調用期間的有效性。
由於這些引用會在每次函數調用的時候建立和破壞，所以不可在static變數中製作固有方法的局部副本（本地拷貝）。若希望一個引用在函數存在期間持續有效，就需要一個全域引用。全域引用不是由JVM建立的，但通過調用特定的JNI函數，程式員可將局部引用擴充為全域引用。建立一個全域引用時，需對引用對象的“存留時間”負責。全域引用（以及它引用的對象）會一直留在記憶體裡，直到用特定的JNI函數明確釋放了這個引用。它類似於C的malloc()和free()。