JNI 参数传递

　　写例程之前先介绍一下代码目录结构吧，以免后面发生找不到library库的路径

 　　　　　　　　　　　　

 　　so文件需要与java目录的根目录同级

error1：Error: Could not find or load main class com.clay.example.sample1

error2：Exception in thread "main" java.lang.UnsatisfiedLinkError: no sample1 in java.library.path

　　　　　　at java.lang.ClassLoader.loadLibrary(ClassLoader.java:1867)
　　　　　　at java.lang.Runtime.loadLibrary0(Runtime.java:870)
　　　　　　at java.lang.System.loadLibrary(System.java:1122)
　　　　　　at com.clay.example.sample1.<clinit>(sample1.java:6)

例程编写与编译请看下面的例子吧，代码结构目录需要严格对照上面的目录（当然你有自己的习惯也可以按照自己的习惯来，能编译通过都行），按照个人喜好来，不过新手的话，建议保持与上诉目录相同，不然会出现自己都不知道为啥的错误。

Project目录下的 stringJNI是下例（传递字符串）的工程目录名称

com/clay/example 是java 目录

package com.clay.example 是java程序的包名

cpp目录，我们javah 编译生成 .h 文件目录以及实现 .h 方法的 点C或者 点 cpp文件

lib目录，我们生成的动态库目录，个人喜欢这样将其分开，保持代码目录的整洁性

1、传递字符串

　　本例程将由Java程序向C程序传入一个字符串，C程序对该字符串转成大写形式后回传给Java程序。

Java源程序如下。

package com.clay.example;

public class sample1 {
    
    static {
        System.loadLibrary("sample1");
    }

    public native String stringMethod(String text);

    public static void main(String[] args) {
        sample1 sample = new sample1();
        String text = sample.stringMethod("I love Java");

        System.out.println("stringMethod: " + text);
    }
}

　　sample1.java以“I love Java”为参数调用libsample1.so中的函数stringMethod()，在得到返回的字符串后打印输出。

　　写完之后，在 com/clay/example 目录下 执行命令：javac sample1.java 编译我们写的 java 程序，生成 sample.class 文件

　　zhengchuanyu@CLAY:~/Projects/stringJNI/src$ javah -d cpp/ -classpath . -jni -v com.clay.example.sample1

　　[Creating file RegularFileObject[cpp/com_clay_example_sample1.h]]

　　切记：javah -d cpp/ -classpath . -jni -v com.clay.example.sample1 此命令生成的 jni 文件的头文件必须在 java 程序的根目录执行，我们这里的根目录在 src 目录下

　　此命令相关参数 -d <path> -classpath <path> -jni -v，请看上一篇博文，其中有详细的介绍

　　生成的 .h 文件如下所示

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

#ifndef _Included_com_clay_example_sample1
#define _Included_com_clay_example_sample1
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_clay_example_sample1
 * Method:    stringMethod
 * Signature: (Ljava/lang/String;)Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_clay_example_sample1_stringMethod
  (JNIEnv *, jobject, jstring);

#ifdef __cplusplus
}
#endif
#endif

　　下面 c 代码的实现：jni_string.c

#include <jni.h>
#include "com_clay_example_sample1.h"
#include <stdio.h>
#include <string.h>
#include <ctype.h>

JNIEXPORT jstring JNICALL JNICALL Java_com_clay_example_sample1_stringMethod
(JNIEnv *env, jobject obj, jstring string)
{
    int i = 0;

    const char* str = (*env)->GetStringUTFChars(env, string, 0);
    char cap[128];

    strcpy(cap, str);
    (*env)->ReleaseStringUTFChars(env, string, str);

    for(i = 0; i < strlen(cap); i ++)
    {
        *(cap + i) = (char)toupper(*(cap + i));
    }

    return (*env)->NewStringUTF(env, cap);
}

　　首先请注意函数头部分，函数接收一个jstring 类 型的输入参数，并输出一个jstring类型的参数。jstring 是 jni.h 中定义的数据类型，是JNI框架内特有的字符串类型。

　　程序的第 12 行是从 JNI 调用上下文中获取 UTF 编码的输入字符，将其放在指针 str 所指向的一段内存中。

　　第 16 行是释放这段内存。

　　第 23 行是将经过大写转换的字符串予以返回，这一句使用 NewStringUTF() 函数，将 C 语言的字符串指针转换为 JNI 的 jstring 类型。 JNIEnv 也是在 jni.h 中定义的，代表 JNI 调用的上下文。 GetStringUTFChars()、ReleaseStringUTFChars() 和 NewStringUTF() 均是 JNIEnv 的函数。

　　后面会专门写一篇有关 JNI 相关函数的博文，前期只做例程学习参考，无需理解。

　　将 jni_string.c 编译生成动态库

　　命令： ~/Projects/stringJNI/src$ gcc -shared -fPIC -I /opt/jdk1.8.0_221/include/ -I /opt/jdk1.8.0_221/include/linux/ cpp/jni_string.c -o lib/libsample1.so

　　运行程序，在 src 目录下（Java 程序所在的根目录）执行 ：~/Projects/stringJNI/src$ java -Djava.library.path=lib/ com.clay.example.sample1

　　-Djava.library.path=<path> 是指定动态库的路径

　　否则会出现 上诉的 error1：Error: Could not find or load main class com.clay.example.sample1

　　至于为什么会出现这些错误，只有自己多实践就知道为什么了，不要问我为什么知道，我也不知道，一开始目录我也是乱写，经过经验摸索总结而出，这其实就是 JNI 编写规范的一部分。

　　运行结果如下：

 　　　　　　　　　　　　

 　　输出：stringMethod: I LOVE JAVA

　　后面的例程中，我将只列出代码目录结构，不再详细描述编译，本篇第一小节加上两篇博文有专门描述编译以及编写规则

 2、传递整型数组

　　代码目录结构：

 　　　　　　　　　　

 　　本节例程将首次尝试在JNI框架内启用数组：C 程序向 Java 程序返回一个定长的整型数组成的数组，Java程序将该数组打印输出。

　　Java程序的源代码如下。

package com.clay.example;

public class Sample2 {
    
    static {
        System.loadLibrary("Sample2");
    }
    

    public native int[] intArrayMethod();

    public static void main(String[] args) {

        Sample2 sample = new Sample2();
        int[] nums = sample.intArrayMethod();

        for(int i = 0; i < nums.length; i ++) {
            System.out.println("intArrayMethod: " + nums[i]);
        }
    }
}

 jni_intArrayMethodImpl.c

#include <jni.h>
#include "com_clay_example_Sample2.h"
#include <stdio.h>

JNIEXPORT jintArray JNICALL Java_com_clay_example_Sample2_intArrayMethod
(JNIEnv *env, jobject obj)
{
    int i = 0;

    jintArray  array;//定义数组对象

    array = (*env)-> NewIntArray(env, 10);

    for(i = 0; i < 10; i++)
    {
        (*env)->SetIntArrayRegion(env, array, i, 1, &i);
    }                                

    /* 获取数组对象的元素个数 */

    int len = (*env)->GetArrayLength(env, array);
    
    /* 获取数组中的所有元素 */
    jint* elems = (*env)-> GetIntArrayElements(env, array, 0);                                               

    for( i = 0; i < len; i++)
    {
        printf("jni_intArrayMethodImpl: elems[%d] = %d
", i, elems[i]);
    }                                                

    return array;
}

　　jni_intArrayMethodImpl.c 涉及了两个jni.h定义的整型数相关的数据类型：jint和jintArray，jint是在JNI框架内特有的整数类型。程序的第 12 行开辟出一个长度为10 的jint数组，然后依次向该数组中放入元素0-9。21-24行不是程序的必须部分，纯粹是为了演示GetArrayLength() 和GetIntArrayElements()这两个函数的使用方法，前者是获取数组长度，后者则是获取数组的首地址以便于遍历数组。

3、传递字符串数组

　　未完待续