当前位置: 代码迷 >> Android >> JNI方法签名
  详细解决方案

JNI方法签名

热度:55   发布时间:2016-04-28 05:33:45.0
Android中关于JNI 的学习(二)对于JNI方法名,数据类型和方法签名的一些认识

我们知道,利用javah生成的c/c++头文件的时候,会对java中定义的 native 函数生成对应的jni层函数,如下:

/*  * Class:     com_lms_jni_JniTest  * Method:    getTestString  * Signature: ()Ljava/lang/String;  */  JNIEXPORT jstring JNICALL Java_com_lms_jni_JniTest_getTestString    (JNIEnv *, jobject);  

我们可以看到方法名是以Java_com_lms_jni等开头的,还有什么所谓的Signature,那这些其实都是什么意思呢,今天我们就来简单地认识一下。

JNI 命名规则

对于传统的JNI编程来说,JNI方法跟Java类方法的名称之间有一定的对应关系,要遵循一定的命名规则,如下:

1) 前缀: Java_
2) 类的全限定名,用下划线进行分隔(_):com_lms_jni_JniTest
3) 方法名:getTestString                                             
3) jni函数指定第一个参数:  JNIEnv *
4) jni函数指定第二个参数:  jobject
5) 实际Java参数:               jstring, jint ....
6) 返回值的参数 :                 jstring, jint.... 
所以对于在Java类 com.lms.jni.HwDemo中的一个方法:
public native String addTail(String tail);

其对应的jni层的方法如下:
jstring Java_com_lms_jni_HwDemo_addTail(JNIEnv * e, jobject clazz, jstring tail);

如果不这样命名,当把动态库加载进DVM的时候,通过JNIEnv *指针去查找Java Native方法对应的JNI方法的时候,就会找不到了。
注意,我们也可以利用函数注册的方法,将Java层的方法名跟JNI层的方法名的对应关系保存起来,注册到DVM中,就不需要这样的命名规范了。

JNI 数据类型


我们知道Java的数据类型是跟C/C++的数据类型是不一样的,而JNI是处于Java和Native本地库(大部分是用C/C++写的)中间的一层,JNI对于两种不同的数据类型之间必须做一种转换,所以在JNI跟Java之间就会有数据类型的对应关系。
在JNI中,提供了以下各种数据类型,可以分为原生类型和引用类型:
对于原生类型有:jchar, jbyte, jshort, jint, jlong, jfloat, jdouble, jboolean,其与java端的数据类型对应如下表:

javajni
charjchar
bytejbyte
shortjshort
intjint
longjlong
floatjfloat
doublejdouble
booleanjboolean

对于引用类型则有:jobject, jstring, jthrowable, jclass, jarray, 以及继承于jarray,对应于其原生类型的8种j<type>array和jobjectarray。



知道了不同的数据类型的转换关系,我们就知道在什么情况下,应该对数据进行怎么样的处理。

JNI方法签名



为什么会有方法签名这种东西呢?这是因为Java这边支持函数重载,即虽然参数不一样,但是方法名一样,那么在JNI层它们的方法名都会是一样的,那JNI也会犯迷糊了,得找哪个呢?
不过也正是因为其参数类型是不一样的,所以就出现了方法签名,利用方法签名和方法名来唯一确定一个JNI函数的调用。
既然方法签名是基于参数类型的不同而形成的,首先要知道Java各数据类型对应的签名是什么,也就是所谓的类型签名,
在jni.h文件中就已经定义了这样一套规则,如下:
typedef union jvalue {    jboolean    z;    jbyte       b;    jchar       c;    jshort      s;    jint        i;    jlong       j;    jfloat      f;    jdouble     d;    jobject     l;} jvalue;

对应于Java端的数据类型,我们也可以看一下下面的表:

Java 类型类型签名
booleanZ
byteB
charC
shortS
intI
longL
float F
doubleD
L全限定名;,比如String, 其签名为Ljava/lang/util/String;
数组[类型签名, 比如 [B

对于上面的类,要注意其后面还有一个分号。
而对一个方法,其签名就是其参数类型签名和返回值类型签名的字符串,其形式如下:

(类型签名1类型签名2...)返回值类型签名

每个类型签名之间是没有空格的,下面看看两个例子:

有方法 1):
public string addTail(String tail, int index)

其对应的签名如下:

(Ljava/util/String;I)Ljava/util/String;

方法 2):
public int addValue(int index, String value,int[] arr)

其对应的签名如下:
(ILjava/util/String;[I)I

相信通过这两个例子,大家也能够了解了方法签名是什么样的形式了吧,对于JNI这些奇形怪状的表示形式也有一定的了解了。

结束。

  相关解决方案