Android(安卓)Studio3.0开发JNI流程------JNI函数

JNI函数

本章为JNI函数提供参考信息。其中列出了全部JNI函数，同时也给出了JNI函数表的准确布局。注意：“必须”一词用于约束JNI编程人员。例如，当说明某个JNI函数必须接收非空对象时，就应确保不要向该JNI函数传递NULL值。这时，JNI实现将无需在该JNI函数中执行NULL指针检查。

接口函数表

每个函数均可通过JNIEnv参数以固定偏移量进行访问。JNIEnv的类型是一个指针，指向存储全部JNI函数指针的结构。注意：前三项留作将来与COM兼容。此外，我们在函数表开头部分也留出来多个NULL项，从而可将将来与类有关的JNI操作添加到FindClass后面，而非函数表的末尾。注意，函数表可在所有JNI接口指针间共享。

const struct JNINativeInterface ... = {    NULL,    NULL,    NULL,    NULL,    GetVersion,    DefineClass,    FindClass,    NULL,    NULL,    NULL,    GetSuperclass,    IsAssignableFrom,    NULL,    Throw,    ThrowNew,    ExceptionOccurred,    ExceptionDescribe,    ExceptionClear,    FatalError,    NULL,    NULL,    NewGlobalRef,    DeleteGlobalRef,    DeleteLocalRef,    IsSameObject,    NULL,    NULL,    AllocObject,    NewObject,    NewObjectV,    NewObjectA,    GetObjectClass,    IsInstanceOf,    GetMethodID,    CallObjectMethod,    CallObjectMethodV,    CallObjectMethodA,    CallBooleanMethod,    CallBooleanMethodV,    CallBooleanMethodA,    CallByteMethod,    CallByteMethodV,    CallByteMethodA,    CallCharMethod,    CallCharMethodV,    CallCharMethodA,    CallShortMethod,    CallShortMethodV,    CallShortMethodA,    CallIntMethod,    CallIntMethodV,    CallIntMethodA,    CallLongMethod,    CallLongMethodV,    CallLongMethodA,    CallFloatMethod,    CallFloatMethodV,    CallFloatMethodA,    CallDoubleMethod,    CallDoubleMethodV,    CallDoubleMethodA,    CallVoidMethod,    CallVoidMethodV,    CallVoidMethodA,    CallNonvirtualObjectMethod,    CallNonvirtualObjectMethodV,    CallNonvirtualObjectMethodA,    CallNonvirtualBooleanMethod,    CallNonvirtualBooleanMethodV,    CallNonvirtualBooleanMethodA,    CallNonvirtualByteMethod,    CallNonvirtualByteMethodV,    CallNonvirtualByteMethodA,    CallNonvirtualCharMethod,    CallNonvirtualCharMethodV,    CallNonvirtualCharMethodA,    CallNonvirtualShortMethod,    CallNonvirtualShortMethodV,    CallNonvirtualShortMethodA,    CallNonvirtualIntMethod,    CallNonvirtualIntMethodV,    CallNonvirtualIntMethodA,    CallNonvirtualLongMethod,    CallNonvirtualLongMethodV,    CallNonvirtualLongMethodA,    CallNonvirtualFloatMethod,    CallNonvirtualFloatMethodV,    CallNonvirtualFloatMethodA,    CallNonvirtualDoubleMethod,    CallNonvirtualDoubleMethodV,    CallNonvirtualDoubleMethodA,    CallNonvirtualVoidMethod,    CallNonvirtualVoidMethodV,    CallNonvirtualVoidMethodA,    GetFieldID,    GetObjectField,    GetBooleanField,    GetByteField,    GetCharField,    GetShortField,    GetIntField,    GetLongField,    GetFloatField,    GetDoubleField,    SetObjectField,    SetBooleanField,    SetByteField,    SetCharField,    SetShortField,    SetIntField,    SetLongField,    SetFloatField,    SetDoubleField,    GetStaticMethodID,    CallStaticObjectMethod,    CallStaticObjectMethodV,    CallStaticObjectMethodA,    CallStaticBooleanMethod,    CallStaticBooleanMethodV,    CallStaticBooleanMethodA,    CallStaticByteMethod,    CallStaticByteMethodV,    CallStaticByteMethodA,    CallStaticCharMethod,    CallStaticCharMethodV,    CallStaticCharMethodA,    CallStaticShortMethod,    CallStaticShortMethodV,    CallStaticShortMethodA,    CallStaticIntMethod,    CallStaticIntMethodV,    CallStaticIntMethodA,    CallStaticLongMethod,    CallStaticLongMethodV,    CallStaticLongMethodA,    CallStaticFloatMethod,    CallStaticFloatMethodV,    CallStaticFloatMethodA,    CallStaticDoubleMethod,    CallStaticDoubleMethodV,    CallStaticDoubleMethodA,    CallStaticVoidMethod,    CallStaticVoidMethodV,    CallStaticVoidMethodA,    GetStaticFieldID,    GetStaticObjectField,    GetStaticBooleanField,    GetStaticByteField,    GetStaticCharField,    GetStaticShortField,    GetStaticIntField,    GetStaticLongField,    GetStaticFloatField,    GetStaticDoubleField,    SetStaticObjectField,    SetStaticBooleanField,    SetStaticByteField,    SetStaticCharField,    SetStaticShortField,    SetStaticIntField,    SetStaticLongField,    SetStaticFloatField,    SetStaticDoubleField,    NewString,    GetStringLength,    GetStringChars,    ReleaseStringChars,    NewStringUTF,    GetStringUTFLength,    GetStringUTFChars,    ReleaseStringUTFChars,    GetArrayLength,    NewObjectArray,    GetObjectArrayElement,    SetObjectArrayElement,    NewBooleanArray,    NewByteArray,    NewCharArray,    NewShortArray,    NewIntArray,    NewLongArray,    NewFloatArray,    NewDoubleArray,    GetBooleanArrayElements,    GetByteArrayElements,    GetCharArrayElements,    GetShortArrayElements,    GetIntArrayElements,    GetLongArrayElements,    GetFloatArrayElements,    GetDoubleArrayElements,    ReleaseBooleanArrayElements,    ReleaseByteArrayElements,    ReleaseCharArrayElements,    ReleaseShortArrayElements,    ReleaseIntArrayElements,    ReleaseLongArrayElements,    ReleaseFloatArrayElements,    ReleaseDoubleArrayElements,    GetBooleanArrayRegion,    GetByteArrayRegion,    GetCharArrayRegion,    GetShortArrayRegion,    GetIntArrayRegion,    GetLongArrayRegion,    GetFloatArrayRegion,    GetDoubleArrayRegion,    SetBooleanArrayRegion,    SetByteArrayRegion,    SetCharArrayRegion,    SetShortArrayRegion,    SetIntArrayRegion,    SetLongArrayRegion,    SetFloatArrayRegion,    SetDoubleArrayRegion,    RegisterNatives,    UnregisterNatives,    MonitorEnter,    MonitorExit,    GetJavaVM,};

版本信息

GetVersion( )返回本地方法接口的版本。

jint GetVersion(JNIEnv *env);

参数：
env为JNI接口指针。

返回值：
高16位返回主版本号，低16位返回次版本号。
在JDK1.1 中，GetVersion()返回0x00010001。

类操作

DefineClass( )从原始类数据的缓冲区中加载类。

jclass DefineClass(JNIEnv *env, jobject loader, const jbyte *buf, jsize bufLen);

参数：
env：JNI 接口指针。
loader：分派给所定义的类的类加载器。
buf：包含.class文件数据的缓冲区。
bufLen：缓冲区长度。

返回值：
返回Java类对象。如果出错则返回NULL。

抛出的异常：
- ClassFormatError：如果类数据指定的类无效。
- ClassCircularityError：如果类或接口是自身的超类或超接口。
- OutOfMemoryError：如果系统内存不足。

FindClass( ) 该函数用于加载本地定义的类。它将搜索由CLASSPATH环境变量为具有指定名称的类所指定的目录和zip文件。

jclass FindClass(JNIEnv *env, const char *name);

参数：
env：JNI接口指针。
name：类全名（即包名后跟类名，之间由“/”分隔）。如果该名称以“[”（数组签名字符）打头，则返回一个数组类。

返回值：
返回类对象全名。如果找不到该类，则返回NULL。

抛出：
- ClassFormatError：如果类数据指定的类无效。
- ClassCircularityError：如果类或接口是自身的超类或超接口。
- NoClassDefFoundError：如果找不到所请求的类或接口的定义。
- OutOfMemoryError：如果系统内存不足。

GetSuperclass( ) 如果clazz代表类而非类object，则该函数返回由clazz所指定的类的超类。如果clazz指定类object或代表某个接口，则该函数返回NULL。

jclass GetSuperclass(JNIEnv *env, jclass clazz);

参数：
env：JNI接口指针。
clazz：Java类对象。

返回值：
由clazz所代表的类的超类或NULL。

IsAssignableFrom ( ) 确定clazz1的对象是否可安全地强制转换为clazz2。

jboolean IsAssignableFrom(JNIEnv *env, jclass clazz1, jclass clazz2);

参数：
env：JNI接口指针。
clazz1：第一个类参数。
clazz2：第二个类参数。

返回值：
下列某个情况为真时返回JNI_TRUE：
第一及第二个类参数引用同一个Java类。
第一个类是第二个类的子类。
第二个类是第一个类的某个接口。

异常

Throw( ) 抛出java.lang.Throwable对象。

jint Throw(JNIEnv *env, jthrowable obj);

参数：
env：JNI接口指针。
obj：java.lang.Throwable对象。

返回值：
成功时返回0，失败时返回负数。

抛出：
java.lang.Throwable对象obj。

ThrowNew( )利用指定类的消息（由message指定）构造异常对象并抛出该异常。

jint ThrowNew(JNIEnv *env, jclass clazz, const char *message);

参数：
env：JNI接口指针。
clazz：java.lang.Throwable的子类。
message：用于构造java.lang.Throwable对象的消息。

返回值：
成功时返回0，失败时返回负数。

抛出：
新构造的java.lang.Throwable对象。

ExceptionOccurred( ) 确定是否某个异常正被抛出。在平台相关代码调用ExceptionClear()或Java代码处理该异常前，异常将始终保持抛出状态。

jthrowable ExceptionOccurred(JNIEnv *env);

参数：
env：JNI接口指针。

返回值：
返回正被抛出的异常对象，如果当前无异常被抛出，则返回NULL。

ExceptionDescribe( ) 将异常及堆栈的回溯输出到系统错误报告信道（例如 stderr）。该例程可便利调试操作。

void ExceptionDescribe(JNIEnv *env);

参数：
env：JNI接口指针。

ExceptionClear( ) 清除当前抛出的任何异常。如果当前无异常，则此例程不产生任何效果。

void ExceptionClear(JNIEnv *env);

参数：
env：JNI接口指针。

FatalError( )抛出致命错误并且不希望虚拟机进行修复。该函数无返回值。

void FatalError(JNIEnv *env, const char *msg);

参数：
env：JNI接口指针。
msg：错误消息。

全局及局部引用

NewGlobalRef( ) 创建obj参数所引用对象的新全局引用。obj参数既可以是全局引用，也可以是局部引用。全局引用通过调用DeleteGlobalRef()来显式撤消。

jobject NewGlobalRef(JNIEnv *env, jobject obj);

参数：
env：JNI接口指针。
obj：全局或局部引用。

返回值：
返回全局引用。如果系统内存不足则返回NULL。

DeleteGlobalRef( ) 删除globalRef所指向的全局引用。

void DeleteGlobalRef(JNIEnv *env, jobject globalRef);

参数：
env：JNI接口指针。
globalRef：全局引用。

DeleteLocalRef( ) 删除localRef所指向的局部引用。

void DeleteLocalRef(JNIEnv *env, jobject localRef);

参数：
env：JNI接口指针。
localRef：局部引用。

对象操作

AllocObject( ) 分配新Java对象而不调用该对象的任何构造函数。返回该对象的引用。clazz参数务必不要引用数组类。

jobject AllocObject(JNIEnv *env, jclass clazz);

参数：
env：JNI接口指针。
clazz：Java类对象。

返回值：
返回Java对象。如果无法构造该对象，则返回NULL。

抛出：
InstantiationException：如果该类为一个接口或抽象类。
OutOfMemoryError：如果系统内存不足。

NewObject( ) NewObjectA( ) NewObjectV( ) 构造新Java对象。

jobject NewObject(JNIEnv *env, jclass clazz, jmethodID methodID, ...);jobject NewObjectA(JNIEnv *env, jclass clazz, jmethodID methodID, jvalue *args);jobject NewObjectV(JNIEnv *env, jclass clazz, jmethodID methodID, va_list args);

方法ID指示应调用的构造函数方法。该ID必须通过调用GetMethodID( )获得，且调用时的方法名必须为init，而返回类型必须为void(V)。clazz参数务必不要引用数组类。

NewObject( )
编程人员应将传递给构造函数的所有参数紧跟着放在methodID参数的后面。NewObject( )收到这些参数后，将把它们传给编程人员所要调用的Java方法。

NewObjectA( )
编程人员应将传递给构造函数的所有参数放在jvalues类型的数组args中，该数组紧跟着放在methodID参数的后面。NewObject()收到数组中的这些参数后，将把它们传给编程人员所要调用的Java方法。

NewObjectV( )
编程人员应将传递给构造函数的所有参数放在va_list类型的参数args中，该参数紧跟着放在methodID参数的后面。NewObject()收到这些参数后，将把它们传给编程人员所要调用的Java方法。

参数：
env：JNI接口指针。
clazz：Java类对象。
methodID：构造函数的方法ID。

NewObject 的其它参数：
传给构造函数的参数。

NewObjectA的其它参数：
args：传给构造函数的参数数组。

NewObjectV的其它参数：
args：传给构造函数的参数va_list。

返回值：
返回Java对象，如果无法构造该对象，则返回NULL。

抛出：
InstantiationException：如果该类为接口或抽象类。
OutOfMemoryError：如果系统内存不足。

构造函数抛出的任何异常。

GetObjectClass( ) 返回对象的类。

jclass GetObjectClass(JNIEnv *env, jobject obj);

参数：
env：JNI接口指针。
obj：Java对象（不能为NULL）。

返回值：
返回Java类对象。

IsInstanceOf( ) 测试对象是否为某个类的实例。

jboolean IsInstanceOf(JNIEnv *env, jobject obj, jclass clazz);

参数：
env：JNI接口指针。
obj：Java对象。
clazz：Java类对象。

返回值：
如果可将obj强制转换为clazz，则返回JNI_TRUE。否则返回JNI_FALSE。NULL对象可强制转换为任何类。

IsSameObject( ) 测试两个引用是否引用同一Java对象。

jboolean IsSameObject(JNIEnv *env, jobject ref1, jobject ref2);

参数：
env：JNI接口指针。
ref1：Java对象。
ref2：Java对象。

返回值：
如果ref1和ref2引用同一Java对象或均为NULL，则返回JNI_TRUE。否则返回JNI_FALSE。

访问对象的域

GetFieldID( )

jfieldID GetFieldID(JNIEnv *env, jclass clazz, const char *name, const char *sig);

返回类的实例（非静态）域的域ID。该域由其名称及签名指定。访问器函数的Get[type]Field及Set[type]Field系列使用域ID检索
对象域。GetFieldID( )将未初始化的类初始化。GetFieldID( )不能用于获取数组的长度域。应使GetArrayLength( )。

参数：
env：JNI接口指针。
clazz：Java类对象。
name: 0终结的UTF-8字符串中的域名。
sig：0终结的UTF-8字符串中的域签名。

返回值：
域ID。如果操作失败，则返回NULL。

抛出：
NoSuchFieldError：如果找不到指定的域。
ExceptionInInitializerError：如果由于异常而导致类初始化程序失败。
OutOfMemoryError：如果系统内存不足。

Get[type]Field例程

NativeType Get[type]Field(JNIEnv *env, jobject obj, jfieldID fieldID);

该访问器例程系列返回对象的实例（非静态）域的值。要访问的域由通过调用GetFieldID( )而得到的域ID指定。

参数：
env：JNI接口指针。
obj：Java对象（不能为 NULL）。
fieldID：有效的域ID。

返回值：
域的内容。

下表说明了Get[type]Field例程名及结果类型。应将Get[type]Field中的type替换为域的Java类型（或使用表中的某个实际例程名），然后将NativeType替换为该例程对应的本地类型。

Get[type]Field例程名	本地类型
GetObjectField( )	jobject
GetBooleanField( )	jboolean
GetByteField( )	jbyte
GetCharField( )	jchar
GetShortField( )	jshort
GetIntField( )	jint
GetLongField( )	jlong
GetFloatField( )	jfloat
GetDoubleField( )	jdouble

Set[type]Field例程

void Set[type]Field(JNIEnv *env, jobject obj, jfieldID fieldID, NativeType value);

该访问器例程系列设置对象的实例（非静态）域的值。要访问的域由通过调用SetFieldID( )而得到的域ID指定。

参数：
env：JNI接口指针。
obj：Java对象（不能为NULL）。
fieldID：有效的域ID。
value：域的新值。

下表说明了Set[type]Field例程名及结果类型。应将Set[type]Field中的type替换为域的Java类型（或使用表中的某个实际例程名），然后将NativeType替换为该例程对应的本地类型。

Set[type]Field例程名	本地类型
Set[type]Field例程名	本地类型
SetObjectField( )	jobject
SetBooleanField( )	jboolean
SetByteField( )	jbyte
SetCharField( )	jchar
SetShortField( )	jshort
SetIntField( )	jint
SetLongField( )	jlong
SetFloatField( )	jfloat
SetDoubleField( )	jdouble

调用实例方法

GetMethodID( )

jmethodID GetMethodID(JNIEnv *env, jclass clazz, const char *name, const char *sig);

返回类或接口实例（非静态）方法的方法ID。方法可在某个clazz的超类中定义，也可从clazz继承。该方法由其名称和签名决定。GetMethodID( )可使未初始化的类初始化。要获得构造函数的方法ID，应将[init]作为方法名，同时将void (V)作为返回类型。

参数：
env：JNI接口指针。
clazz：Java类对象。
name：0终结的UTF-8字符串中的方法名。
sig：0终结的UTF-8字符串中的方法签名。

返回值：
方法ID，如果找不到指定的方法，则为NULL。

抛出：
NoSuchMethodError：如果找不到指定方法。
ExceptionInInitializerError：如果由于异常而导致类初始化程序失败。
OutOfMemoryError：如果系统内存不足。

Call[type]Method( )，Call[type]MethodA( )，Call[type]MethodV( )例程

NativeType Call[type]Method(JNIEnv *env, jobject obj, jmethodID methodID, ...);NativeType Call[type]MethodA(JNIEnv *env, jobject obj, jmethodID methodID, jvalue *args);NativeType Call[type]MethodV(JNIEnv *env, jobject obj, jmethodID methodID, va_list args);

这三个操作的方法用于从本地方法调用Java实例方法。它们的差别仅在于向其所调用的方法传递参数时所用的机制。这三个操作将根据所指定的方法ID调用Java对象的实例（非静态）方法。参数methodID必须通过调用GetMethodID( )来获得。当这些函数用于调用私有方法和构造函数时，方法ID必须从obj的真实类派生而来，而不应从其某个超类派生。

参数：
env：JNI接口指针。
obj：Java对象。
methodID：方法ID。

Call[type]Method例程的其它参数：
要传给Java方法的参数。

Call[type]MethodA例程的其它参数：
args：参数数组。

Call[type]MethodV例程的其它参数：
args：参数的va_list。

返回值：
返回调用Java方法的结果。

抛出：
执行Java方法时抛出的异常。
Call[type]Method例程

编程人员应将要传给方法的所有参数紧跟着放在methodID参数之后。Call[type]Method例程接受这些参数并将其传给编程人员所要调用的Java方法。

Call[type]MethodA例程

编程人员应将要传给方法的所有参数放在紧跟在methodID参数之后的jvalues类型数组args中。Call[type]MethodA routine接受这些数组中的参数并将其传给编程人员所要调用的Java方法。

Call[type]MethodV 例程

编程人员将方法的所有参数放在紧跟着在methodID参数之后的va_list类型参数变量中。Call[type]MethodV routine接受这些参数并将其传给编程人员所要调用的Java方法。

下表根据结果类型说明了各个方法调用例程。用户应将Call[type]Method中的type替换为所调用方法的Java类型（或使用表中的实际方法调用例程名），同时将NativeType替换为该例程相应的本地类型。

Call[type]Method例程名	本地类型
CallVoidMethod( ) CallVoidMethodA( ) CallVoidMethodV( )	void
CallObjectMethod( ) CallObjectMethodA( ) CallObjectMethodV( )	jobject
CallBooleanMethod( ) CallBooleanMethodA() CallBooleanMethodV( )	jboolean
CallByteMethod( ) CallByteMethodA( ) CallByteMethodV( )	jbyte
CallCharMethod( ) CallCharMethodA( ) CallCharMethodV( )	jchar
CallShortMethod( ) CallShortMethodA( ) CallShortMethodV( )	jshort
CallIntMethod( ) CallIntMethodA( ) CallIntMethodV( )	jint
CallLongMethod( ) CallLongMethodA( ) CallLongMethodV( )	jlong
CallFloatMethod( ) CallFloatMethodA( ) CallFloatMethodV( )	jfloat
CallDoubleMethod( ) CallDoubleMethodA( ) CallDoubleMethodV( )	jdouble

CallNonvirtual[type]Method，CallNonvirtual[type]MethodA，CallNonvirtual[type]MethodV例程

NativeType CallNonvirtual[type]Method(JNIEnv *env, jobject obj, jclass clazz, jmethodID methodID, ...);NativeType CallNonvirtual[type]MethodA(JNIEnv *env, jobject obj, jclass clazz, jmethodID methodID, jvalue *args);NativeType CallNonvirtual[type]MethodV(JNIEnv *env, jobject obj, jclass clazz, jmethodID methodID, va_list args);

这些操作根据指定的类和方法ID调用某Java对象的实例（非静态）方法。参数methodID必须通过调用clazz类的GetMethodID( )获得。CallNonvirtual[type]Method和Call[type]Method例程系列并不相同。Call[type]Method例程根据对象的类调用方法，而CallNonvirtual[type]Method例程则根据获得方法ID的（由clazz参数指定）类调用方法。方法ID必须从对象的真实类或其某个超类获得。

参数：
env：JNI接口指针。
clazz：Java类。
obj: Java对象。
methodID：方法ID。

CallNonvirtual[type]Method例程的其它参数：
要传给Java方法的参数。

CallNonvirtual[type]MethodA例程的其它参数：
args：参数数组。

CallNonvirtual[type]MethodV例程的其它参数：
args：参数的va_list。

返回值：
调用Java方法的结果。

抛出：
执行Java方法时所抛出的异常。

CallNonvirtual[type]Method例程

编程人员应将要传给方法的所有参数紧跟着放在methodID参数之后。CallNonvirtual[type]Method routine接受这些参数并将其传给编程人员所要调用的Java方法。

CallNonvirtual[type]MethodA例程

编程人员应将要传给方法的所有参数放在紧跟在methodID参数之后的jvalues类型数组args中。
CallNonvirtual[type]MethodA routine接受这些数组中的参数并将其传给编程人员所要调用的Java方法。

CallNonvirtual[type]MethodV例程

编程人员应将要传给方法的所有参数放在紧跟在methodID参数之后的va_list类型参数args中。CallNonvirtualMethodV routine接受这些参数并将其传给编程人员所要调用的Java方法。

下表根据结果类型说明了各个方法调用例程。用户应将CallNonvirtual[type]Method中的type替换为所调用方法的Java类型（或使用表中的实际方法调用例程名），同时将NativeType替换为该例程相应的本地类型。

CallNonvirtual[type]Method例程名	本地类型
CallNonvirtualVoidMethod( ) CallNonvirtualVoidMethodA( ) CallNonvirtualVoidMethodV( )	void
CallNonvirtualObjectMethod( ) CallNonvirtualObjectMethodA( ) CallNonvirtualObjectMethodV( )	jobject
CallNonvirtualBooleanMethod( ) CallNonvirtualBooleanMethodA( ) CallNonvirtualBooleanMethodV( )	jboolean
CallNonvirtualByteMethod( ) CallNonvirtualByteMethodA( ) CallNonvirtualByteMethodV( )	jbyte
CallNonvirtualCharMethod( ) CallNonvirtualCharMethodA( ) CallNonvirtualCharMethodV( )	jchar
CallNonvirtualShortMethod( ) CallNonvirtualShortMethodA( ) CallNonvirtualShortMethodV( )
CallNonvirtualIntMethod( ) CallNonvirtualIntMethodA( ) CallNonvirtualIntMethodV( )	jint
CallNonvirtualLongMethod( ) CallNonvirtualLongMethodA( ) CallNonvirtualLongMethodV( )	jlong
CallNonvirtualFloatMethod( ) CallNonvirtualFloatMethodA( ) CallNonvirtualFloatMethodV( )	jfloat
CallNonvirtualDoubleMethod( ) CallNonvirtualDoubleMethodA( ) CallNonvirtualDoubleMethodV( )	jdouble

访问静态域

GetStaticFieldID( )

jfieldID GetStaticFieldID(JNIEnv *env, jclass clazz, const char *name, const char *sig);

返回类的静态域的域ID。域由其名称和签名指定。GetStatic[type]Field和SetStatic[type]Field访问器函数系列使用域ID检索静态域。GetStaticFieldID()将未初始化的类初始化。

参数：
env：JNI接口指针。
clazz：Java类对象。
name: 0终结的UTF-8字符串中的静态域名。
sig：0终结的UTF-8字符串中的域签名。

返回值：
域ID。如果找不到指定的静态域，则为NULL。
抛出：
NoSuchFieldError：如果找不到指定的静态域。
ExceptionInInitializerError：如果由于异常而导致类初始化程序失败。
OutOfMemoryError：如果系统内存不足。

GetStatic[type]Field例程

NativeType GetStatic[type]Field(JNIEnv *env, jclass clazz, jfieldID fieldID);

该访问器例程系列返回对象的静态域的值。要访问的域由通过调用GetStaticFieldID()而得到的域ID指定。

参数：
env：JNI接口指针。
clazz：Java类对象。
fieldID：静态域ID。

返回值：
静态域的内容。

下表说明了GetStatic[type]Field例程名及结果类型。应将GetStatic[type]Field中的type替换为域的Java类型（或使用表中的某个实际例程名），然后将NativeType替换为该例程对应的本地类型。

GetStatic[type]Field例程名	本地类型
GetStaticObjectField( )	jobject
GetStaticBooleanField( )	jboolean
GetStaticByteField( )	jbyte
GetStaticCharField( )	jchar
GetStaticShortField( )	jshort
GetStaticIntField( )	jint
GetStaticLongField( )	jlong
GetStaticFloatField( )	jfloat
GetStaticDoubleField( )	jdouble

SetStatic[type]Field例程

void SetStatic[type]Field(JNIEnv *env, jclass clazz, jfieldID fieldID, NativeType value);

该访问器例程系列设置对象的静态域的值。要访问的域由通过调用GetStaticFieldID()而得到的域ID指定。

参数：
env：JNI接口指针。
clazz：Java类对象。
fieldID：静态域ID。
value：域的新值。

下表说明了SetStatic[type]Field例程名及结果类型。应将SetStatic[type]Field中的type替换为域的Java类型（或使用表中的某个实际例程名），然后将NativeType替换为该例程对应的本地类型。

SetStatic[type]Field例程名	本地类型
SetStaticObjectField( )	jobject
SetStaticBooleanField( )	jboolean
SetStaticByteField( )	jbyte
SetStaticCharField( )	jchar
SetStaticShortField( )	jshort
SetStaticIntField( )	jint
SetStaticLongField( )	jlong
SetStaticFloatField( )	jfloat
SetStaticDoubleField( )	jdouble

调用静态方法

GetStaticMethodID( ) 返回类的静态方法的方法ID。方法由其名称和签名指定。GetStaticMethodID( )将未初始化的类初始化。

jmethodID GetStaticMethodID(JNIEnv *env, jclass clazz, const char *name, const char *sig);

参数：
env：JNI接口指针。
clazz：Java类对象。
name：0终结UTF-8字符串中的静态方法名。
sig：0终结UTF-8字符串中的方法签名。

返回值：
方法ID，如果操作失败，则为NULL。

抛出：
NoSuchMethodError：如果找不到指定的静态方法。
ExceptionInInitializerError：如果由于异常而导致类初始化程序失败。
OutOfMemoryError：如果系统内存不足。

CallStatic[type]Method，CallStatic[type]MethodA，CallStatic[type]MethodV( ) 例程

NativeType CallStatic[type]Method(JNIEnv *env, jclass clazz, jmethodID methodID, ...);NativeType CallStatic[type]MethodA(JNIEnv *env, jclass clazz, jmethodID methodID, jvalue *args);NativeType CallStatic[type]MethodV(JNIEnv *env, jclass clazz, jmethodID methodID, va_list args);

这些操作将根据指定的方法ID调用Java对象的静态方法。methodID参数必须通过调用GetStaticMethodID()得到。方法ID必须从clazz派生，而不能从其超类派生。

参数：
env：JNI接口指针。
clazz：Java类对象。
methodID：静态方法ID。

CallStatic[type]Method例程的其它参数：
要传给静态方法的参数。

CallStatic[type]MethodA例程的其它参数：
args：参数数组。

CallStatic[type]MethodV例程的其它参数：
args：参数的va_list。

返回值：
返回调用静态Java方法的结果。

抛出：
执行Java方法时抛出的异常。

CallStatic[type]Method例程

编程人员应将要传给方法的所有参数紧跟着放在methodID参数之后。CallStatic[type]Method routine接受这些参数并将其传给编程人员所要调用的Java方法。

CallStatic[type]MethodA例程

编程人员应将要传给方法的所有参数放在紧跟在methodID参数之后的jvalues类型数组args中。CallStaticMethodA routine接受这些数组中的参数并将其传给编程人员所要调用的Java方法。

CallStatic[type]MethodV例程

编程人员应将要传给方法的所有参数放在紧跟在methodID参数之后的va_list类型参数args中。CallStaticMethodV routine接受这些参数并将其传给编程人员所要调用的Java方法。

下表根据结果类型说明了各个方法调用例程。用户应将CallStatic[type]Method中的type替换为所调用方法的Java类型（或使用表中的实际方法调用例程名），同时将NativeType替换为该例程相应的本地类型。

CallStatic[type]Method例程名	本地类型
CallStaticVoidMethod( ) CallStaticVoidMethodA( ) CallStaticVoidMethodV( )	void
CallStaticObjectMethod( ) CallStaticObjectMethodA( ) CallStaticObjectMethodV( )	jobject
CallStaticBooleanMethod( ) CallStaticBooleanMethodA( ) CallStaticBooleanMethodV( )	jboolean
CallStaticByteMethod( ) CallStaticByteMethodA( ) CallStaticByteMethodV( )	jbyte
CallStaticCharMethod( ) CallStaticCharMethodA( ) CallStaticCharMethodV( )	jchar
CallStaticShortMethod( ) CallStaticShortMethodA( ) CallStaticShortMethodV( )	jshort
CallStaticIntMethod( ) CallStaticIntMethodA( ) CallStaticIntMethodV( )	jint
CallStaticLongMethod( ) CallStaticLongMethodA( ) CallStaticLongMethodV( )	jlong
CallStaticFloatMethod( ) CallStaticFloatMethodA( ) CallStaticFloatMethodV( )	jfloat
CallStaticDoubleMethod( ) CallStaticDoubleMethodA( ) CallStaticDoubleMethodV( )	jdouble

字符串操作

NewString( ) 利用Unicode字符数组构造新的java.lang.String对象。

jstring NewString(JNIEnv *env, const jchar *unicodeChars, jsize len);

参数：
env：JNI接口指针。
unicodeChars：指向Unicode字符串的指针。
len：Unicode字符串的长度。

返回值：
Java字符串对象。如果无法构造该字符串，则为NULL。

抛出：
OutOfMemoryError：如果系统内存不足。

GetStringLength( ) 返回Java字符串的长度（Unicode字符数）。

jsize GetStringLength(JNIEnv *env, jstring string);

参数：
env：JNI接口指针。
string：Java字符串对象。

返回值：
Java 字符串的长度。

GetStringChars( ) 返回指向字符串的Unicode字符数组的指针。该指针在调用ReleaseStringchars()前一直有效。如果isCopy非空，则在复制完成后将*isCopy设为JNI_TRUE。如果没有复制，则设为JNI_FALSE。

const jchar * GetStringChars(JNIEnv *env, jstring string, jboolean *isCopy);

参数：
env：JNI接口指针。
string：Java字符串对象。
isCopy：指向布尔值的指针。

返回值：
指向Unicode字符串的指针，如果操作失败，则返回NULL。

ReleaseStringChars( ) 通知虚拟机平台相关代码无需再访问chars。参数chars是一个指针，可通过GetStringChars( )从string获得。

void ReleaseStringChars(JNIEnv *env, jstring string, const jchar *chars);

参数：
env：JNI接口指针。
string：Java字符串对象。
chars：指向Unicode字符串的指针。

NewStringUTF( ) 利用UTF-8字符数组构造新java.lang.String对象。

jstring NewStringUTF(JNIEnv *env, const char *bytes);

参数：
env：JNI接口指针。如果无法构造该字符串，则为NULL。
bytes：指向UTF-8字符串的指针。

返回值：
Java字符串对象。如果无法构造该字符串，则为NULL。

抛出：
OutOfMemoryError：如果系统内存不足。

GetStringUTFLength( ) 以字节为单位返回字符串的UTF-8长度。

jsize GetStringUTFLength(JNIEnv *env, jstring string);

参数：
env：JNI接口指针。
string：Java字符串对象。

返回值：
返回字符串的UTF-8长度。

GetStringUTFChars( ) 返回指向字符串的UTF-8字符数组的指针。该数组在被ReleaseStringUTFChars( )释放前将一直有效。如果isCopy不是NULL，*isCopy在复制完成后即被设为JNI_TRUE。如果未复制，则设为JNI_FALSE。

const char* GetStringUTFChars(JNIEnv *env, jstring string, jboolean *isCopy);

参数：
env：JNI接口指针。
string：Java字符串对象。
isCopy：指向布尔值的指针。

返回值：
指向UTF-8字符串的指针。如果操作失败，则为NULL。

ReleaseStringUTFChars( ) 通知虚拟机平台相关代码无需再访问utf。utf参数是一个指针，可利用GetStringUTFChars( )从string获得。

void ReleaseStringUTFChars(JNIEnv *env, jstring string, const char *utf);

参数：
env：JNI接口指针。
string：Java字符串对象。
utf：指向UTF-8字符串的指针。

数组操作

GetArrayLength( ) 返回数组中的元素数。

jsize GetArrayLength(JNIEnv *env, jarray array);

参数：
env：JNI接口指针。
array：Java数组对象。

返回值：
数组的长度。

NewObjectArray( ) 构造新的数组，它将保存类elementClass中的对象。所有元素初始值均设为initialElement。

jarray NewObjectArray(JNIEnv *env, jsize length, jclass elementClass, jobject initialElement);

参数：
env：JNI接口指针。
length：数组大小。
elementClass：数组元素类。
initialElement：初始值。

返回值：
Java数组对象。如果无法构造数组，则为NULL。

抛出：
OutOfMemoryError：如果系统内存不足。

GetObjectArrayElement( ) 返回Object数组的元素。

jobject GetObjectArrayElement(JNIEnv *env, jobjectArray array, jsize index);

参数：
env：JNI接口指针。
array：Java数组。
index：数组下标。

返回值：
Java对象。

抛出：
ArrayIndexOutOfBoundsException：如果index不是数组中的有效下标。

SetObjectArrayElement( ) 设置Object数组的元素。

void SetObjectArrayElement(JNIEnv *env, jobjectArray array, jsize index, jobject value);

参数：
env：JNI接口指针。
array：Java数组。
index：数组下标。
value：新值。

抛出：
ArrayIndexOutOfBoundsException：如果index不是数组中的有效下标。
ArrayStoreException：如果value的类不是数组元素类的子类。

New[PrimitiveType]Array( )例程

ArrayType NewArray(JNIEnv *env, jsize length);

用于构造新基本类型数组对象的一系列操作。

参数：
env：JNI接口指针。
length：数组长度。

返回值：
Java数组。如果无法构造该数组，则为NULL。

下表说明了特定的基本类型数组构造函数。用户应把New[PrimitiveType]Array替换为

New[PrimitiveType]Array例程	数组类型
NewBooleanArray( )	jbooleanArray
NewByteArray( )	jbyteArray
NewCharArray( )	jcharArray
NewShortArray( )	jshortArray
NewIntArray( )	jintArray
NewLongArray( )	jlongArray
NewFloatArray( )	jfloatArray
NewDoubleArray( )	jdoubleArray

Get[PrimitiveType]ArrayElements( )例程

jobject GetObjectArrayElement(JNIEnv *env, jobjectArray array, jsize index);

参数：
env：JNI接口指针。
array：Java数组。
index：数组下标。

返回值：
Java对象。

抛出：
ArrayIndexOutOfBoundsException：如果index不是数组中的有效下标。

SetObjectArrayElement( ) 设置Object数组的元素。

void SetObjectArrayElement(JNIEnv *env, jobjectArray array, jsize index, jobject value);

参数：
env：JNI接口指针。
array：Java数组。
index：数组下标。
value：新值。

抛出：
ArrayIndexOutOfBoundsException：如果index不是数组中的有效下标。
ArrayStoreException：如果value的类不是数组元素类的子类。

New[PrimitiveType]Array( )例程

ArrayType NewArray(JNIEnv *env, jsize length);

用于构造新基本类型数组对象的一系列操作。

参数：
env：JNI接口指针。
length：数组长度。

返回值：
Java数组。如果无法构造该数组，则为NULL。

下表说明了特定的基本类型数组构造函数。用户应把New[PrimitiveType]Array替换为某个实际的基本类型数组构造函数例程名（见下表），然后将ArrayType替换为该例程相应的数组类型。
|New[PrimitiveType]Array例程 |数组类型

NewBooleanArray( )	jbooleanArray
NewByteArray( )	jbyteArray
NewCharArray( )	jcharArray
NewShortArray( )	jshortArray
NewIntArray( )	jintArray
NewLongArray( )	jlongArray
NewFloatArray( )	jfloatArray
NewDoubleArray( )	jdoubleArray

Get[PrimitiveType]ArrayElements( )例程

NativeType *GetArrayElements(JNIEnv *env, ArrayType array, jboolean *isCopy);

一组返回基本类型数组体的函数。
结果在调用相应的Release[PrimitiveType]ArrayElements( )函数前将一直有效。由于返回的数组可能是Java数组的副本，因此对返回数组的更改不必在基本类型数组中反映出来，直到调用了Release[PrimitiveType]ArrayElements()。
如果isCopy不是NULL，*isCopy在复制完成后即被设为JNI_TRUE。如果未复制，则设为JNI_FALSE。

参数：
env：JNI接口指针。
array：Java字符串对象。
isCopy：指向布尔值的指针。

返回值：
返回指向数组元素的指针，如果操作失败，则为NULL。

下表说明了特定的基本类型数组元素访问器。应进行下列替换；

将Get[PrimitiveType]ArrayElements替换为表中某个实际的基本类型元素访问器例程名。
将ArrayType替换为对应的数组类型。
将NativeType替换为该例程对应的本地类型。
不管布尔数组在Java虚拟机中如何表示，GetBooleanArrayElements( )将始终返回一个jbooleans类型的指针，其中每一字节代表一个元素（开包表示）。内存中将确保所有其它类型的数组为连续的。

Get[PrimitiveType]ArrayElements例程	数组类型	本地类型
GetBooleanArrayElements( )	jbooleanArray	jboolean
GetByteArrayElements( )	jbyteArray	jbyte
GetCharArrayElements( )	jcharArray	jchar
GetShortArrayElements( )	jshortArray	jshort
GetIntArrayElements( )	jintArray	jint
GetLongArrayElements( )	jlongArray	jlong
GetFloatArrayElements( )	jfloatArray	jfloat
GetDoubleArrayElements( )	jdoubleArray	jdouble

Release[PrimitiveType]ArrayElements( )例程

void ReleaseArrayElements(JNIEnv *env, ArrayType array, NativeType *elems, jint mode);

通知虚拟机平台相关代码无需再访问elems的一组函数。
elems参数是一个通过使用对应的Get[PrimitiveType]ArrayElements()函数由array导出的指针。必要时，该函数将把对elems的修改复制回基本类型数组。mode参数将提供有关如何释放数组缓冲区的信息。如果elems不是array中数组元素的副本，mode将无效。否则，mode将具有下表所述的功能：

基本类型数组释放模	动作
0	复制回内容并释放elems缓冲区
JNI_COMMIT	复制回内容但不释放elems缓冲区
JNI_ABORT	释放缓冲区但不复制回变化

多数情况下，编程人员将把“0”传给mode参数以确保固定的数组和复制的数组保持一致。其它选项可以使编程人员进一步控制内存管理，但使用时务必慎重。

参数：
env：JNI接口指针。
array：Java数组对象。
elems：指向数组元素的指针。
mode：释放模式。

下表说明了构成基本类型数组撤消程序系列的特定例程。应进行如下替换；

将Release[PrimitiveType]ArrayElements 替换为下表中的某个实际基本类型数组撤消程序例程名。

将ArrayType替换为对应的数组类型。

将NativeType替换为该例程对应的本地类型。

ReleaseArrayElements例程数组类型本地类型

ReleaseBooleanArrayElements( ) jbooleanArray jboolean

ReleaseByteArrayElements( ) jbyteArray jbyte

ReleaseCharArrayElements( ) jcharArray jchar

ReleaseShortArrayElements( ) jshortArray jshort

ReleaseIntArrayElements( ) jintArray jint

ReleaseLongArrayElements( ) jlongArray jlong

ReleaseFloatArrayElements( ) jfloatArray jfloat

ReleaseDoubleArrayElements( ) jdoubleArray jdouble

ReleaseArrayElements例程	数组类型	本地类型
ReleaseBooleanArrayElements( )	jbooleanArray	jboolean
ReleaseByteArrayElements( )	jbyteArray	jbyte
ReleaseCharArrayElements( )	jcharArray	jchar
ReleaseShortArrayElements( )	jshortArray	jshort
ReleaseIntArrayElements( )	jintArray	jint
ReleaseLongArrayElements( )	jlongArray	jlong
ReleaseFloatArrayElements( )	jfloatArray	jfloat
ReleaseDoubleArrayElements( )	jdoubleArray	jdouble

Get[PrimitiveType]ArrayRegion例程

void GetArrayRegion(JNIEnv *env, ArrayType array, jsize start, jsize len, NativeType *buf);

将基本类型数组某一区域复制到缓冲区中的一组函数。

参数：
env：JNI接口指针。
array：Java指针。
start：起始下标。
len：要复制的元素数。
buf：目的缓冲区。

抛出：
ArrayIndexOutOfBoundsException：如果区域中的某个下标无效。

下表说明了特定的基本类型数组元素访问器。应进行如下替换：

将Get[PrimitiveType]ArrayRegion替换为表中的某个实际基本类型元素访问器例程名。

将 ArrayType 替换为对应的数组类型。

将 NativeType 替换为该例程对应的本地类型。

Get[PrimitiveType]ArrayRegion例程数组类型本地类型

GetBooleanArrayRegion( ) jbooleanArray jboolean

GetByteArrayRegion( ) jbyteArray jbyte

GetCharArrayRegion( ) jcharArray jchar

GetShortArrayRegion( ) jshortArray jshort

GetIntArrayRegion( ) jintArray jint

GetLongArrayRegion( ) jlongArray jlong

GetFloatArrayRegion( ) jfloatArray jfloat

GetDoubleArrayRegion( ) jdoubleArray jdouble

Get[PrimitiveType]ArrayRegion例程	数组类型	本地类型
GetBooleanArrayRegion( )	jbooleanArray	jboolean
GetByteArrayRegion( )	jbyteArray	jbyte
GetCharArrayRegion( )	jcharArray	jchar
GetShortArrayRegion( )	jshortArray	jshort
GetIntArrayRegion( )	jintArray	jint
GetLongArrayRegion( )	jlongArray	jlong
GetFloatArrayRegion( )	jfloatArray	jfloat
GetDoubleArrayRegion( )	jdoubleArray	jdouble

Set[PrimitiveType]ArrayRegion例程

void SetArrayRegion(JNIEnv *env, ArrayType array, jsize start, jsize len, NativeType *buf);

将基本类型数组的某一区域从缓冲区中复制回来的一组函数。

参数：
env：JNI接口指针。
array: Java数组。
start：起始下标。
len：要复制的元素数。
buf：源缓冲区。

抛出：
ArrayIndexOutOfBoundsException：如果区域中的某个下标无效。

下表说明了特定的基本类型数组元素访问器。应进行如下替换：

将Set[PrimitiveType]ArrayRegion替换为表中的实际基本类型元素访问器例程名。

将ArrayType替换为对应的数组类型。

将NativeType替换为该例程对应的本地类型。

Set[PrimitiveType]ArrayRegion例程数组类型本地类型

SetBooleanArrayRegion( ) jbooleanArray jboolean

SetByteArrayRegion( ) jbyteArray jbyte

SetCharArrayRegion( ) jcharArray jchar

SetShortArrayRegion( ) jshortArray jshort

SetIntArrayRegion( ) jintArray jint

SetLongArrayRegion( ) jlongArray jlong

SetFloatArrayRegion( ) jfloatArray jfloat

SetDoubleArrayRegion( ) jdoubleArray jdouble

Set[PrimitiveType]ArrayRegion例程	数组类型	本地类型
SetBooleanArrayRegion( )	jbooleanArray	jboolean
SetByteArrayRegion( )	jbyteArray	jbyte
SetCharArrayRegion( )	jcharArray	jchar
SetShortArrayRegion( )	jshortArray	jshort
SetIntArrayRegion( )	jintArray	jint
SetLongArrayRegion( )	jlongArray	jlong
SetFloatArrayRegion( )	jfloatArray	jfloat
SetDoubleArrayRegion( )	jdoubleArray	jdouble

注册本地方法

RegisterNatives( )

jint RegisterNatives(JNIEnv *env, jclass clazz, const JNINativeMethod *methods, jint nMethods);

向clazz参数指定的类注册本地方法。methods参数将指定JNINativeMethod结构的数组，其中包含本地方法的名称、签名和函数指针。nMethods参数将指定数组中的本地方法数。

参数：
env：JNI接口指针。
clazz：Java类对象。
methods：类中的本地方法。
nMethods：类中的本地方法数。

返回值：
成功时返回 “0”；失败时返回负数。

抛出：
NoSuchMethodError：如果找不到指定的方法或方法不是本地方法。

JNINativeMethod 结构定义如下所示：

typedef struct {    char *name;    char *signature;    void *fnPtr;} JNINativeMethod;

函数指针通常必须有下列签名：

ReturnType (*fnPtr)(JNIEnv *env, jobject objectOrClass, ...);

UnregisterNatives( )

jint UnregisterNatives(JNIEnv *env, jclass clazz);

取消注册类的本地方法。类将返回到链接或注册了本地方法函数前的状态。该函数不应在常规平台相关代码中使用。相反，它可以为某些程序提供一种重新加载和重新链接本地库的途径。

参数：
env：JNI接口指针。
clazz：Java类对象。

返回值：
成功时返回“0”；失败时返回负数。

监视程序操作

MonitorEnter( )

jint MonitorEnter(JNIEnv *env, jobject obj);

进入与obj所引用的基本Java对象相关联的监视程序。每个Java对象都有一个相关联的监视程序。如果当前线程已经拥有与obj相关联的监视程序，它将使指示该线程进入监视程序次数的监视程序计数器增 1。如果与 obj 相关联的监视程序并非由某个线程所拥有，则当前线程将变为该监视程序的所有者，同时将该监视程序的计数器设置为 1。如果另一个线程已拥有与 obj 关联的监视程序，则在监视程序被释放前当前线程将处于等待状态。监视程序被释放后，当前线程将尝试重新获得所有权。

参数：
env：JNI接口指针。
obj：常规Java对象或类对象。

返回值：
成功时返回“0”；失败时返回负数。

MonitorExit( )

jint MonitorExit(JNIEnv *env, jobject obj);

当前线程必须是与obj所引用的基本Java对象相关联的监视程序的所有者。线程将使指示进入监视程序次数的计数器减 1。如果计数器的值变为 0，当前线程释放监视程序。

参数：
env：JNI接口指针。
obj：常规Java对象或类对象。

返回值：
成功时返回“0”；失败时返回负数。

Java虚拟机接口

GetJavaVM( )

jint GetJavaVM(JNIEnv *env, JavaVM **vm);

返回与当前线程相关联的Java虚拟机接口（用于调用API中）。结果将放在第二个参数vm所指向的位置。

参数：
env：JNI接口指针。
vm：指向放置结果的位置的指针。

返回值：
成功时返回“0”；失败时返回负数。

调用API

调用API允许软件厂商将Java虚拟机加载到任意的本地程序中。厂商可以交付支持Java的应用程序，而不必链接Java虚拟机源代码。本章首先概述了调用API。然后是所有调用API函数的引用页。若要增强Java虚拟机的嵌入性，可以用几种方式来扩展JDK 1.1.2中的调用API。

概述

以下代码示例说明了如何使用调用API中的函数。在本例中，C++代码创建Java虚拟机并且调用名为Main.test的静态方法。为清楚起见，我们略去了错误检查。

#include <jni.h>/* 其中定义了所有的事项 */JavaVM *jvm;/* 表示 Java 虚拟机*/JNIEnv *env;/* 指向本地方法接口的指针 */JDK1_1InitArgs vm_args; /* JDK 1.1 虚拟机初始化参数 */vm_args.version = 0x00010001; /* 1.1.2 中新增的：虚拟机版本 *//* 获得缺省的初始化参数并且设置类路径 */JNI_GetDefaultJavaVMInitArgs(&vm_args);vm_args.classpath = ...;/* 加载并初始化 Java 虚拟机，返回env中的JNI 接口指针 */JNI_CreateJavaVM(&jvm, &env, &vm_args);/* 用 JNI 调用 Main.test 方法 */jclass cls = env->FindClass("Main");jmethodID mid = env->GetStaticMethodID(cls, "test", "(I)V");env->CallStaticVoidMethod(cls, mid, 100);/* 结束。*/jvm->DestroyJavaVM();

本例使用了API中的三个函数。调用API允许本地应用程序用JNI接口指针来访问虚拟机特性。其设计类似于Netscape的JRI嵌入式接口。

创建虚拟机

JNI_CreateJavaVM()函数加载并初始化Java虚拟机，然后将指针返回到JNI接口指针。调用JNI_CreateJavaVM()的线程被看作主线程。

卸载虚拟机

主线程不能自己断开与虚拟机的连接。而是必须调用DestroyJavaVM( )来卸载整个虚拟机。

虚拟机等到主线程成为唯一的用户线程时才真正地卸载。用户线程包括Java线程和附加的本地线程。之所以存在这种限制是因为Java线程或附加的本地线程可能正占用着系统资源，例如锁，窗口等。虚拟机不能自动释放这些资源。卸载虚拟机时，通过将主线程限制为唯一的运行线程，使释放任意线程所占用系统资源的负担落到程序员身上。

初始化结构

不同的Java虚拟机实现可能会需要不同的初始化参数。很难提出适合于所有现有和将来的Java虚拟机的标准初始化结构。作为一种折衷方式，我们保留了第一个域(version)来识别初始化结构的内容。嵌入到JDK 1.1.2中的本地应用程序必须将版本域设置为0x00010001。尽管其它实现可能会忽略某些由JDK所支持的初始化参数，我们仍然鼓励虚拟机实现使用与JDK一样的初始化结构。0x80000000到0xFFFFFFFF之间的版本号需保留，并且不为任何虚拟机实现所识别。

以下代码显示了初始化JDK 1.1.2中的Java虚拟机所用的结构。

typedef struct JavaVMInitArgs {    /* 前两个域在 JDK 1.1 中保留，并在 JDK 1.1.2 中正式引入。*/    /* Java 虚拟机版本 */    jint version;    /* 系统属性。*/    char **properties;    /* 是否检查 Java 源文件与已编译的类文件之间的新旧关系。*/    jint checkSource;    /* Java 创建的线程的最大本地堆栈大小。*/    jint nativeStackSize;    /* 最大 Java 堆栈大小。*/    jint javaStackSize;    /* 初始堆大小。*/    jint minHeapSize;    /* 最大堆大小。*/    jint maxHeapSize;    /* 控制是否校验 Java 字节码：0 无，1 远程加载的代码，2 所有代码。*/    jint verifyMode;    /* 类加载的本地目录路径。*/    const char *classpath;    /* 重定向所有虚拟机消息的函数的钩子。*/    jint (*vfprintf)(FILE *fp, const char *format, va_list args);    /* 虚拟机退出钩子。*/    void (*exit)(jint code);    /* 虚拟机放弃钩子。*/    void (*abort)();    /* 是否启用类 GC。*/    jint enableClassGC;    /* GC 消息是否出现。*/    jint enableVerboseGC;    /* 是否允许异步 GC。*/    jint disableAsyncGC;    /* 三个保留的域。*/    jint reserved0;    jint reserved1;    jint reserved2;} JDK1_1InitArgs;

在JDK 1.1.2中，初始化结构提供了钩子，这样在虚拟机终止时，本地应用程序可以重定向虚拟机消息并获得控制权。当本地线程与JDK 1.1.2中的Java虚拟机连接时，以下结构将作为参数进行传递。实际上，本地线程与JDK 1.1.2连接时不需要任何参数。JDK1_1AttachArgs 结构仅由C编译器的填充槽组成，而C编译器不允许空结构。

typedef struct JDK1_1AttachArgs {    /*    * JDK 1.1 不需要任何参数来附加本地线程。此处填充的作用是为了满足不允许空结构的C编译器的要求。    */    void *__padding;} JDK1_1AttachArgs;

调用API函数

JavaVM类型是指向调用API函数表的指针。以下代码示例显示了这种函数表。

typedef const struct JNIInvokeInterface *JavaVM;const struct JNIInvokeInterface ... = {NULL,NULL,NULL,DestroyJavaVM,AttachCurrentThread,DetachCurrentThread,};

注意，JNI_GetDefaultJavaVMInitArgs( )、JNI_GetCreatedJavaVMs( )和JNI_CreateJavaVM( ) 这三个调用API函数不是JavaVM函数表的一部分。不必先有JavaVM结构，就可以使用这些函数。

JNI_GetDefaultJavaVMInitArgs( )

jint JNI_GetDefaultJavaVMInitArgs(void *vm_args);

返回Java虚拟机的缺省配置。在调用该函数之前，平台相关代码必须将vm_args->version 域设置为它所期望虚拟机支持的JNI版本。在JDK 1.1.2中，必须将vm_args->version设置为0x00010001。（JDK 1.1不要求平台相关代码设置版本域。为了向后兼容性，如果没有设置版本域，则JDK 1.1.2假定所请求的版本为0x00010001。JDK的未来版本将要求把版本域设置为适当的值。）该函数返回后，将把vm_args->version设置为虚拟机支持的实际JNI版本。

参数：
vm_args：指向VM-specific initialization（特定于虚拟机的初始化）结构的指针，缺省参数填入该结构。

返回值：
如果所请求的版本得到支持，则返回“0”；如果所请求的版本未得到支持，则返回负数。

JNI_GetCreatedJavaVMs( )

jint JNI_GetCreatedJavaVMs(JavaVM **vmBuf, jsize bufLen, jsize *nVMs);

返回所有已创建的Java虚拟机。将指向虚拟机的指针依据其创建顺序写入vmBuf缓冲区。最多写入bufLen项。在*nVMs中返回所创建虚拟机的总数。JDK 1.1不支持在单个进程中创建多个虚拟机。

参数：
vmBuf：指向将放置虚拟机结构的缓冲区的指针。
bufLen：缓冲区的长度。
nVMs：指向整数的指针。

返回值：
成功时返回“0”；失败则返回负数。

JNI_CreateJavaVM( )

jint JNI_CreateJavaVM(JavaVM **p_vm, JNIEnv **p_env, void *vm_args);

加载并初始化Java虚拟机。当前线程成为主线程。将env参数设置为主线程的JNI接口指针。JDK 1.1.2不支持在单个进程中创建多个虚拟机。必须将vm_args中的版本域设置为0x00010001。

参数：
p_vm：指向位置（其中放置所得到的虚拟机结构）的指针。
p_env：指向位置（其中放置主线程的 JNI 接口指针）的指针。
vm_args: Java 虚拟机初始化参数。

返回值：
成功时返回“0”；失败则返回负数。

DestroyJavaVM( )

jint DestroyJavaVM(JavaVM *vm);

卸载Java虚拟机并回收资源。只有主线程能够卸载虚拟机。调用DestroyJavaVM( ) 时，主线程必须是唯一的剩余用户线程。

参数：
vm：将销毁的Java虚拟机。

返回值：
成功时返回“0”；失败则返回负数。

JDK 1.1.2 不支持卸载虚拟机。

AttachCurrentThread( )

jint AttachCurrentThread(JavaVM *vm, JNIEnv **p_env, void *thr_args);

将当前线程连接到Java虚拟机。在JNIEnv参数中返回JNI接口指针。试图连接已经连接的线程将不执行任何操作。本地线程不能同时连接到两个Java虚拟机上。

参数：
vm：当前线程所要连接到的虚拟机。
p_env：指向位置（其中放置当前线程的 JNI 接口指针）的指针。
thr_args：特定于虚拟机的线程连接参数。

返回值：
成功时返回“0”；失败则返回负数。

DetachCurrentThread( )

jint DetachCurrentThread(JavaVM *vm);

断开当前线程与Java虚拟机之间的连接。释放该线程占用的所有Java监视程序。通知所有等待该线程终止的Java线程。主线程（即创建Java虚拟机的线程）不能断开与虚拟机之间的连接。作为替代，主线程必须调用JNI_DestroyJavaVM( )来卸载整个虚拟机。

参数：
vm：当前线程将断开连接的虚拟机。

返回值：
成功时返回“0”；失败则返回负数。

CreateFile( )

函数原型
HANDLE CreateFile(        LPCTSTR lpfileName，        DWORD deDesiredAccess,        DWORD dwShareMode,        LPSECURITY_ATTRIBUTES lpSecurityAttributes        DWORD dwCreationDesposition,        DWORD dwFlagsAndAtrributes,        HANDLE hTemplateFile);
函数说明
该函数创建、打开或截断一个文件，并返回一个能够被用来存取该文件的句柄。此句柄允许读书据、写数据以及移动文件的指针。CreateFile函数既可以做为一个宽自负函数使用，也可以作为一个ANSI函数来用。

参数说明
lpFileName:指向文件字符串的指针。
dwDesireAccess:制定文件的存取模式，可以取下列值：

0:制定可以查询对象。

GENERIC_READ:指定可以从文件中度去数据。

GENERIC_WRITE:指定可以向文件中写数据。

dwShareMode:指定文件的共享模式，可以取下列值：

0:不共享。

FILE_SHARE_DELETE:在 Windows NT 系统中，只有为了删除文件而进行的打开操作才会成功。

FILE_SHARE_READ:只有为了从文件中度去数据而进行的打开操作才会成功。

FILE_SHARE_WRITE:只有为了向文件中写数据而进行的打开操作才会成功。

lpSecurityAttributes :指定文件的安全属性。
dwCreationDisopsition:指定创建文件的方式，可以取以下值：

CREATE_NEW：创建新文件，如果文件已存在，则函数失败。

CREATE_ALWAYS：创建爱内心文件，如果文件已存在，则函数将覆盖并清除旧文件。

OPEN_EXISTING：打开文件，如果文件不存在，函数将失败。

OPEN_ALWAYS：打开文件，如果文件不存在，则函数将创建一个新文件。

TRUNCATE_EXISTING：打开外呢间，如果文件存在，函数将文件的大小设为零，如果文件不存在，函数将失败返回。

dwFlagsAndAtrributes :指定新建文件的属性和标志，它可以取以下值：

FILE_ATTRIBUTE_ARCHIVE:归档属性。

FILE_ATTRIBUTE_HIDDEN:隐藏属性。

FILE_ATTRIBUTE_NORMAL:正常属性。

FILE_ATTRIBUTE_READONLY:只读属性。

FILE_ATTRIBUTE_READONLY:只读属性。

FILE_ATTRIBUTE_TEMPORARY:临时存储文件，系统总是将临时文件的所有数据读入内存中，以加速对该文件的访问速度。用户应该尽快删除不再使用的临时文件。

FILE_FLAG_OVERLAPPED:用户可以通过一个 OVERLAPPED 结构变量来保存和设置文件读写指针，从而可以完成重叠式的读和写。一般用于数量比较大的读些操作。

hTemplateFile :指向一个具有GENERIC_READ属性的文件的句柄，该文件为要创建的文件提供文件属性和文件扩展属性。

注意事项
函数成功将返回指定文件的句柄，否则返回NULL。

总结

至此整个JNI完全手册引用结束。日后开发过程中该手册相当于一本字典，可以用来查阅。
本文内容主要参考http://blog.csdn.net/yanbober/article/details/45310365，感谢博主的辛劳……