JNI_最简单的Java调用C/C++代码
JNI,是Java Native Interface的简称,中文是“Java本地调用”。通过这种技术可以做到以下两点:
- Java程序中的函数可以调用Native语言写的函数,Native一般指的是C/C++编写的函数。
- Native程序中的函数可以调用Java层的函数,也就是说在C/C++程序中可以调用Java的函数。
本篇博客带给童鞋们以下内容,学习内容来自(传智播客),经由小巫总结整理:
- javah工具的用法
- 按照C/C++头文件来编写C/C++源文件
- 将C/C++源文件编译成动态连接库(DLL)
- 在Java程序中引入动态连接库等知识
JNI并不是什么特别神奇的东西,当初SUN推出它的目的是为了屏蔽不同操作系统平台的差异性,通过Java语言来调用Native语言的功能模块,避免重复制作车轮,最主要是这两个目的。
最简单的Java调用C/C++代码,有以下步骤,童鞋们最好详细阅读,避免出现相应的错误:
- 首先在Java类中声明一个native的方法
- 使用Javah命令生成native方法的声明的C/C++头文件
- 按照生成的C/C++头文件来编写C/C++源文件
- 将C/C++源文件编译成动态链接库(DLL)
- 将DLL文件加入到PATH环境变量下
- Java类中加载DLL,然后调用声明方法
我们现在一步一步把整个流程熟悉一遍,在Eclipse中创建一个Java项目:
笔者创建了一个命为:TestNativeCode的项目,新建包名为com.wwj.nativecode,新建类为TestNativeCode
接着在TestNativeCode类当中声明我们的本地方法:
- package com.wwj.nativecode;
- public class TestNativeCode {
- // 声明本地方法
- public native void sayHello();
- public static void main(String[] args) {
- // // 加载动态链接库
- // System.loadLibrary("nativeCode");
- // TestNativeCode nativeCode = new TestNativeCode();
- // nativeCode.sayHello();
- }
- }
注释掉的代码后面很快会用到,暂时不用管。
我们声明了本地方法之后,就可以用jdk中javah命令来为我们生成对应的头文件,在命令可以敲入javah -help:
会显示出javah命令的一些使用参数和意义。
找到我们Java项目TestNativeCode的路径:笔者这里是D:\workspace\TestNativeCode
我们进入bin目录,就可以找到对应的字节码文件:
我们用这个来生成我们所需要的.h文件:
格式为:javah 包名.文件名
生成成功后,我们可以在当前路径下生成的.h文件:
以上的步骤已经很清楚的介绍如何使用javah命令生成native头文件。受用编辑器打开头文件,有以下代码:
- /* DO NOT EDIT THIS FILE - it is machine generated */
- #include <jni.h>
- /* Header for class com_wwj_nativecode_TestNativeCode */
- #ifndef _Included_com_wwj_nativecode_TestNativeCode
- #define _Included_com_wwj_nativecode_TestNativeCode
- #ifdef __cplusplus
- extern "C" {
- #endif
- /*
- * Class: com_wwj_nativecode_TestNativeCode
- * Method: sayHello
- * Signature: ()V
- */
- JNIEXPORT void JNICALL Java_com_wwj_nativecode_TestNativeCode_sayHello
- (JNIEnv *, jobject);
- #ifdef __cplusplus
- }
- #endif
- #endif
接着在Visual studio中创建一个win32控制台应用程序,取名为nativeCode:
创建成功后,将我们生成的头文件剪切到C++项目中,并在项目中引入:
新建源文件:source.cpp
根据头文件来编写源文件:
我们发现代码中有错,原因是我们没有引入“jni.h"头文件,jni.h头文件是在我们的jdk目录下,include文件夹下:
把jni.h复制到项目中去,运行项目发现如下错误:
1>------ 已启动生成: 项目: nativeCode, 配置: Debug Win32 ------
1> source.cpp
1>c:\users\administrator\documents\visual studio 2012\projects\nativecode\nativecode\jni.h(45): fatal error C1083: 无法打开包括文件:“jni_md.h”: No such file or directory
========== 生成: 成功 0 个,失败 1 个,最新 0 个,跳过 0 个 ==========
1> source.cpp
1>c:\users\administrator\documents\visual studio 2012\projects\nativecode\nativecode\jni.h(45): fatal error C1083: 无法打开包括文件:“jni_md.h”: No such file or directory
========== 生成: 成功 0 个,失败 1 个,最新 0 个,跳过 0 个 ==========
还是缺少头文件了,jni_md.h也是在jdk中:
同样把它添加到项目中去:
现在代码已经没有错误提示了,运行成功之后会生成我们需要的DLL文件,在对应的Debug目录下可以找到:
接着把这个动态库添加到PATH环境变量中去,笔者的路径为(C:\Users\Administrator\Documents\visual studio 2012\Projects\nativeCode\Debug):
最后在Eclipse中使用Java调用我们的Native代码:
- package com.wwj.nativecode;
- public class TestNativeCode {
- // 声明本地方法
- public native void sayHello();
- public static void main(String[] args) {
- // 加载动态链接库
- System.loadLibrary("nativeCode");
- TestNativeCode nativeCode = new TestNativeCode();
- nativeCode.sayHello();
- }
- }
注意: system.loadLibrary("path") 其中path 不能后缀dll
运行java项目,如果声明了环境变量之后,没有重启Eclipse会报这样的错:
这时我们重启一下Eclipse让环境变量生效即可。
但最后调用的时候出现了这个错误,小巫暂未解决:
望路过的大神,给你解决方案,动态库是加载成功了,但调用方法是时候出现错误了。
2014/9/10 博文更新
很抱歉隔了这么久才来更新这篇博客,小巫之前的这个错误已经解决掉了,为什么会出现链接错误呢,主要还是链接库的问题。
我们创建的VS项目,是Win32的平台,而小巫的操作系统是64位的,所以我在Eclipse加载链接库的时候会报错。那么如何来解决这个问题呢,我们需要配置VS编译的平台,我们需要配置为x64位。
配置完之后,重新编译运行,在项目根目录会生成x64的目录
VS2012中还需要配置 否则不能生成X64平台下的dll
项目->属性->常规->配置类型 选择为dll
方法一:
然后将生成的dll文件拷贝至jdk/bin中,再在eclipse中执行即可
VS2012 中编辑代码
注意: system.loadLibrary("path") 其中path 不能后缀dll
eclipse中执行程序输出结果
方法二:
然后我们把使用x64平台生成的动态链接库配置到环境变量中去:
我的路径是:C:\Users\Administrator\Documents\visual studio 2012\Projects\nativeCode\x64\Debug
接着我们重启Eclipse,运行我们的测试项目,这个时候就没有错误了。
注意: system.loadLibrary("path") 其中path 不能后缀dll
版权声明:本文为博主原创文章,未经博主允许不得转载。
注意: system.loadLibrary("path") 其中path 不能后缀dll
注意: system.loadLibrary("path") 其中path 不能后缀dll