Java如何调用C++编写的dll(动态连接库)


JNI的简单使用

以一个最简单的HelloWorld程序来介绍一下JNI的最基本的使用方法:

1)首先要有一个HelloWorld.java。
这个是主文件,里面包括本地方法的java声明,一个main函数,还有一个静态代码段,用来导入所需要的动态连接库(在Wndows里是.dll)。

代码如下:

//HelloWorld.java
class HelloWorld {
    public native void displayHelloWorld();//注意关键字native,这就说明这个方法是用本地方法实现的。

    static {//静态代码段里面导入了hello.dll。
        System.loadLibrary("hello");
    }
   
    public static void main(String[] args) {//调用本类的displayHelloWorld方法,(当然了方法实际上是用c语言实现的)
        new HelloWorld().displayHelloWorld();
    }
}

2)编译HelloWorld.java。

使用语句为:
javac HelloWorld.java


3)使用javah命令生成一个.h文件。

使用语句为:
javah HelloWorld

  这就是实现displayHelloWorld()方法的c文件的头文件。文件名为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 __cplusplus
extern "C" {
#endif
/*
 * Class:    HelloWorld
 * Method:    displayHelloWorld
 * Signature: ()V
 */
JNIEXPORT void JNICALL Java_HelloWorld_displayHelloWorld
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif
可以看到,这个文件里面主要就是需要在c文件里面实现的方法的方法声明。这个声明和java文件HelloWorld.java的有一点区别,原来的方法不带参数,可是现在有了两个参数。
这两个是任何一个本地方法都必须有的参数。
第一个参数是JNIEnv*,它用于连接从java应用程序传给你的本地方法的参数和对象。第二个参数是一个jobject,它指向当前对象本身,你也可以把它理解为java里面的this变量。对于一个本地实例方法,比如这个例子里的displayHelloWorld方法,jobject参数就是一个对象当前实例的引用。对于本地类的方法,这个参数就是一个方法类的引用。在这个例子里面不需要使用这两个参数。

另外一点,可以发现方法的名称和java文件里的不一致,这个方法名由以下几部分组成:
java_[包名+]类名_java方法名

4)编写实现本地方法的c文件
 //本例中起名为HelloWorldImp.c
#include <jni.h>
#include "HelloWorld.h"
#include <stdio.h>

JNIEXPORT void JNICALL 
Java_HelloWorld_displayHelloWorld(JNIEnv *env, jobject obj) 
{
    printf("Hello world!
");//这个例子中只输出一行Hello World!
    return;
}

5)建立动态连接库
    在Wndows下面使用下面的语句:
cl -Id:jdk1.3.1include -I d:jdk1.3.1includewin32  -LD HelloWorldImp.c -Fehello.dll
        这里面有几部分。D:jdk1.3.1是本地的java home的路径。在include和includewin32目录下面有产生动态连接库需要的几个.h文件,包括jni.h(在所有的实现native方法的c文件里面都要include这个文件)等等。
        将产生的.dll文件放到环境变量path能找到的目录下。现在运行命令:
        java HelloWorld
        就会看到如下输出:
        Hello World!

//**********************************************

编写高质量代码 改善Java程序的151个建议 PDF高清完整版

Java 8简明教程

Java对象初始化顺序的简单验证

Java对象值传递和对象传递的总结

Java对象序列化ObjectOutputStream和ObjectInputStream示例

还有, 以下载自《JAVA如何调用C/C++方法》--acute(原作)

JAVA通过JNI调用本地C语言方法

JAVA以其跨平台的特性深受人们喜爱,而又正由于它的跨平台的目的,使得它和本地机器的各种内部联系变得很少,约束了它的功能。解决JAVA对本地操作的一种方法就是JNI。

JAVA通过JNI调用本地方法,而本地方法是以库文件的形式存放的(在WINDOWS平台上是DLL文件形式,在UNIX机器上是SO文件形式)。通过调用本地的库文件的内部方法,使JAVA可以实现和本地机器的紧密联系,调用系统级的各接口方法。

简单介绍及应用如下:

一、JAVA中所需要做的工作

在JAVA程序中,首先需要在类中声明所调用的库名称,如下:

static {

      System.loadLibrary(“goodluck”);

}

在这里,库的扩展名字可以不用写出来,究竟是DLL还是SO,由系统自己判断。

还需要对将要调用的方法做本地声明,关键字为native。并且只需要声明,而不需要具体实现。如下:

public native static void set(int i);

public native static int get();

然后编译该JAVA程序文件,生成CLASS,再用JAVAH命令,JNI就会生成C/C++的头文件。

 例如程序testdll.java,内容为:

public class testdll

{

      static

      {

              System.loadLibrary("goodluck");

      }

       

      public native static int get();

      public native static void set(int i);

       

      public static void main(String[] args)

      {

              testdll test = new testdll();

              test.set(10);

              System.out.println(test.get());

      }

}

用javac testdll.java编译它,会生成testdll.class。

再用javah testdll,则会在当前目录下生成testdll.h文件,这个文件需要被C/C++程序调用来生成所需的库文件。

二、C/C++中所需要做的工作

对于已生成的.h头文件,C/C++所需要做的,就是把它的各个方法具体的实现。然后编译连接成库文件即可。再把库文件拷贝到JAVA程序的路径下面,就可以用JAVA调用C/C++所实现的功能了。

接上例子。我们先看一下testdll.h文件的内容:

/* DO NOT EDIT THIS FILE - it is machine generated */

#include <jni.h>

/* Header for class testdll */

 

#ifndef _Included_testdll

#define _Included_testdll

#ifdef __cplusplus

extern "C" {

#endif

/*

 * Class:    testdll

 * Method:    get

 * Signature: ()I

 */

JNIEXPORT jint JNICALL Java_testdll_get

  (JNIEnv *, jclass);

 

/*

 * Class:    testdll

 * Method:    set

 * Signature: (I)V

 */

JNIEXPORT void JNICALL Java_testdll_set

  (JNIEnv *, jclass, jint);

 

#ifdef __cplusplus

}

#endif

#endif

在具体实现的时候,我们只关心两个函数原型

JNIEXPORT jint JNICALL Java_testdll_get (JNIEnv *, jclass);

JNIEXPORT void JNICALL Java_testdll_set (JNIEnv *, jclass, jint);

这里JNIEXPORT和JNICALL都是JNI的关键字,表示此函数是要被JNI调用的。而jint是以JNI为中介使JAVA的int类型与本地的int沟通的一种类型,我们可以视而不见,就当做int使用。函数的名称是JAVA_再加上java程序的package路径再加函数名组成的。参数中,我们也只需要关心在JAVA程序中存在的参数,至于JNIEnv*和jclass我们一般没有必要去碰它。

好,下面我们用testdll.cpp文件具体实现这两个函数:

#include "testdll.h"

int i = 0;

JNIEXPORT jint JNICALL Java_testdll_get (JNIEnv *, jclass)

{

      return i;

}

JNIEXPORT void JNICALL Java_testdll_set (JNIEnv *, jclass, jint j)

{

      i = j;

}

编译连接成库文件,本例是在WINDOWS下做的,生成的是DLL文件。并且名称要与JAVA中需要调用的一致,这里就是goodluck.dll

把goodluck.dll拷贝到testdll.class的目录下,java testdll运行它,就可以观察到结果了。

另外:
使用Java直接调用VB编写的DLL是不行的,因为VB根本不能生成标准的DLL动态链接库,VB制作的DLL都是基于COM的动态链接库,而不是直接输出函数。

一般的做法使用C/C++对COM DLL进行二次封装,将其中的功能已C API的形式倒出。

相关内容