程序博客网 > 如何设置淘宝店铺背景

JNI 常用API

来源：互联网 发布：如何设置淘宝店铺背景 编辑：程序博客网 时间：2024/04/28 18:53

JNI 常用API

 

利用JNIEnv自变量，程序员可访问一系列函数。这些函数可划分为下述类别：

■获取版本信息

■进行类和对象操作

■控制对Java对象的全局和局部引用

■访问实例字段和静态字段

■调用实例方法和静态方法

■执行字串和数组操作

■产生和控制Java异常

 

获取版本信息

jint GetVersion(JNIEnv *env);

 

获取JNI函数版本信息，

返回值为jint类型，在c/c++中jint为32位数，其中高16位是主版本号，低16位是从版本号

In JDK/JRE 1.1, GetVersion() returns 0x00010001.

In JDK/JRE 1.2, GetVersion() returns 0x00010002.

In JDK/JRE 1.4, GetVersion() returns 0x00010004.

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

 

在CLASSPATH 环境变量中搜索目录和zip 文件中具有指定名称的类。

 

参数：

name: a fully-qualified class name  完全限定类 ，给出完整的类路径，包名和类名使用“/”隔开

SINCE JDK/JRE 1.2:

 

产生和控制Java异常

 

jint Throw(JNIEnv *env, jthrowable obj);

 

抛出异常

 

参数：jthrowable  是 java.lang.Throwable 包中对象.

 

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

 

通过消息构造一个异常类，其中参数clazz 为 java.lang.Throwable包中的子类

 

jthrowable ExceptionOccurred(JNIEnv *env);

 

测试JVM是否有异常发生

 

SINCE JDK/JRE 1.2:

 

 

local reference 和 global reference。

 

Java 和JNI代码之间函数调用时，简单类型，也就是内置类型，比如 int, char 等是值传递（pass by value），而其它 Java 对象都是引用传递（pass by reference），这些对象引用由 JVM 传给JNI代码，每个都有其生命周期。

 

JNI 函数参数中 jobject 或者它的子类，其参数都是 local reference。Local reference 只在这个 JNI函数中有效，JNI函数返回后，引用的对象就被释放，它的生命周期就结束了。若要留着日后使用，则需根据这个 local reference 创建 global reference。Global reference 不会被系统自动释放，它仅当被程序明确调用 DeleteGlobalReference 时才被回收。（JNI多线程机制）

 

jobject NewGlobalRef(JNIEnv *env, jobject obj);

 

创建一个新的全局的引用，只能使用DeleteGlobalRef（）函数销毁这个全局引用

参数：

Obj 一个本地引用或者全局引用

 

void DeleteGlobalRef(JNIEnv *env, jobject globalRef);

 

销毁全局引用

参数：

globalRef 使用NewGlobalRef（）函数生成的全局引用

 

 void DeleteLocalRef(JNIEnv *env, jobject localRef);

 

销毁本地的引用

 

注意：

JDK/JRE 1.1 提供了上面的 DeleteLocalRef 函数，使程序员可以手动删除本地引用。例如，如果本机代码遍历可能很大的对象或数组，并使用每个迭代中的一个元素，好的做法是下一次迭代中创建一个新的本地引用之前删除本地元素的引用。

JDK/JRE 1.2 和更高版本为本地引用生存周期管理提供了一套额外的函数。他们是下面列出的四种函数。

jint EnsureLocalCapacity(JNIEnv *env, jint capacity);

通知JVM 您将使用超过 16 个本地引用。这将允许 JVM 优化对该本机代码的本地引用的处理

jint PushLocalFrame(JNIEnv *env, jint capacity);

 

jobject PopLocalFrame(JNIEnv *env, jobject result);

先调用PushLocalFrame，然后创建局部引用，并对其进行处理，最后调用PushLocalFrame释放局部引用，这时Java虚拟机也可以对其指 向的对象进行垃圾回收。可以用C语言的栈来理解这对JNI API，调用PushLocalFrame之后Native代码创建的所有局部引用全部入栈，当调用PopLocalFrame之后，入栈的局部引用除了 需要返回的局部引用(PushLocalFrame和PopLocalFrame这对函数可以返回一个局部引用给外部)之外，全部出栈，Java虚拟机这 时可以释放他们指向的对象。具体的用法可以参考手册。这两个函数使JNI的局部引用由于和C语言的局部变量用法类似，所以强烈推荐使用

jobject NewLocalRef(JNIEnv *env, jobject ref);

1、Java虚拟机默认为Native引用分配的局部引用数量是有限的，大部分的Java虚拟机实现默认分配16个局部引用。当然Java虚拟 机也提供API(PushLocalFrame，EnsureLocalCapacity)让你申请更多的局部引用数量(Java虚拟机不保证你一定能申 请到)。有限的资源当然要省着点用，否则将会被Java虚拟机无情抛弃(程序崩溃)。JNI编程中，实现Native代码时强烈建议调用PushLocalFrame，EnsureLocalCapacity来确保Java虚拟机为你准备好了局部变量空间。

2、如果你实现的Native函数是工具函数，会被频繁的调用。如果你在Native函数中没有显示删除局部引用，那么每次调用该函数Java虚拟机都会创建一个新的局部引用，造成局部引用过多。尤其是该函数在Native代码中被频繁调用，代码的控制权没有交还给Java虚拟机，所以Java虚拟机根本没有机会释放这些局部变量。退一步讲，就算该函数直接返回给Java虚拟机，也不能保证没有问题，我们不能假设Native函数返回Java虚 拟机之后，Java虚拟机马上就会回收Native函数中创建的局部引用，依赖于Java虚拟机实现。所以我们在实现Native函数时一定要记着删除不 必要的局部引用，否则你的程序就有潜在的风险，不知道什么时候就会爆发。

3、如果你Native函数根本就不返回。比如消息循环函数——死循环等待消息，处理消息。如果你不显示删除局部引用，很快将会造成Java虚拟机的局部引用内存溢出。

Weak Global References

全局的弱引用是一种特殊的全局引用，与普通的全局引用不同全局的弱引用允许Java 对象进行垃圾回收，当垃圾收集器运行时，它将释放对象，如果引用的对象只使用弱引用

jweak NewWeakGlobalRef(JNIEnv *env, jobject obj);

void DeleteWeakGlobalRef(JNIEnv *env, jweak obj);

SINCE JDK/JRE 1.2:

Object Operations

jobject AllocObject(JNIEnv *env, jclass clazz);

分配一个新的 Java 对象，而不调用任何对象的构造函数，仅仅是内存创建

jobject NewObject(JNIEnv *env, jclass clazz,
jmethodID methodID, ...);

jobject NewObjectA(JNIEnv *env, jclass clazz,
jmethodID methodID, jvalue *args);

args: an array of arguments to the constructor.

jobject NewObjectV(JNIEnv *env, jclass clazz,
jmethodID methodID, va_list args);

args: a va_list of arguments to the constructor.

分配一个新的java对象，调用指定的构造函数，构造函数使用methodID指定

jclass GetObjectClass(JNIEnv *env, jobject obj);

根据类的引用返回类的类型

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

测试类的引用类型，是返回JNI_TRUE 否则 返回JNI_FALSE

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

测试两个引用类型是否指向同一个空间，是返回JNI_TRUE 否则 返回JNI_FALSE

 

Accessing Fields of Objects

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

GetFieldID是得到java类中的参数ID，只能调用类中声明为 public的属性，jfieldID为 Get<type>Field andSet<type>Field 函数族使用

参数：

Name 属性在java类中的名字

Sig 类型签名

Get<type>Field Routines

NativeType Get<type>Field(JNIEnv *env, jobject obj,
jfieldID fieldID);

                                      

表 3-3    Get<type>Field Family of Accessor Routines

Get<type>Field Routine Name

Native Type

GetObjectField()

jobject

GetBooleanField()

jboolean

GetByteField()

jbyte

GetCharField()

jchar

GetShortField()

jshort

GetIntField()

jint

GetLongField()

jlong

GetFloatField()

jfloat

GetDoubleField()

jdouble

获取java对象属性的值

Set<type>Field Routines

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

表 3-4    Set<type>Field Family of Accessor Routines

Set<type>Field Routine Name

Native Type

SetObjectField()

jobject

SetBooleanField()

jboolean

SetByteField()

jbyte

SetCharField()

jchar

SetShortField()

jshort

SetIntField()

jint

SetLongField()

jlong

SetFloatField()

jfloat

SetDoubleField()

jdouble

设置java对象属性的值

Calling Instance Methods

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

GetMethodID得到java类中方法的ID，它只能调用类中声明为 public的方法，jmethodID为Call<type>Method函数族使用

参数：

Name 方法在java类中的名字

Sig 类型签名

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);

表 3-5    Instance Method Calling Routines

Call<type>Method Routine Name

Native Type

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

 

 

调用java方法通过jmethodID指定

如果想要调用一个对象的父类方法，而不是子类的这个方法的话，就可以使用NativeTypeCallNonvirtual<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);

表 3-6  CallNonvirtual<type>Method Routines

CallNonvirtual <type>Method Routine Name

Native Type

CallNonvirtualVoidMethod()

CallNonvirtualVoidMethodA()

CallNonvirtualVoidMethodV()

void

 

CallNonvirtualObjectMethod()

CallNonvirtualObjectMethodA()

CallNonvirtualObjectMethodV()

jobject

 

CallNonvirtualBooleanMethod()

CallNonvirtualBooleanMethodA()

CallNonvirtualBooleanMethodV()

jboolean

 

CallNonvirtualByteMethod()

CallNonvirtualByteMethodA()

CallNonvirtualByteMethodV()

jbyte

 

CallNonvirtualCharMethod()

CallNonvirtualCharMethodA()

CallNonvirtualCharMethodV()

jchar

 

CallNonvirtualShortMethod()

CallNonvirtualShortMethodA()

CallNonvirtualShortMethodV()

jshort

 

CallNonvirtualIntMethod()

CallNonvirtualIntMethodA()

CallNonvirtualIntMethodV()

jint

 

CallNonvirtualLongMethod()

CallNonvirtualLongMethodA()

CallNonvirtualLongMethodV()

jlong

 

CallNonvirtualFloatMethod()

CallNonvirtualFloatMethodA()

CallNonvirtualFloatMethodV()

jfloat

 

CallNonvirtualDoubleMethod()

CallNonvirtualDoubleMethodA()

CallNonvirtualDoubleMethodV()

jdouble

 

例：

  1. package com.cn;
  2.  
  3. public class Father {
  4. public void function(){
  5. System.out.println("Father:function");
  6. }
  7. }

 

1.  package com.cn;

2.  public class Child extends Father {

3.  public void function() {

4.  System.out.println("Child:function");

5.  }

6.  }

 

  1. package com.cn;
  2. public class TestNativeCall {
  3. public native void testCall ();
  4. public Father p = new Child()；
  5. public static void main(String[] args) {
  6.  
  7. System.loadLibrary("nativeCode");//Java类 中加载DLL，然后调用声明的native方法
  8. TestNativeCall tst=new TestNativeCall ();
  9. tst.testCall ();
  10. }
  11. }

 

 

 

  1. void Java_Com_Cn_ testCall (JNIEnv *env, jobject obj){
  2.  
  3. jfieldID id_p = env->GetFieldID (clazz_TestNative,"p","Lcom/cn/Father;");
  4. jobject p = env->GetObjectField(obj,id_p);//取得属性
  5.  
  6. jclass clazz_Father = env->FindClass ("com/cn/Father");//找到Father类
  7. jmethodID id_Father_function = env->GetMethodID(clazz_Father,"function","()V");//获取Father类里面方法的ID
  8.  
  9. //调用方法，取得的是子类方法
  10. env->CallVoidMethod(p,id_Father_function);
  11.  
  12. //调用父类方法
  13. env->CallNonvirtualVoidMethod(p,clazz_Father,id_Father_function);
  14. }

 

Accessing Static Fields

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

GetStaticFieldID得到java类中static 属性ID，jfieldID为GetStatic<type>Field and SetStatic<type>Field函数族使用

参数：

clazz java类对象

name 方法在java类中的名字

sig  类型签名

 

GetStatic<type>Field Routines

NativeType GetStatic<type>Field(JNIEnv *env, jclass clazz,
jfieldID fieldID);

表 3-7 

GetStatic<type>Field Family of Accessor Routines

GetStatic<type>Field Routine Name

Native Type

GetStaticObjectField ()

jobject

GetStaticBooleanField ()

jboolean

GetStaticByteField ()

jbyte

GetStaticCharField ()

jchar

GetStaticShortField ()

jshort

GetStaticIntField ()

jint

GetStaticLongField ()

jlong

GetStaticFloatField ()

jfloat

GetStaticDoubleField ()

jdouble

 

获取java对象静态属性的值

 

SetStatic<type>Field Routines

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

 

表 3-8 

SetStatic<type>Field Family of Accessor Routines

SetStatic<type>Field Routine Name

Native Type

SetStaticObjectField ()

jobject

SetStaticBooleanField ()

jboolean

SetStaticByteField ()

jbyte

SetStaticCharField ()

jchar

SetStaticShortField ()

jshort

SetStaticIntField ()

jint

SetStaticLongField ()

jlong

SetStaticFloatField ()

jfloat

SetStaticDoubleField ()

jdouble

设置java对象静态属性的值

 

 

Calling Static Methods

GetStaticMethodID

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

 

GetStaticMethodID得到java类中static方法 ID，jmethodID为CallStatic<type>Method 函数使用

 

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);

 

 

表 3-9  CallStatic<type>Method Calling Routines

CallStatic <type>Method Routine Name

Native Type

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

 

 

String Operations

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

Array Operations

Registering Native Methods

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

 

typedef struct {

 

    char *name;

 

    char *signature;

 

    void *fnPtr;

 

} JNINativeMethod

 

Monitor Operations

jint MonitorEnter(JNIEnv *env, jobject obj);

jint MonitorExit(JNIEnv *env, jobject obj);

 

NIO Support

The NIO-related entry points allow native code to access java.nio direct buffers. The contents of a direct buffer can, potentially, reside in native memory outside of the ordinary garbage-collected heap. For information about direct buffers, please see New I/O APIs and the specification of the java.nio.ByteBuffer class.

Three new functions introduced in JDK/JRE 1.4 allow JNI code to create, examine, and manipulate direct buffers:

  • NewDirectByteBuffer
  • GetDirectBufferAddress
  • GetDirectBufferCapacity

Reflection Support

 

Java VM Interface

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

如何设置淘宝店铺背景 如何设置淘宝店铺背景
原创粉丝点击
热门IT博客
靠谱的网络征友靠谱的网络征友
linux输入命令linux输入命令
淘宝客广告词
阿里云企业邮箱免费吗
智能高清网络播放器
网络广告公司排名
郑州大学网络教学平台
知乎优缺点
算法的乐趣 完整版 pdf
手机装windows xp系统
mirror软件 app
java tag接口
现货交易软件开发
iphone7铃声制作软件
女排五连冠 知乎
xboxone好的软件
熊猫网络智能电视40
java设计模式pdf下载
中国大数据领军人物
淘宝图片切片工具
热门问题 老师的惩罚 人脸识别 我在镇武司摸鱼那些年 重生之率土为王 我在大康的咸鱼生活 盘龙之生命进化 天生仙种 凡人之先天五行 春回大明朝 姑娘不必设防，我是瞎子 漂组词多音字组词 漂多音字 漂组词多音字 漂的多音字组词 漂的多音字组词和拼音 漂的多音字组词和拼音怎么写 漂移轮 漂移板什么牌子的好 漂移板的正确踩法图片 新手练漂移板怎么起步 漂移板品牌 漂移板价格表 漂移板品牌排行 漂移板教程 漂移板内八外八图解 飘移板 漂移板好学吗 漂移板图片 漂移板教学 漂移板180 汽车漂移板教学 漂移板护具 鑫奥林漂移板 漂移板支架 漂移板t刹 freeline 名马 漂移之王 漂移教程 漂移教学 如何漂移 怎样漂移 汽车漂移原理 汽车怎么漂移 怎么汽车漂移 汽车怎样漂移 汽车漂移技巧 汽车如何漂移 汽车是怎么漂移的 汽车漂移教程 二手漂移车出售市场

程序博客网，程序员的互联网技术博客家园。csdn论坛精品 msdn技术资料都在这里