首页 > 代码库 > JNI技术基础(2)——从零开始编写JNI代码

JNI技术基础(2)——从零开始编写JNI代码

 

书接上文: 《JNI技术基础(1)——从零开始编写JNI代码》

 

2.编译源程序HelloWorld.java并生成HelloWorld.class

 

3.生成头文件HelloWorld.h

     在Linux控制台输入命令:javah –jni HelloWorld 生成HelloWorld.h头文件

//HelloWorld.h/* DO NOT EDIT THIS FILE - it is machine generated */#include <jni.h>/* Header for class HelloWorld */#ifndef _Included_HelloWorld#define _Included_HelloWorld#ifdef __cplusplusextern "C" {#endif/* * Class:     HelloWorld * Method:    print * Signature: ()V */JNIEXPORT void JNICALL Java_HelloWorld_print  (JNIEnv *, jobject);#ifdef __cplusplus}#endif#endif

       这个头文件中便告诉了我们需要用C/C++实现的函数的原型,即

              JNIEXPORT void JNICALL Java_HelloWorld_print ( JNIEnv * env, jobject obj)

       我们只需要按照这种格式完成其函数体的实现即可,函数名的格式:

              Java_类名_函数名

       参数env代表java虚拟机环境,Java传过来的参数和c有很大的不同,需要调用JVM提供的接口来转换成C类型的,就是通过调用env方法来完成转换的。
       参数obj代表调用的对象,相当于c++的this。当c函数需要改变调用对象成员变量时,可以通过操作这个对象来完成。


4.实现C/C++函数

       这块儿有点偷懒,并没有逐个字母去敲,而是通过拷贝头文件的方法,然后删除头文件中的无用信息,填充函数体的方法来创建HelloWorld.c文件,主要是因为JNI函数名都比较复杂,害怕疏忽敲错某个字符,或者少实现了某个函数,见谅。

//HelloWorld.c#include <jni.h>#include <stdio.h>#include "HelloWorld.h"/* * Class:     HelloWorld * Method:    print * Signature: ()V */JNIEXPORT void JNICALL Java_HelloWorld_print (JNIEnv *, jobject){    printf("Hello World!\n");}

由上面可以看出,函数体的实现和普通的C/C++函数完全相同,不同的只是函数原型的格式。
需要注意的一点就是记得添加2个头文件:jni.h和HelloWorld.h 。

 

5.编译生成库文件

        gcc  -I/usr/lib/jvm/java-1.5.0-sun-1.5.0.22/include/linux/
                -I/usr/lib/jvm/java-1.5.0-sun-1.5.0.22/include/
                -fPIC  -shared  -o libHelloWorld.so  HelloWorld.c
       在编译的时候需要注意的就是记得加上java的两个路径,该路径根据你的java环境的实际安装路径而设置,其余的和编译普通的动态库方法相同。

第一个红色方框中圈出了我们经常范的一个错误,就是没有填写JNI函数的两个形参,虽然我们这里用不到它们,但是也必须写上,否则无法通过编译。

//HelloWorld.c#include <jni.h>#include <stdio.h>#include "HelloWorld.h"/* * Class:     HelloWorld * Method:    print * Signature: ()V */JNIEXPORT void JNICALL Java_HelloWorld_print (JNIEnv *env, jobject obj){    printf("Hello World!\n");}

  

6.运行Java程序

方框圈出了两个经常范的错误,第一个错误产生的原因是找不到刚刚生成的C/C++动态库,需要手动指定库的路径,当然也可以把该库拷贝到系统库文件目录中。

手动指定动态库路径的方法是使用参数 -Djava.library.path

        java –Djava.library.path = "."  HelloWorld

第二个错误产生的原因是使用参数时,"="的前面或者后面使用了空格,去掉等号前后的空格即可。

 

OK,大功告成,终于看到久违的HelloWorld!

 

7.附录:一个简单的例程

<1>. MyTools.java

//MyTools.javaclass MyTools{    private native int myAdd(int x, int y);    private native int mySub(int x, int y);    public static void main(String[] args){        int a = 5;        int b = 7;        int c = new MyTools().myAdd(a, b);        int d = new MyTools().mySub(a, b);        System.out.println(a + " + " + b + " = " + c);        System.out.println(a + " - " + b + " = " + d);    }    static{        System.loadLibrary("MyTools");    }}

  

<2>. 自动生成MyTools.h头文件

//MyTools.h/* DO NOT EDIT THIS FILE - it is machine generated */#include <jni.h>/* Header for class MyTools */#ifndef _Included_MyTools#define _Included_MyTools#ifdef __cplusplusextern "C" {#endif/* * Class:     MyTools * Method:    myAdd * Signature: (II)I */JNIEXPORT jint JNICALL Java_MyTools_myAdd  (JNIEnv *, jobject, jint, jint);/* * Class:     MyTools * Method:    mySub * Signature: (II)I */JNIEXPORT jint JNICALL Java_MyTools_mySub  (JNIEnv *, jobject, jint, jint);#ifdef __cplusplus}#endif#endif

  

<3>. 函数体的C/C++实现myTools.c

//MyTools.c#include <jni.h>#include "MyTools.h"/* * Class:     MyTools * Method:    myAdd * Signature: (II)I */JNIEXPORT jint JNICALL Java_MyTools_myAdd (JNIEnv *env, jobject obj, jint x, jint y){    return (x + y);}/* * Class:     MyTools * Method:    mySub * Signature: (II)I */JNIEXPORT jint JNICALL Java_MyTools_mySub (JNIEnv *env, jobject obj, jint x, jint y){    return (x - y);}

运行结果:

 

说明:

     1.大多数情况下,JNI都是在Android开发中使用,本文的目的是使用最简单的语言描述出JNI最基本、最简单的使用流程,所以并没有使用Android框架,Android框架中的一大堆东西会阻挡我们的视线,无法专注于对JNI本身的了解,而Android下JNI的使用流程和Java是基本相同的,后面会有专门的篇幅介绍Android下JNI编程。
     2.此处实现了使用JNI传递简单的参数x和y。

     3.通过上面两个例子,相信大家已经可以写出自己的简单的 JNI 应用,但是整个 JNI 系统相当复杂,尤其是参数和返回值的传递方面,后面会有专门篇幅详细介绍。

 

< end >

 

 

JNI技术基础(2)——从零开始编写JNI代码