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复制到工程目录下;