¿Qué hace el método registerNatives()?

Question

En java, ¿qué hace el método estático privado registerNatives() de la clase Object?

Answer 1

Las otras respuestas son técnicamente correctas, pero no muy útiles para alguien sin experiencia en JNI. :-)

Normalmente, para que la JVM encuentre sus funciones nativas, deben nombrarse de cierta manera. por ejemplo, para java.lang.Object.registerNatives, la función C correspondiente se llama Java_java_lang_Object_registerNatives. Al usar registerNatives (o más bien, la función JNI RegisterNatives), puede asignarle el nombre que desee a sus funciones C.

Aquí está el código asociado C (de OpenJDK 6):

static JNINativeMethod methods[] = { 
    {"hashCode", "()I",     (void *)&JVM_IHashCode}, 
    {"wait",  "(J)V",     (void *)&JVM_MonitorWait}, 
    {"notify",  "()V",     (void *)&JVM_MonitorNotify}, 
    {"notifyAll", "()V",     (void *)&JVM_MonitorNotifyAll}, 
    {"clone",  "()Ljava/lang/Object;", (void *)&JVM_Clone}, 
}; 

JNIEXPORT void JNICALL 
Java_java_lang_Object_registerNatives(JNIEnv *env, jclass cls) 
{ 
    (*env)->RegisterNatives(env, cls, 
          methods, sizeof(methods)/sizeof(methods[0])); 
} 

(Nótese que Object.getClass no está en la lista, sino que seguirá siendo llamado por el nombre de "estándar" de Java_java_lang_Object_getClass.) Para las funciones en la lista, las funciones C asociadas se enumeran en esa tabla, lo que es más útil que escribir un grupo de funciones de reenvío.

El registro de funciones nativas también es útil si incorpora Java en su programa C y desea vincularlo con funciones dentro de la propia aplicación (a diferencia de una biblioteca compartida) o las funciones utilizadas no se "exportan" ", ya que estos normalmente no se encuentran por el mecanismo de búsqueda de método estándar. El registro de funciones nativas también se puede utilizar para "volver a enlazar" un método nativo a otra función C (útil si su programa admite cargar y descargar módulos dinámicamente, por ejemplo).

Animo a todos a leer el JNI book, que habla de esto y mucho más. :-)

Answer 2

Ya que miró el código fuente para encontrarlo, es bastante fácil de adivinar ¿no?

Es un método nativo, y se llama registerNatives, así que supongo que registra objetos con la plataforma subyacente.

También es privado, por lo que probablemente no hay nada de qué preocuparse.

Answer 3

Lo que podría ser un poco confuso es que el código mostrado para java.lang.Object.registerNatives en una respuesta anterior es solo un ejemplo de cómo registrar funciones nativas. Este es el código que (en la implementación de OpenJDK) registra funciones nativas para Object de clase. Para registrar funciones nativas para su propia clase, debe llamar a la función JNI RegisterNatives desde el código nativo en su propia biblioteca. Esto puede sonar un poco circular, pero hay un par de maneras de romper el ciclo.

1. seguir el ejemplo de esta implementación de la clase Object:

   a. En su clase de Java, declare un método nativo (preferiblemente estático) llamado registerNatives (o cualquier otro nombre, no importa).

   b. En su código nativo, defina una función llamada Java_<your fully qualified class name>_registerNatives, que contiene una llamada a la función JNI RegisterNatives.

   c. Asegúrese de que en su código Java, se llame a su método Java registerNatives antes de cualquier llamada a otros métodos nativos.

O

2. Uso JNI_OnLoad

   a. En su biblioteca nativa, defina una función jint JNI_OnLoad(JavaVM *vm, void *reserved). En el cuerpo de esta función, llame a la función JNI RegisterNatives.

   b. La máquina virtual Java buscará automáticamente y llamará al JNI_OnLoad cuando su biblioteca nativa esté cargada por System.loadLibrary, que ya debería estar llamando, probablemente en un inicializador estático para su clase. (Se obtiene el puntero env requerido llamando a la función GetEnv en la tabla que los vm puntero apunta a.)