23.4 Erweiterte JNI-Eigenschaften

In dem letzten Beispiel haben wir auf der Java-Seite wenig gemacht. Wir haben lediglich eine C-Funktion aufgerufen und ein Ergebnis zurückgegeben. Wir wollen jetzt Objekt-Eigenschaften auslesen, Methoden aufrufen und Objekte erzeugen. JNI bietet noch mehr als nur die Übergabe von primitiven Datentypen und Strings.

23.4.1 Klassendefinitionen

Ein Java-Objekt wird in JNI in der Parameterliste durch den Typ jobject repräsentiert. Um auf Attribute eines Java-Objekts zuzugreifen, müssen wir zunächst die Klassendefinition erfragen. Aus dem Kapitel Reflection kennen wir das schon:

Class clazz = o.getClass();

Ähnlich funktioniert das in JNI auch. Wir benutzen dort die Funktion GetObjectClass().

jclass jclass;   // Zuweisung mit Initialisierung in klassischem C nicht möglich
jclass = (*env)->GetObjectClass( env, obj ); 

obj repräsentiert das Objekt, zu welchem wir die Klassendefinition besorgen.

native void foo( C c );

Die Übersetzung liefert uns etwa:

JNIEXPORT jobject JNICALL foo( JNIEnv *env, jobject in_c )

Dann holen wir mit GetObjectClass() die Klassendefinition, die anschließend in jclass steht:

jclass jclass = (*env)->GetObjectClass( env, in_c );

23.4.2 Zugriff auf Attribute

Um unter Reflection auf die Attribute zuzugreifen, muss über das Class-Objekt ein Field-Objekt akquiriert werden.

Field field = clazz.getField( Feldname );

Ähnlich funktioniert auch dieses wieder in JNI. Mit der Funktion GetFieldID() erhalten wir einen Zeiger auf den Speicherplatz eines Felds.

class C { int i; }

Um die Attribut-ID zu erlangen, schreiben wir:

jfieldID jfid;
jfid = (*env)->GetFieldID( env, jclass, "i", "I");

Den zweiten Parameter entlarven wir als Zeiger auf die Klassendefinition. Der dritte Parameter kennzeichnet den Namen der Variablen (i in der Klasse C), und der letzte Parameter definiert den Typ der Variablen. Das große I kennzeichnet einen Integer, und die anderen Typen haben wir schon einmal beleuchtet. Zur Wiederholung:

Der letzte Schritt ist das Auslesen beziehungsweise Setzen der Werte. Wiederum soll uns Reflection eine Orientierung geben:

Class clazz = o.getClass();
Field field = clazz.getField( Feldname );
field.setAttribute( o, new Integer(9) );

jfieldID jfid;
jclass jclass;
jint val;
jclass = (*env)->GetObjectClass( env, in_c );
jfid   = (*env)->GetFieldID( env, jclass, "i", "I");
val    = (*env)->GetIntField( env, in_c, jfid )

Für die unterschiedlichen Typen stehen ebenfalls ganz unterschiedliche GetXXXField()-Funktionen bereit. Die Tabelle fasst sie zusammen:

Die entsprechenden SetXXXField()-Funktionen lassen sich leicht ableiten. Die letzte Frage ist nur noch die nach den Datentypen. Die anschließende Tabelle zeigt, welcher Java-Typ welchem nativen Typ zugeordnet ist und wie diese interpretiert werden dürfen.

Weitere Themen sind dem Buch »Advanced Programming for the Java 2 Platform« online unter http://developer.java.sun.com/developer/onlineTraining/Programming/JDCBook/jniref. html zu entnehmen.