JNI 自定义类型参数转换

　　在使用java的jni调用C++接口时候, 我们会先把数据转换成基本类型, 比如int, float, double, int[]等等, 一方面减低参数类型转换上的繁琐, 另一方面也许也能减少耦合. 实际应用时候, 可能会遇到希望一个jni接口返回多个参数的情况, 这情况下, 貌似就不得不用自定义类型参数的转换了. 这篇文章, 介绍的就是一个自定义类型参数转换的android例子程序.

　　这个例子是二维数组自定义类的, 其实三维四维甚至更多纬的数组的使用方法都是如此类推的.遇到这种需求时候,就能轻松加愉快的解决了.

　　关于android jni ndk编程入门, 可以参考这篇文章.

1. 在java代码中加入一个返回自定义类型的native接口:

package com.jnitest;

import android.app.Activity;
import android.os.Bundle;

public class JnitestActivity extends Activity {
    /** Called when the activity is first created. */
	
	static
	{
		System.loadLibrary("test-jni");
	}
	
	native static PointF[][] createPointFs(int len1, int len2);  //返回PointF的数组,PointF是一个自定义的类
	
    @Override
    public void onCreate(Bundle savedInstanceState) 
    {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        
        PointF[][] points = createPointFs(2, 2);
        for (int i = 0; i < points.length; i++)
        {
        	for (int j = 0; j < points[0].length; j++)
        	{
        		System.out.println(points[i][j].x + "," + points[i][j].y);
        	}
        }
    }
}

　　

下面是PointF.java

package com.jnitest;

public class PointF 
{
    public float x;
    public float y;
    
    public PointF(float xx, float yy)
    {
        x = xx;
        y = yy;
    }
}

2. 使用javah命令生成C/C++的头文件.(这篇文章有介绍如何使用javah命令生成头文件)

　生成下图红色框框内的头文件

3. 实现.cpp文件,代码如下:

#include "com_jnitest_JnitestActivity.h"
#include <stdio.h>

JNIEXPORT jobjectArray JNICALL Java_com_jnitest_JnitestActivity_createPointFs
  (JNIEnv *jenv, jclass jcls, jint jlen1, jint jlen2)
{
    //convert parameter to C/C++ type
    int len1 = (int) jlen1;
    int len2 = (int) jlen2;

    //create java type PointF
    jclass objectClass = (jenv)->FindClass("com/jnitest/PointF");
    jobjectArray jpointfs1 = (jenv)->NewObjectArray((jsize) len2, objectClass, NULL);
    jobjectArray pointfArrayArray = (jenv)->NewObjectArray((jsize) len1, (jenv)->GetObjectClass(jpointfs1), NULL);
    jmethodID cid = (jenv)->GetMethodID(objectClass, "<init>", "(FF)V");

    for (int j = 0; j < len1; j++)
    {
        jobjectArray jpointfarray = (jenv)->NewObjectArray((jsize) len2, objectClass, NULL);
        for (int i = 0; i < len2; i++)
        {
            jfloat jx = (jfloat) i;
            jfloat jy = (jfloat) j;
            jobject pointF = (jenv)->NewObject(objectClass, cid, jx, jy);
            (jenv)->SetObjectArrayElement(jpointfarray, i, pointF);
            (jenv)->DeleteLocalRef(pointF);
        }
        (jenv)->SetObjectArrayElement(pointfArrayArray, j, jpointfarray);
        (jenv)->DeleteLocalRef(jpointfarray);
    }
    (jenv)->DeleteLocalRef(jpointfs1);

    return pointfArrayArray;
}

下面一点一点的解释上面这些代码:

1) int len1 = (int) jlen1;  

    把java的int类型转换成,C/C++的int类型,直接转换就可以了.

2) jclass objectClass = (jenv)->FindClass("com/jnitest/PointF");

    获得java自定义类PointF, FindClass的参数,指明的是从source file开始的PointF类的路径

3) jobjectArray jpointfs1 = (jenv)->NewObjectArray((jsize) len2, objectClass, NULL);

    创建个PointF的数组(参数objectClass指明了这个数组的元素类型), 数组的长度为len2

4) jobjectArray pointfArrayArray = (jenv)->NewObjectArray((jsize) len1, (jenv)->GetObjectClass(jpointfs1), NULL);

    这里是创建一个以PointF的数组为元素的数组, 实际上它是一个PointF的二维数组, 因为上面定义的java native函数返回的就是一个PointF[][].

5) jmethodID cid = (jenv)->GetMethodID(objectClass, "<init>", "(FF)V");

    获得PointF构造函数的ID.

    "<init>",这里指明的是函数名字,构造函数就写"<init>".

    "(FF)V",圆括号内表示参数类型,FF代表,有两个参数都是float类型.圆括号后的V,代表函数返回类型是void.关于函数签名, 这里和这里都有比较详细的对照表和说明.

6) jobject pointF = (jenv)->NewObject(objectClass, cid, jx, jy);

    创建一个PointF类型的对象. objectClass是要创建的对象的类型, cid是构造函数的ID, jx和jy是构造函数的两个参数.

7) (jenv)->SetObjectArrayElement(jpointfarray, i, pointF);

    这行代码就容易理解, 往jpointfarray数组给元素赋值, i 是要赋值元素的下标, pointF就是要赋的值.

8) (jenv)->DeleteLocalRef(pointF);

    删除引用计数. 这里为什么要删除引用技术呢, 因为(6)里面每次都会new一个对象, 引用计数会加1, 当引用技术超过某个数(好像是500,具体忘记了)就会crash. 这篇文章介绍了LocalRef这个问题.

4. 编译so文件,并运行程序,查看logcat中的输出如下.

    可以看到创建了一个2*2的二位数组