JNI开发流程与引用数据类型的处理

时间  2019-11-17
标签 jni 开发 流程 引用 数据 类型 处理 繁體版
原文   原文链接

今天咱们来看下Java JNI，先看下维基百科给的定义，java

JNI, Java Native Interface, Java本地接口，是一种编程框架，使得Java虚拟机中的Java程序能够调用本地应用或库，也能够被其余程序调用。本地程序通常是用其它语言(C、C++或汇编语言)编写的，而且被编译为基于本地硬件和操做系统的程序。android

本文就是分析下Java调用C++程序的步骤和JNI开发访问数组和字符串的问题。编程

先看下Android中JNI的开发步骤。简单写了个Demo，看下效果：数组

Demo.png

调用方式：安全

button.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                Toast.makeText(MainActivity.this, HelloWorld.sayHello("JNIEnjoy!"), Toast.LENGTH_LONG).show();
            }
});
复制代码

点击SUM会对数组进行求和和打印出Native传递过来的二维数组bash

SUM.png

Log.png

调用代码：数据结构

btn2.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                btn2.setText(String.valueOf(ArrayJni.arraySum(get())));

                int[][] arr = ArrayJni.getArray(3);
                for (int i = 0; i < 3; i++) {
                    for (int j = 0; j < 3; j++) {
                        Log.d("JNILOG", String.valueOf(arr[i][j]));
                    }
                }
            }
});

private int[] get() {
        int[] array = new int[10];
        for (int i = 0; i < array.length; i++) {
            array[i] = i;
        }
        return array;
}
复制代码

接下来看下JNI开发步骤：app

1.JNI开发步骤

第一步，在Java层先创建JNI Class，须要调用Native 方法的地方须要关键字native声明,其中方法sayHello就是须要底层实现的，这个Demo中会用C实现。框架

public class HelloWorld {

    public static native String sayHello(String name);
}
复制代码

第二步, Make Project，这样会在app/build/intermediates/classes/debug下生成class文件,以下图所示，固然须要的就是Hello World.class这个文件。ide

Make Class.png

第三步, 在终端中切换目录到app\build\intermediates\classes\debug, 经过命令生成.h头文件javah -jni juexingzhe.com.hello.HelloWorld,juexingzhe.com.hello是包名，须要换成小伙伴本身的包名。juexingzhe.com.hello.HelloWorld.h文件。

Make h.png

看下文件内容，默认生成的函数名规则是：

Java_包名_类名_Native方法名
复制代码

其中JNIEnv是线程相关的，即在每一个线程中都有一个JNIEnv指针, 每一个JNIEnv都是线程专有，线程A不能调用线程B的JNIEnv。

jclass就是HelloWorld这个类，由于在这个例子中方法是静态的，因此默认生成的是jclass,若是方法不是静态的，默认生成的就会传入jobject,指向调用这个native方法时的对象实例。

jstring就是定义方法时传入的参数。

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class juexingzhe_com_hello_HelloWorld */

#ifndef _Included_juexingzhe_com_hello_HelloWorld
#define _Included_juexingzhe_com_hello_HelloWorld
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     juexingzhe_com_hello_HelloWorld
 * Method:    sayHello
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_juexingzhe_com_hello_HelloWorld_sayHello
  (JNIEnv *, jclass, jstring);

#ifdef __cplusplus
}
#endif
#endif
复制代码

第四步，在main目录下新建jni文件夹,将上面生成的.h文件剪切过来。

New JNI Folder.png

第五步，终于到了写c代码的时候了，注意在头文件中，C和C++写法是不同的。

C中(*env)->NewStringUTF(env, "string) C++中env->NewStringUTF("string") 复制代码

最终的juexingzhe.com.hello.HelloWorld.c文件以下:

#include "juexingzhe_com_hello_HelloWorld.h"
#include <stdio.h>
/* Header for class juexingzhe_com_hello_HelloWorld */

/*
 * Class:     juexingzhe_com_hello_HelloWorld
 * Method:    sayHello
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_juexingzhe_com_hello_HelloWorld_sayHello
        (JNIEnv *env, jclass jcls, jstring jstr)
{
    const char *c_str = NULL;
    char buff[128] = { 0 };
    c_str = (*env)->GetStringUTFChars(env, jstr, NULL);
    if (c_str == NULL)
    {
        printf("out of memory.\n");
        return NULL;
    }
    sprintf(buff, "hello %s", c_str);
    (*env)->ReleaseStringUTFChars(env, jstr, c_str);
    return (*env)->NewStringUTF(env, buff);
}
复制代码

对上面的代码有几点须要注意的, 参考后面字符串处理。

通过上面五步写代码的步骤就差很少了，还有一个问题，Java层怎么调到这个C文件呢？这就须要第六步配置ndk

第六步，配置ndk，在module包下面的build.gradle中的defaultConfig添加,其中moduleName就是最终打包出来的so库的名字

ndk {
     moduleName 'HelloWorld'
}
复制代码

最终android这个task是下面这样的

android {
    compileSdkVersion 26
    defaultConfig {
        applicationId "juexingzhe.com.hello"
        minSdkVersion 15
        targetSdkVersion 26
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
        ndk {
            moduleName 'HelloWorld'
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

复制代码

还须要在工程目录下的gradle.properties中添加下面这句话

android.useDeprecatedNdk=true
复制代码

从新Make Project就能够生成.so文件，这里没有配置平台，因此会默认生成全部平台的so库，包括arm/x86/mips等

Make SO.png

第七步，须要在Java层加载这个.so文件,在第一步编写的HelloWorld.Java中添加，其中HelloWorld就是上面NDK配置生成的so库名字。

public class HelloWorld {

    static {
        System.loadLibrary("HelloWorld");
    }

    public static native String sayHello(String name);
}
复制代码

2.字符串处理

再回顾一下上面.c文件的内容：

#include "juexingzhe_com_hello_HelloWorld.h"
#include <stdio.h>
/* Header for class juexingzhe_com_hello_HelloWorld */

/*
 * Class:     juexingzhe_com_hello_HelloWorld
 * Method:    sayHello
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_juexingzhe_com_hello_HelloWorld_sayHello
        (JNIEnv *env, jclass jcls, jstring jstr)
{
    const char *c_str = NULL;
    char buff[128] = { 0 };
    c_str = (*env)->GetStringUTFChars(env, jstr, NULL);
    if (c_str == NULL)
    {
        printf("out of memory.\n");
        return NULL;
    }
    sprintf(buff, "hello %s", c_str);
    (*env)->ReleaseStringUTFChars(env, jstr, c_str);
    return (*env)->NewStringUTF(env, buff);
}
复制代码

  • 1.jstring类型是指向JVM内部的一个字符串，和基本类型不同，C代码中不能直接拿来用，须要经过JNI函数来访问JVM内部的字符串数据结构。

  • 2.简单看下GetStringUTFChars(env, jstr, &isCopy), jstr是Java传递给本地代码的字符串指针，isCopy取值JNI_TRUE和JNI_FALSE，若是值为JNI_TRUE，表示返回JVM内部源字符串的一份拷贝，并为新产生的字符串分配内存空间。若是值为JNI_FALSE，表示返回JVM内部源字符串的指针，意味着能够经过指针修改源字符串的内容，不推荐这么作，由于这样作就打破了Java字符串不能修改的规定。但咱们在开发当中，并不关心这个值是多少，一般状况下这个参数填NULL便可。

  • 3.Java默认使用Unicode编码，而C/C++默认使用UTF编码，因此在本地代码中操做字符串的时候，必须使用合适的JNI函数把jstring转换成C风格的字符串。JNI支持字符串在Unicode和UTF-8两种编码之间转换，GetStringUTFChars能够把一个jstring指针（指向JVM内部的Unicode字符序列）转换成一个UTF-8格式的C字符串。在上例中sayHello函数中咱们经过GetStringUTFChars正确取得了JVM内部的字符串内容

  • 4.异常检查。调用完GetStringUTFChars须要进行安全检查，由于JVM须要为新诞生的字符串分配内存，分配失败会返回NULL，并抛出OutOfMemoryError异常。Java中若是遇到异常没有捕获程序会当即中止运行。而JNI遇到未处理的异常不会改变程序的运行流程，回继续往下走，这样后面对这个字符串的全部操做都是危险的。因此若是NULL，须要return跳事后面的代码。

  • 5.释放字符串。C和Java不同，须要手动释放内存，经过ReleaseStringUTFChars函数通知JVM这块内存不须要了。注意GetXXX和ReleaseXXX要配套调用。

  • 6.调用NewStringUTF函数会构建一个新的java.lang.String字符串对象，这个对象会自动转换成Java支持的Unicode编码。若是JVM不能为构造java.lang.String分配足够的内存，NewStringUTF会抛出一个OutOfMemoryError异常，并返回NULL。

固然，JNI提供操做字符串的函数不少，这里就不一一解释了，主要须要注意内存的分配和跨线程的问题。

3.数组处理

数组和上面的字符串相似，没办法直接操做，须要经过JNI函数从JVM中获取到对应的指针或者拷贝到内存缓冲区再进行操做。

按照上面步骤再添加一个数组的例子，看下Java代码，两个Native函数，一个求和一个获取二维数组。

public class ArrayJni {

    static {
        System.loadLibrary("HelloWorld");
    }

    //求和
    public static native int arraySum(int[] array);

    //获取二维数组
    public static native int[][] getArray(int size);

}
复制代码

接下来先看下arraySum的C代码，Java层定义的参数是int类型的数组对应到Native就是jintArray, 经过GetArrayLength获取参数数组的长度，而后经过GetIntArrayRegion将参数数组拷贝到内存缓冲区buffer，以后就能够进行求和操做了。操做完成记得释放内存。

/*
 * Class:     juexingzhe_com_hello_ArrayJni
 * Method:    arraySum
 * Signature: ([I)I
 */
JNIEXPORT jint JNICALL Java_juexingzhe_com_hello_ArrayJni_arraySum
        (JNIEnv *env, jclass jcls, jintArray jarr)
{
    jint i, sum = 0, len;
    jint *buffer;
    //1.获取数组长度
    len = (*env)->GetArrayLength(env, jarr);

    //2.分配缓冲区
    buffer = (jint*) malloc(sizeof(jint) * len);
    memset(buffer, 0, sizeof(jint) * len);

    //3.拷贝Java数组中全部元素到缓冲区
    (*env)->GetIntArrayRegion(env, jarr, 0, len, buffer);

    //4.求和
    for (int i = 0; i < len; ++i) {
        sum += buffer[i];
    }

    //5.释放内存
    free(buffer);

    return sum;
}
复制代码

再看下生成二维数组的代码, 小伙伴们都知道二维数组中每个元素实际上是一维数组，因此须要先构造一维数组的引用，经过FindClass，再经过NewObjectArray构造二维数组。

经过NewIntArray构造一维数组，而后SetIntArrayRegion赋值int类型数组元素，固然也有GetIntArrayRegion函数，能够将Java数组中的全部元素拷贝到C缓冲区中。

二维数组经过SetObjectArrayElement进行赋值。

为了不在循环内建立大量的JNI局部引用，形成JNI引用表溢出，在外层循环中每次都要调用DeleteLocalRef将新建立的jintArray引用从引用表中移除。在JNI中，只有jobject以及子类属于引用变量，会占用引用表的空间，jint，jfloat，jboolean等都是基本类型变量，不会占用引用表空间，即不须要释放。引用表最大空间为512个，若是超出这个范围，JVM就会挂掉。

/*
 * Class:     juexingzhe_com_hello_ArrayJni
 * Method:    getArray
 * Signature: (I)[[I
 */
JNIEXPORT jobjectArray JNICALL Java_juexingzhe_com_hello_ArrayJni_getArray
        (JNIEnv *env, jclass jcls, jint size)
{
    jobjectArray result;
    jclass onearray;

    //1.获取一维数组引用
    onearray = (*env)->FindClass(env, "[I");
    if (onearray == NULL){
        return NULL;
    }

    //2.构造二维数组
    result = (*env)->NewObjectArray(env, size, onearray, NULL);
    if (result == NULL){
        return NULL;
    }

    //3.构造一维数组
    for (int i = 0; i < size; ++i) {

        int j;
        jint buffer[256];
        //构造一维数组
        jintArray array = (*env)->NewIntArray(env, size);
        if (array == NULL){
            return NULL;
        }
        //准备数据
        for (int j = 0; j < size; ++j) {
            buffer[j] = i + j;
        }

        //设置一维数组数据
        (*env)->SetIntArrayRegion(env, array, 0, size, buffer);

        //赋值一维数组给二维数组
        (*env)->SetObjectArrayElement(env, result, i, array);

        //删除一维数组引用
        (*env)->DeleteLocalRef(env, array);
    }

    return result;
}
复制代码

一样地， 数组操做的函数也有不少，这里不可能每一个都进行说明，有须要的小伙伴能够自行搜索，差异不会太大。

4.总结

本文只是对Android开发JNI的一点点理解总结，包括JNI开发的步骤，字符串和数组的处理，在JNI Native开发过程当中都没办法直接操做引用类型的数据，须要经过JNI提供的函数来获取JVM中的数据，提供的函数有的会进行原数据的拷贝有的会返回原数据的指针，根据本身须要进行不一样的选择。

后面有可能会对JNI再出一些内容，好比Native调用Java层的对象方法字段等，有须要的小伙伴们欢迎关注。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程