JNI 接口规范.doc

1. 简介
Java 本地接口概述
背景
JDK 本地方法接口
Java 运行时接口
原始本地接口和 接口
目标
Java 本地接口方法
利用 JNI 编程
JDK 中的变化
2. 设计概述
JNI 接口函数和指针
加载和链接本地方法
解析本地方法名
本地方法的参数
引用 Java 对象
全局和局部引用
实现局部引用
访问 Java 对象
访问基本类型数组
访问域和方法
报告编程错误
Java 异常
异常和错误代码
异步异常
异常的处理
3. JNI 的类型和数据结构
基本类型
引用类型
域 ID 和方法 ID
值类型
类型签名
UTF-8 字符串
4. JNI 函数
接口函数表
版本信息
GetVersion
类操作
DefineClass
FindClass
GetSuperclass
IsAssignableFrom
异常
Throw
ThrowNew
urred
ExceptionDescribe
ExceptionClear
FatalError
全局及局部引用
NewGlobalRef
DeleteGlobalRef
DeleteLocalRef
对象操作
AllocObject

GetObjectClass
IsInstanceOf
IsSameObject
访问对象的域
GetFieldID
Get<type>Field 例程
Set<type>Field 例程
调用实例方法
GetMethodID
Call<type>Method
CallNonvirtual<type>Method
访问静态域
GetStaticFieldID
GetStatic<type>Field 例程
SetStatic<type>Field 例程
调用静态方法
GetStaticMethodID
CallStatic<type>Method
字符串操作
NewString
GetStringLength
GetStringChars
ReleaseStringChars
NewStringUTF
GetStringUTFLength
GetStringUTFChars
ReleaseStringUTFChars
数组操作
GetArrayLength
NewObjectArray
GetObjectArrayElement
SetObjectArrayElement
New<PrimitiveType>Array 例程
Get<PrimitiveType>ArrayElements 例程
Release<PrimitiveType>ArrayElements 例程
Get<PrimitiveType>ArrayRegion 例程
Set<PrimitiveType>ArrayRegion 例程
注册本地方法
RegisterNatives
UnregisterNatives
监视程序操作
MonitorEnter
MonitorExit
Java 虚拟机接口
GetJavaVM
5. 调用 API
概述
创建虚拟机
连接虚拟机
卸载虚拟机
初始化结构
调用 API 函数
JNI_GetDefaultJavaVMInitArgs
JNI_GetCreatedJavaVMs
JNI_CreateJavaVM
DestroyJavaVM
AttachCurrentThread
DetachCurrentThread

1 - 简介
本章介绍 Java 本地接口(Java Native Interface,JNI)。JNI 是本地编程接口。它使得在 Java 虚拟机(VM) 内部运行的 Java 代码能够与用其它编程语言(如 C、C++ 和汇编语言)编写的应用程序和库进行互操作。
JNI 最重要的好处是它没有对底层 Java 虚拟机的实现施加任何限制。因此,Java 虚拟机厂商可以在不影响虚拟机其它部分的情况下添加对 JNI 的支持。程序员只需编写一种版本的本地应用程序或库,就能够与所有支持 JNI 的 Java 虚拟机协同工作。
本章论及以下主题:
Java 本地接口概述
背景
目标
Java 本地接口方法
利用 JNI 编程
JDK 中的变化
Java 本地接口概述
尽管可以完全用 Java 编写应用程序,但是有时单独用 Java 不能满足应用程序的需