函数表

JNI 函数	描述	加入版本
Get/ReleaseStringChars	获取或者释放一个Unicode格式的字符串，可能返回原始字符串的拷贝	JDK1.1
Get/ReleaseStringUTFChars	获取或者释放一个UTF-8格式的字符串，可能返回原始字符串的拷贝	JDK1.1
GetStringLength	返回Unicode字符串的字符个数	JDK1.1
GetStringUTFLength	返回用于表示某个UTF-8字符串所需要的字节个数（不包括结束的0）	JDK1.1
NewString	创建一个java.lang.String对象，该对象与指定的Unicode字符串具有相同的字符序列	JDK1.1
NewStringUTF	创建一个java.lang.String对象，该对象与指定的UTF-8字符串具有相同的字符序列	JDK1.1
Get/ReleaseStringCritical	获取或者释放一个Unicode格式的字符串的内容，可能返回原始字符串的拷贝，在Get/ReleaseStringCritical之间的代码必须不能阻塞	Java2 SDK1.2
Get/SetStringRegion	将一个字符串拷贝到预先开辟的空间，或者从一个预先开辟的空间复制字符串，字符使用Unicode编码	Java2 SDK1.2
Get/SetStringUTFRegion	将一个字符串拷贝到预先开辟的空间，或者从一个预先开辟的空间复制字符串，字符使用UTF-8编码	Java2 SDK1.2

jstring

• jstring不同于 C语言 的char *，不能像使用char *那样使用jstring。

简单示例

#include <jni.h>

#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     Prompt
 * Method:    getLine
 * Signature: (Ljava/lang/String;)Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_Prompt_getLine(JNIEnv * env, jobject obj, jstring prompt) {
    char buf[128];
    const char * str = (* env)->GetStringUTFChars(env, prompt, NULL);
    // 需要检查，可能因为内存分配失败抛出异常
    if (!str) {
        return NULL;
    }
    printf("%s", str);
    fflush(stdout);
    (* env)->ReleaseStringUTFChars(env, prompt, str);
    scanf("%s", buf);
    return (* env)->NewStringUTF(env, buf);
}

#ifdef __cplusplus
}
#endif

函数解说

转换成为Native Strings

• GetStringUTFChars()：用jstring类型对象生成const char *类型对象。 需要检查是否获取成功，因为可能会因为内存分配失败抛出异常。
• 无法预测GetStringUTFChars()的返回值是指向一个拷贝还是指向原来的jstring对象。
• GetStringUTFChars()的第三个参数是一个jboolean *类型，用于接收一个布尔值，若调用完GetStringUTFChars()后，此实参为JNI_TRUE，则代表着返回的指针指向原来jstring的拷贝，即可以修改；若为JNI_FALSE，则代表着返回的指针指向原来jstring的对象，即不可修改。可以传入NULL代表着自己不在乎。
• GetStringUTFRegion()：将字符串内容拷贝到一个预先申请好的缓冲区中，和GetStringUTFChars()不一样，不需要事后释放资源。
• GetStringUTFRegion()示例：

JNIEXPORT jstring JNICALL Java_Prompt_getLine(JNIEnv * env, jobject obj, jstring prompt) {
    char outbuf[128], inbuf[128];
    int len = (* env)->GetStringLength(env, prompt);
    (* env)->GetStringUTFRegion(env, prompt, 0, len, outbuf);
    printf("%s", outbuf);
    scanf("%s", inbuf);
    return (* env)->NewStringUTF(env, inbuf);
}

释放Native Strings资源

• ReleaseStringUTFChars()：当原生代码使用完了通过GetStringUTFChars()获取的 UTF-8 字符串，应当使用ReleaseStringUTFChars()释放它。
• ReleaseStringUTFChars()的调用失败将会导致内存泄露。

创建新的Strings

• NewStringUTF()：用char *类型对象生成jstring类型对象。
• NewStringUTF()可能会分配内存失败而抛出异常。

获取Strings字符个数

• GetStringUTFLength()：用于获取jstring字符串的字符个数。

Unicode String相关的其他JNI函数

• GetStringChars()：类似GetStringUTFChars()。
• ReleaseStringChars()：类似ReleaseStringUTFChars()。
• GetStringRegion()：类似GetStringUTFRegion()。
• GetStringLength()：类似GetStringUTFLength()。
• GetStringCritical()：类似GetStringUTFRegion()。
  • 相对比于GetStringChars()，倾向于返回指向原来的字符串而不是拷贝。
  • 同样需要检查是否获取成功。
  • 不能调用阻塞线程或可能阻塞线程的函数，比如获取输入，文件读写（可能被加锁导致阻塞）。
• ReleaseStringCritical()：释放通过GetStringCritical()获取的字符串资源。

其它

获取Strings字节个数

• 直接使用strlen()，传入GetStringUTFChars()的返回值。

异常

• 如果在 C语言 函数中，抛出异常，会在函数运行完毕时，在 Java 代码中传递抛出的异常。