JNI学习笔记一

JNI: java native interface，java调用本地方法的接口。

什么时候使用JNI？

1. 已经存在其它语言编写好的库文件；

2. 操作系统底层的相关代码，或者访问硬件等操作；

3. 有一些对效率要求比较高的需求时。

使用JNI的弊端:

使用了java本地调用，通常会丧失跨平台的特性，因此，JNI尽量少用，除非万不得已。

写JNI的步骤：

1. 编写一个具有native方法的java类；

2. 编译生成该类的字节码文件，使用javah生成对应的本地方法头文件；

3. 使用C/C++实现本地方法；

4. 编译生成动态链接库。

一个小例子：

要求：在控制台输出一段“hello JNI”。

1. java类的实现

package com.zhangchao;

public class CreateJNIDemo {
	/**
	 * 声明本地方法
	 */
	public native void sayHelloJNI();
	
	/**
	 * 静态代码块，加载本地方法	
	 */
	static {
		System.loadLibrary("createjni");
	}
	
	public static void main(String[] args) {
		CreateJNIDemo cjd = new CreateJNIDemo();
		/**
		 * 调用本地方实现字符串的输出
		 */
		cjd.sayHelloJNI();
	}

}

2. 编译java类，生成对应的字节码文件；

CreateJNIDemo.class

3. 用javah生成头文件；

../bin> javah com.zhangchao.CreateJNIDemo

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_zhangchao_CreateJNIDemo */

#ifndef _Included_com_zhangchao_CreateJNIDemo
#define _Included_com_zhangchao_CreateJNIDemo
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_zhangchao_CreateJNIDemo
 * Method:    sayHelloJNI
 * Signature: ()V
 */
JNIEXPORT void JNICALL Java_com_zhangchao_CreateJNIDemo_sayHelloJNI
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif

4. 使用C/C++实现本地方法

4.1 对生成本地方法头文件修改

/* DO NOT EDIT THIS FILE - it is machine generated */
/*
需要将jni.h复制到工程目录下，同时修改引入头文件的方式为
#include <jni.h> ----> #include "jni.h"
需要将jni.h所包含的jni_md.h复制到工程目录下
*/
#include "jni.h"
/* Header for class com_zhangchao_CreateJNIDemo */

#ifndef _Included_com_zhangchao_CreateJNIDemo
#define _Included_com_zhangchao_CreateJNIDemo
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_zhangchao_CreateJNIDemo
 * Method:    sayHelloJNI
 * Signature: ()V
 */
JNIEXPORT void JNICALL Java_com_zhangchao_CreateJNIDemo_sayHelloJNI
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif

4.2 C++实现代码：

/*
添加头文件
*/
#include "com_zhangchao_CreateJNIDemo.h"
#include <iostream>
using namespace std;

JNIEXPORT void JNICALL Java_com_zhangchao_CreateJNIDemo_sayHelloJNI (JNIEnv *, jobject)
{
	cout << "hello JNI" << endl;
}

5. 将本地方法编译生成的动态链接库copy到java工程中。

完成以上几步后，一个简单的java调用本地方法的示例完成。这里有几个地方需要注意:

1. 在java类中加载本地方法

System.loadLibrary("createjni"); 不能写成“createjni.dll”.因为在不同平台对应的后缀名是不同的，所以不需要传入后缀，由jvm根据平台来添加相应的后缀即可；

2. C++实现中的头文件需要将jni.h已经jni.h所包含的jni_md.h复制到工程目录下；