спецификации, руководства, описания, API

Contents | Prev | Next

Java Native Interface Specification

May 16, 1997

Contents

1. Introduction

Java Native Interface Overview

: JDK 1.0 Native Method Interface
: Java Runtime Interface
: Raw Native Interface and Java/COM Interface

Java Native Interface Approach

Programming to the JNI

Changes in JDK 1.1.2

2. Design Overview

JNI Interface Functions and Pointers

Loading and Linking Native Methods

: Resolving Native Method Names
: Native Method Arguments

Referencing Java Objects

: Global and Local References
: Implementing Local References

Accessing Java Objects

: Accessing Primitive Arrays
: Accessing Fields and Methods

Reporting Programming Errors

Java Exceptions

: Exceptions and Error Codes
: Asynchronous Exceptions
: Exception Handling

3. JNI Types and Data Structures

: Primitive Types
: Reference Types
: Field and Method IDs
: The Value Type
: Type Signatures
: UTF-8 Strings

4. JNI Functions

Interface Function Table

Version Information

: GetVersion

Class Operations

: DefineClass
: FindClass
: GetSuperclass
: IsAssignableFrom

: Throw
: ThrowNew
: ExceptionOccurred
: ExceptionDescribe
: ExceptionClear
: FatalError

Global and Local References

: NewGlobalRef
: DeleteGlobalRef
: DeleteLocalRef

Object Operations

: AllocObject

: GetObjectClass
: IsInstanceOf
: IsSameObject

Accessing Fields of Objects

: GetFieldID
: Get<type>Field Routines
: Set<type>Field Routines

Calling Instance Methods

: GetMethodID
: Call<type>Method
: CallNonvirtual<type>Method

Accessing Static Fields

: GetStaticFieldID
: GetStatic<type>Field Routines
: SetStatic<type>Field Routines

Calling Static Methods

: GetStaticMethodID
: CallStatic<type>Method

String Operations

: NewString
: GetStringLength
: GetStringChars
: ReleaseStringChars
: NewStringUTF
: GetStringUTFLength
: GetStringUTFChars
: ReleaseStringUTFChars

Array Operations

: GetArrayLength
: NewObjectArray
: GetObjectArrayElement
: SetObjectArrayElement
: New<PrimitiveType>Array Routines
: Get<PrimitiveType>ArrayElements Routines
: Release<PrimitiveType>ArrayElements Routines
: Get<PrimitiveType>ArrayRegion Routines
: Set<PrimitiveType>ArrayRegion Routines

Registering Native Methods

: RegisterNatives
: UnregisterNatives

Monitor Operations

: MonitorEnter
: MonitorExit

Java VM Interface

: GetJavaVM

5. The Invocation API

: Creating the VM
: Attaching to the VM
: Unloading the VM

Initialization Structures

Invocation API Functions

: JNI_GetDefaultJavaVMInitArgs
: JNI_GetCreatedJavaVMs
: JNI_CreateJavaVM
: DestroyJavaVM
: AttachCurrentThread
: DetachCurrentThread

Contents | Prev | Next

Java Native Interface Specification (HTML generated by dkramer on March 15, 1997)
Copyright © 1996, 1997 Sun Microsystems, Inc. All rights reserved
Please send any comments or corrections to jni@java.sun.com