Editando Java Native Interface (sección)

== Cómo funciona el JNI ==

En JNI, las funciones nativas se implementan en archivos .c o .cpp por separado (C++ ofrece una interfaz con JNI ligeramente más clara). Cuando la máquina virtual invoca a la función, le pasa un puntero a <code>JNIEnv</code>, un puntero a <code>jobject</code>, y cualquier número de argumentos declarados por el método Java. Una función de JNI debería parecerse a esto:

<syntaxhighlight lang="c">
 JNIEXPORT void JNICALL Java_ClassName_MethodName
   (JNIEnv *env, jobject obj)
 {
     //El método nativo se implementa aquí
 }
</syntaxhighlight>

El puntero ''<code>JNIEnv *env</code>'' es una estructura que contiene la interfaz hacia la máquina virtual. Incluye todas las funciones necesarias para interactuar con la JVM (Java Virtual Machine) y para trabajar con los objetos Java.

Como ejemplos de uso de esta interfaz, se pueden mencionar la conversión de vectores (estilo C) de/a vectores Java o cadenas nativas (punteros a carácter) de/a cadenas Java (objetos String); instanciación de objetos, lanzamiento y captura de excepciones, etc.

En esencia, usando <code>JNIEnv</code> puede hacerse cualquier cosa que el código Java pueda hacer; eso sí, con una dificultad considerablemente incrementada.

Por ejemplo, el siguiente fragmento de código convierte una cadena de Java en una nativa.

<syntaxhighlight lang="cpp">
 //Código C++
 JNIEXPORT void JNICALL Java_ClassName_MethodName
   (JNIEnv *env, jobject obj, jstring javaString)
 {
     //Tomar la cadena nativa de la cadena de java
     const char *nativeString = env->GetStringUTFChars(javaString, 0);

     //Hacer algo con ella

     /* NO OLVIDE ESTA LÍNEA, libera el espacio ocupado por la cadena usada
      * esto tiene que ver con la forma en que Java maneja las cadenas */
     env->ReleaseStringUTFChars(javaString, nativeString);
 }
</syntaxhighlight>

<syntaxhighlight lang="c">
 //C code
 JNIEXPORT void JNICALL Java_ClassName_MethodName
   (JNIEnv *env, jobject obj, jstring javaString)
 {
     //Tomar la cadena nativa de la cadena de java
     const char *nativeString = (*env)->GetStringUTFChars(env, javaString, 0);

     //Hacer algo con ella

     /* NO OLVIDE ESTA LÍNEA, libera el espacio ocupado por la cadena usada
      * esto tiene que ver con la forma en que Java maneja las cadenas */
     (*env)->ReleaseStringUTFChars(env, javaString, nativeString);
 }
</syntaxhighlight>

Nótese que el código JNI de C++ es sintácticamente más claro que el código en C, porque al igual que Java, C++ usa una semántica de invocación de métodos orientada a objetos,

Esto implica que en C, el parámetro <code>env</code> debe ser desreferenciado usando <code>(*env)</code> y debe ser pasado explícitamente (aparece como parámetro) a los métodos de <code>JNIEnv</code>.

En C++, el parámetro <code>env</code> se desreferencia usando <code>env-></code> y se pasa implícitamente como parte de la semántica de invocación de métodos orientada a objetos (no aparece como parámetro porque el método forma parte de env cuando se trata como un objeto).

Los [[Tipo de dato|tipos de datos]] nativos pueden sufrir conversiones desde/hacia tipos de datos Java. Para tipos complejos, tales como los objetos, [[Vector (programación)|arrays]] y [[Cadena de caracteres|cadenas]], el método nativo debe convertir los datos explícitamente llamando a métodos en el <code>JNIEnv</code> (Java Native Interface Environment).