Android开发中,经常会在Java代码与Jni层之间传递数组(byte[]),一个典型的应用是Java层把需要发送给客户端的数据流传递到Jni层,由Jni层的Socket代码发送出去,当然,Jni层也需要把从Socket接收到的数据流返回给Java层。我简单地总结了一下,从Java层到Jni层,从Jni层到JAVA层,各有3种传递方式,下面用代码示例简单地介绍一下。
示例代码的主要文件有两个,一个是Native.java,是Java层的类;另一个是Native.c,是JNI层的文件,关键的地方我都用注释添加到代码中了,完整的代码见博文后面的附件。
一、 从Java传递数组到Jni层
Jni层接收到Java层传递过来的byte[]数组,一般有2个函数来获取它的值,一个 GetByteArrayRegion,另一个是 GetByteArrayElements ,前者是进行值拷贝,将Java端数组的数据拷贝到本地的数组中,后者是指针的形式,将本地的数组指针直接指向Java端的数组地址,其实本质上是JVM在堆上分配的这个数组对象上增加一个引用计数,保证垃圾回收的时候不要释放,从而交给本地的指针使用,使用完毕后指针一定要记得通过ReleaseByteArrayElements进行释放,否则会产生内存泄露。
从注释可知,JNI_OnLoad是由系统JNI回调的,并不由得开发者乱用,而且也不由JNI默认提供。不重写这个方法系统就默认进行配置。在虚拟机VM加载c组件的时候(so)就会调用组件加载接口JNI_OnLoad(),在JNI_OnLoad()函数里,就透过VM之指标而取得JNIEnv之指标值,并存入env指标变数里。
这里的JavaVM就是虚拟机VM在JNI中的表示,一个进程JVM中只有一个JavaVM对象,这个对象是线程共享的。换言之这个JavaVM是能全局安全使用的,而且也只能在JNI_OnLoad的回调进行强引用赋值。 有了这个JavaVM,我们再调用AttachCurrentThread 附加当前线程到虚拟机VM当中,并返回线程对应的JNIEnv,我们就能愉快的撸码了!
说到AttachCurrentThread,不能不提起JavaVM的另外一个接口 GetEnv,看上去GetEnv不就是获取env的方法吗?这么解释吧,只有先AttachCurrentThread到JavaVM,分配到了独立的JNIEnv之后,GetEnv第二个参数二级指针返回的env才有值。就是说JavaVM->GetEnv获取的是,此线程有效的env。JavaVM->AttachCurrentThread是向虚拟机分配线程独立的env。 所以一般在线程执行函数第一句是AttachCurrentThread,随后就能用GetEnv了。
如果FindClass用的是主线程env就不会报错了。如果FindClass的是系统的UUID类也不会报错了。但是现实生活没有那么多如果!问题的原因就是只有主线程的env才有包含我们自定义(自己开发)的类类型,而 AttachCurrentThread的线程安全env只加载了系统的类类型,并不包含自定义的类类型。
所以问题的原因找到了,怎么解?既然env不是线程安全,不能直接引用。那么我们可以引用其他线程共享的调用对象啊,再通过GetObjectClass获取jclass
1. JNIEnv对象
对于本地函数
JNIEXPORT void JNICALL Java_video1_TestNative_sayHello(JNIEnv * env, jobject obj)
{
cout<<"Hello Native Test !"<<endl;
}
JNIEnv类型代表Java环境。通过这个JNIEnv*指针,就可以对Java端的代码进行操作。如,创建Java类得对象,调用Java对象的方法,获取Java对象的属性等。
JNIEnv的指针会被JNI传送到本地方法的实现函数中来对Java端的代码进行操作
JNIEnv类中的函数:
NewObject/NewString/New<TYPE>Array :new新对象
Get/Set<TYPE>Field:获取属性
Get/SetStatic<TYPE>Field :获取静态属性
Call<TYPE>Method/CallStatic<TYPE>Method:调用方法
2. Java数据类型与C/C++数据类型的对应关系
可以参考 jni.h 文件:http://home.pacifier.com/~mmead/jni/cs510ajp/jni.h
Java类型 别名 C++本地类型 字节(bit)
boolean jboolean unsigned char 8, unsigned
byte jbyte signed char 8
char jchar unsigned short 16, unsigned
short jshort short 16
int jint long 32
long jlong __int64 64
float jfloat float 32
double jdouble double 64
void void n/a
Object _jobject *jobject
3. 获取jclass
为了能够在C/C++使用Java类,jni.h头文件中专门定义了jclass类型来表示Java中的Class类
jclass的取得:
JNIEnv类中有如下几个简单的函数可以取得jclass
jclass FindClass(const char* clsName) 根据类名来查找一个类,完整类名。
jclass GetObjectClass(jobject obj) 根据一个对象,获取该对象的类
jclass GetSuperClass(jclass obj) 获取一个类的父类
FindClass 会在classpath系统环境变量下寻找类,需要传入完整的类名,注意包与包之间是用"/"而不是"."来分割
如:jclass cls_string= env->FindClass("java/lang/String");
获取jclass又什么用,比如你要调用类的静态方法,静态属性就需要通过这个方法来获取一个类。
4. 本地代码访问Java类中的属性与方法
有了类和对象之后,如何才能访问java中的对象的属性和方法呢,这就需要用到以下这些方法了。
JNI在jni.h头文件中定义了jfieldID,jmethodID类表示Java端的属性和方法
如何获取属性: 在访问或设置Java属性的时候,首先就要现在本地代码中取得代表Java属性的jfieldID,然后才能在本地代码中进行Java属性操作。
如何调用java的方法:调用Java端的方法时,需要取得代表方法的jmethodID才能进行Java方法调用
JNIEnv获取相应的fieldID和jmethodID的方法:
GetFieldID/GetMethodID
GetStaticFieldID/GetStaticMethodID
GetMethodID也可以取得构造函数的jmethodID。创建Java对象时调用指定的构造函数。
如:env->GetMethodID(data_Clazz,"method_name","()V")
(*jniEnv)->GetMethodID(jniEnv, Clazz,"<init>", "()V");
这个比较特殊,这个是默认构造函数的方法,一般用这个来初始化对象,但是再实际过程中,为了快速生成一个实例,一般通过工厂方法类创建jobject
jni.h 对GetMethodID的定义:
jmethodID (JNICALL *GetMethodID)
(JNIEnv *env, jclass clazz, const char *name, const char *sig);
这就引入了一个新的问题,什么是sig,我们后面再说,举个例子说明
前提说明: JAVA类 TestProvider ,该类有2个方法分别为String getTime( ) , void saysayHello( String str)
jclass TestProvider;
jobject mTestProvider;
jmethodID getTime;
jmethodID sayHello;
C 中映射类
TestProvider = (*jniEnv)->FindClass(jniEnv,"com/duicky/TestProvider");
C中新建对象
//默认构造函数,不传参数
jmethodID construction_id = (*jniEnv)->GetMethodID(jniEnv, TestProvider,"<init>", "()V");
//通过NewObject来创建对象
jobject mTestProvider = (*jniEnv)->NewObject(jniEnv, TestProvider,construction_id);
C 中映射方法
静态:
getTime = (*jniEnv)->GetStaticMethodID(jniEnv, TestProvider, "getTime","()Ljava/lang/String;");
非静态:
sayHello = (*jniEnv)->GetMethodID(jniEnv, TestProvider, "sayHello","(Ljava/lang/String;)V");
C 中调用 Java的 方法
静态:
(*jniEnv)->CallStaticObjectMethod(jniEnv, TestProvider, getTime);
非静态:
(*jniEnv)->CallVoidMethod(jniEnv, mTestProvider, sayHello,jstrMSG);
注意 GetXXXMethodID 和 CallXXXMethod 。
第一个XXX 表示的是映射方法的类型,如: 静态 跟非静态
第二个 XXX 表示 调用方法的返回值 ,如:Void,Object,等等。(调用静态方法的时候Call后面要加Static)
5. sign签名
对于 jmethodID GetMethodID(jclass clazz, const char *name, const char *sign)
clazz代表该属性所在的类,name表示方法名称,sign是签名
那什么是签名,签名是对函数参数和返回值的描述,对同一个函数,在java中允许重载,这个时候就需要这个sign来进行区分了。
以下是java类型签名的描述
用来表示要取得的属性/方法的类型
类型 相应的签名
boolean Z
byte B
char C
short S
int I
long J
float F
double D
void V
object L用/分隔包的完整类名: Ljava/lang/String;
Array [签名 [I [Ljava/lang/Object;
Method (参数1类型签名 参数2类型签名···)返回值类型签名
特别注意:Object后面一定有分号(;)结束的,多个对象参数中间也用分号(;)来分隔
例子:
方法签名
void f1() ()V
int f2(int, long) (IJ)I
boolean f3(int[]) ([I)B
double f4(String, int) (Ljava/lang/String;I)D
void f5(int, String [], char) (I[Ljava/lang/String;C)V
图解签名:
使用javap命令来产生签名
javap -s -p [full class Name]
-s 表示输出签名信息
-p 同-private,输出包括private访问权限的成员信息
例子:
C:\E\java\workspaces\myeclipseblue\JNITest\bin>javap -s -private video1.TestNative
Compiled from "TestNative.java"
public class video1.TestNative extends java.lang.Object{
public java.lang.String name;
Signature: Ljava/lang/String;
public video1.TestNative();
Signature: ()V
public int signTest(int, java.util.Date, int[]);
Signature: (ILjava/util/Date;[I)I
public native void sayHello();
Signature: ()V
public static void main(java.lang.String[]);
Signature: ([Ljava/lang/String;)V
}
TestNative完整代码:
package video1;
import java.util.Date;
public class TestNative {
public String name="Test";
public int number =100;
public int signTest(int i,Date date,int[] arr){
System.out.println("Sign Test");
return 0;
}
//native关键字修饰的方法,其内容是C/C++编写的,java中不必为它编写具体的实现
public native void sayHello();
public static void main(String[] args) {
System.loadLibrary("NativeCode");
TestNative tn = new TestNative();
tn.sayHello();
}
}
C/C++代码
#include "video1_TestNative.h"
#include <iostream>
using namespace std;
JNIEXPORT void JNICALL Java_video1_TestNative_sayHello(JNIEnv * env, jobject obj){
cout<<"Hello Native Test !"<<endl;
//因为test不是静态函数,所以传进来的就是调用这个函数的对象
//否则就传入一个jclass对象表示native()方法所在的类
jclass native_clazz = env->GetObjectClass(obj);
//得到jfieldID
jfieldID fieldID_prop = env->GetFieldID(native_clazz,"name","Ljava/lang/String;");
jfieldID fieldID_num = env->GetFieldID(native_clazz,"number","I");
//得到jmethodID
jmethodID methodID_func=env->GetMethodID(native_clazz,"signTest","(ILjava/util/Date;[I)I");
//调用signTest方法
env->CallIntMethod(obj,methodID_func,1L,NULL,NULL);
//得到name属性
jobject name = env->GetObjectField(obj,fieldID_name);
//得到number属性
jint number= env->GetIntField(obj,fieldID_num);
cout<<number<<endl;//100
//修改number属性的值
env->SetIntField(obj,fieldID_num,18880L);
number= env->GetIntField(obj,fieldID_num);
cout<<number<<endl;//18880
}
本文地址,转载请注明出处:
http://www.cnblogs.com/likwo/archive/2012/05/21/2512400.html
参考资料:
http://zzqrj.iteye.com/blog/1285262
jni.h 头文件:
http://home.pacifier.com/~mmead/jni/cs510ajp/jni.h
相关例子:
http://www.pacifier.com/~mmead/jni/cs510ajp/index.html
Programmming in C/C++ with the Java Native Interface (3 个练习)
http://www.pacifier.com/~mmead/jni/cs510ajp/exercises/index.html
JNI 文档:
http://files.cnblogs.com/luxiaofeng54/JNI_Docs.rar
基于 Android NDK 的学习之旅----- C调用Java
http://www.cnblogs.com/luxiaofeng54/archive/2011/08/17/2142000.html
Linux下JNI的使用:比较基础
http://www.cnblogs.com/bastard/archive/2012/05/17/2506877.html
如何在Android下使用JNI:讲解比较详细,但是代码里有些错误,空格没处理好
http://blog.csdn.net/xnwyd/article/details/7086384
这篇文章有些地方不清楚的参考下这篇文章
Android Jni代码示例讲解
http://developer.51cto.com/art/201001/181355.htm
其他推荐学习网站
http://blog.csdn.net/ostrichmyself/article/details/4557851
http://blog.csdn.net/popop123/article/details/1511180
使用 Java Native Interface 的最佳实践:描述了JNI性能和缓存的一些东西
https://www.ibm.com/developerworks/cn/java/j-jni/
JNI 攻略系列
http://blog.csdn.net/yjkwf/article/details/7006260
http://blog.csdn.net/yjkwf/article/details/7006261
http://blog.csdn.net/yjkwf/article/details/7006264
http://blog.csdn.net/yjkwf/article/details/7006266
http://disanji.net/2011/01/26/android-jni-programming-2/
JNI Examples for Android
http://android.wooyd.org/JNIExample/files/JNIExample.pdf
JNI pthread 多线程使用
http://www.cnblogs.com/lknlfy/archive/2012/03/16/2400786.html