Edición de «Java Native Interface»

'''Java Native Interface''' ('''JNI''') es un [[Framework|framework de programación]] que permite que un programa escrito en [[lenguaje de programación Java|Java]] ejecutado en la [[máquina virtual java]] (JVM) pueda interactuar con programas escritos en otros lenguajes como [[lenguaje de programación C|C]], [[lenguaje de programación C++|C++]] y [[ensamblador]].

== Propósito y características ==

El JNI se usa para escribir métodos nativos que permitan solventar situaciones en las que una aplicación no puede ser enteramente escrita en [[lenguaje de programación Java|Java]], como por ejemplo en el caso de que la [[Biblioteca (programación)|biblioteca]] estándar de [[Clase (informática)|clases]] no proporcione soporte para funcionalidades dependientes de la plataforma.

También se usa para modificar programas existentes escritos en algún otro lenguaje, permitiéndoles ser accesibles desde aplicaciones Java. Muchas de las clases de la API estándar de Java dependen del JNI para proporcionar funcionalidad al desarrollador y al usuario, por ejemplo las funcionalidades de sonido o lectura/escritura de ficheros. El desarrollador debe asegurarse que la API estándar de Java no proporciona una determinada funcionalidad antes de recurrir al JNI, ya que la primera ofrece una implementación segura e independiente de la plataforma.

El [[framework]] JNI permite a un método nativo utilizar los [[Objeto (programación)|objetos]] Java de la misma forma en que el propio código de Java lo hace. Un método nativo puede crear objetos Java; y examinarlos y utilizarlos para que lleven a cabo su función. Un método nativo puede asimismo examinar y utilizar objetos que han sido creados por código de aplicación escrito en Java.

A menudo se denomina a JNI como la "válvula de escape" para desarrolladores dado que les permite añadir funcionalidades a sus aplicaciones que el [[Application Programming Interface|API]] de Java no puede proporcionar.

Dado que -como se ha dicho antes- puede ser usado para interactuar con código escrito en otros lenguajes como C++, también se usa para operaciones y cálculos de alta complejidad temporal, porque el código nativo es por lo general más rápido que el que se ejecuta en una máquina virtual.

== Advertencias ==

JNI no es en absoluto trivial,  Se recomienda que sea usado por programadores experimentados. En cualquier caso, la posibilidad de comunicar Java con C, C++ o ensamblador, desestima toda limitación en lo que los programas Java pueden hacer.

Es aconsejable tener en cuenta los siguientes puntos cuando se considera usar JNI:

# JNI no es un [[Application Programming Interface|API]] fácil de aprender.
# Pequeños errores en el uso de JNI pueden desestabilizar completamente la máquina virtual Java, de formas muy difíciles de reproducir y subsanar.
# Solo las aplicaciones y applets firmados pueden invocar el JNI.
# Una aplicación que recurre a JNI pierde una de las características más importantes que Java le confiere, su portabilidad. (Una forma de solventar esto, es escribir una implementación separada del código JNI por cada plataforma, y hacer a Java detectar el [[sistema operativo]] para ejecutar una u otra implementación llegado el momento).
# No hay recolección de basura en el lado JNI, (el código JNI debe deslocalizar explícitamente sus punteros).

El colector automático de basura de Java es algo distinto a malloc/free en C, dado que puede ''mover'' objetos después de que se les haya sido asignada la memoria necesaria. Es por lo tanto de vital importancia que los punteros a objetos Java sean obtenidos y bloqueados correctamente. Los programadores habituados a C a menudo no entienden esto, lo que puede llevarles a provocar errores bastante ''esotéricos'' e irreproducibles.

Por todo lo anterior, JNI debe ser utilizado con cautela y suele ser evitado por los desarrolladores Java. Por ejemplo, la mayoría de las bases de datos JDBC se comunican directamente con un socket en lugar de utilizar las API existentes en C.

== 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).

==Bibliografía==

* {{cita libro|url=http://java.sun.com/docs/books/jni/|título=Java Native Interface: Programmer's Guide and Specification|autor=Sheng Liang|editorial=Addison-Wesley|año=1999|isbn=0-201-32577-2|otros=[http://java.sun.com/docs/books/jni/download/jni.pdf Versión en pdf]|idioma=inglés}}

{{Control de autoridades}}
[[Categoría:Interfaces de programación de aplicaciones de Java]]