在Java中调用C/C++本地库

时间 2019-12-05

标签 java 调用 c++ 本地栏目 Java 繁體版

原文原文链接

JNI是Java Native Interface的英文缩写, 中文翻译为本地调用, 自从Java 1.1开始就成为了Java标准的一部分.html
 C/C++是系统级的编程语言, 能够用来开发任何和系统相关的程序和类库, 可是Java自己编写底层的应用比较难实现, 使用JNI能够调用现有的本地库, 极大地灵活了Java的开发.java
 C/C++的效率是目前最好的语言, 可使用C/C++来实现一些实时性很是高的部分. C/C++和Java自己都是很是流行的编程语言, 一些大型软件中常常使用语言之间的混合编程.linux
 鉴于目前网络上JNI的文章不是特别多, 我将本身的一些总结写在这里. 若有错漏, 欢迎指正!编程
 Java调用C/C++大概有这样几个步骤windows 
       
       编写带有native方法的Java类, 使用javac工具编译Java类 
       使用javah来生成与native方法对应的头文件 
       实现相应的头文件, 并编译为动态连接库(windows下是.dll, linux下是.so) 
      
 下面就完整的介绍一个简单的Java调用C/C++的例子, 这个例子是来自http://www.ibm.com/developerworks/cn/education/java/j-jni/index.html, 不过其中有一些错误, 这个文章是很是不错的JNI学习资料, 可是很是古老.数组
 编写Java类
 咱们来编写一个Sample1的java类bash 
       
        
         
          
           
            
             
             public class Sample1 {

    public native int intMethod(int n);

    public native boolean booleanMethod(boolean bool);

    public native String stringMethod(String text);

    public native int intArrayMethod(int[] intArray);

     

    public static void main(String[] args) {

        System.loadLibrary("Sample1");

        Sample1 sample = new Sample1();

        int square = sample.intMethod(5);

        boolean bool = sample.booleanMethod(true);

        String text = sample.stringMethod("Java");

        int sum = sample.intArrayMethod(new int[]{1,2,3,4,5,8,13});

         

        System.out.println("intMethod: " + square);

        System.out.println("booleanMethod: " + bool);

        System.out.println("stringMethod: " + text);

        System.out.println("intArrayMethod: " + sum);

    }

} 
             
           
  
          
         
        
      
 上面有4个native方法, 分别是4种类型的参数, int, boolean, String, int[].网络
 其中有一句比较重要, 这句话加载了动态类库编程语言
 System.loadLibrary("Sample1");函数
 在windows下加载的就是Sample1.dll, 在linux下加载的就是Sample1.so. 
 本文使用的windowws, 因此后面使用Sample1.dll来表示Sample1动态连接库.
 注意: 不能够在代码中写上后缀dll或so. 还要保证Sample1.dll在path路径中. 这个Sample1.dll是咱们后面须要编译出来的东西.
 4个native方法就是咱们须要用C来实现的方法.
 编译Sample1.java, 使用命令行(windows是cmd, linux下通常是bash)
 >javac Sample1.java
 能够看到Sample1.class文件
 使用javah生成头文件
 在命令行中运行
 >javah Sample1
 能够在目录下看到一个新文件Sample1.h

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

#include <jni.h>

/* Header for class Sample1 */

 

#ifndef _Included_Sample1

#define _Included_Sample1

#ifdef __cplusplus

extern "C" {

#endif

/*

 * Class:     Sample1

 * Method:    intMethod

 * Signature: (I)I

 */

JNIEXPORT jint JNICALL Java_Sample1_intMethod

  (JNIEnv *, jobject, jint);

 

/*

 * Class:     Sample1

 * Method:    booleanMethod

 * Signature: (Z)Z

 */

JNIEXPORT jboolean JNICALL Java_Sample1_booleanMethod

  (JNIEnv *, jobject, jboolean);

 

/*

 * Class:     Sample1

 * Method:    stringMethod

 * Signature: (Ljava/lang/String;)Ljava/lang/String;

 */

JNIEXPORT jstring JNICALL Java_Sample1_stringMethod

  (JNIEnv *, jobject, jstring);

 

/*

 * Class:     Sample1

 * Method:    intArrayMethod

 * Signature: ([I)I

 */

JNIEXPORT jint JNICALL Java_Sample1_intArrayMethod

  (JNIEnv *, jobject, jintArray);

 

#ifdef __cplusplus

}

#endif

#endif 
           
          
         
       
 咱们能够看到其中有四个函数声明, Java_完整类名_方法名, 完整类名包括了包名, 例如demo.Sample1是完整类名, 对应的这里就是demo_Sample1.
 在注释中咱们能够看到这样一个东西 Signature, 这个是方法的签名. 关于Signature, 下面经过一个表格来讲明. 
        
         
          
           
           java类型 
           Signature 
           备注 
           
           
           boolean 
           Z 
             
           
           
           byte 
           B 
             
           
           
           char 
           C 
             
           
           
           short 
           S 
             
           
           
           int 
           I 
             
           
           
           long 
           L 
             
           
           
           float 
           F 
             
           
           
           double 
           D 
             
           
           
           void 
           V 
             
           
           
           object 
           L用/分割的完整类名 
           例如: Ljava/lang/String表示String类型 
           
           
           Array 
           [签名 
           例如: [I表示int数组, [Ljava/lang/String表示String数组 
           
           
           Method 
           (参数签名)返回类型签名 
           例如: ([I)I表示参数类型为int数组, 返回int类型的方法 
           
          
         
       
 上面头文件的第一个函数声明
 JNIEXPORT jint JNICALL Java_Sample1_intMethod (JNIEnv *, jobject, jint);
 注释中的签名是 Signature: (I)I
 在每一个函数的参数列表中都有JNIEnv *和 jobject两个参数, 这两个参数稍候说明.
 实现头文件中的函数
 可使用C语言来实现, 也可使用C++来实现, 下面先说说C语言的实现.

#include "Sample1.h"

#include <string.h>

 

JNIEXPORT jint JNICALL Java_Sample1_intMethod

  (JNIEnv *env, jobject obj, jint num)

{

    return num * num;

}

 

JNIEXPORT jboolean JNICALL Java_Sample1_booleanMethod

  (JNIEnv *env, jobject obj, jboolean boolean)

{

    return !boolean;

}

 

JNIEXPORT jstring JNICALL Java_Sample1_stringMethod

  (JNIEnv *env, jobject obj, jstring string)

{

    const char* str = (*env)->GetStringUTFChars(env, string, 0);

    char cap[128];

    strcpy(cap, str);

    (*env)->ReleaseStringUTFChars(env, string, 0);

    return (*env)->NewStringUTF(env, strupr(cap));

}

 

JNIEXPORT jint JNICALL Java_Sample1_intArrayMethod

  (JNIEnv *env, jobject obj, jintArray array)

{

    int i, sum = 0;

    jsize len = (*env)->GetArrayLength(env, array);

    jint *body = (*env)->GetIntArrayElements(env, array, 0);

     

    for (i = 0; i < len; ++i)

    {

        sum += body[i];

    }

    (*env)->ReleaseIntArrayElements(env, array, body, 0);

    return sum;

}

(*env)->GetStringUTFChars()这个方法, 是用来在Java和C之间转换字符串的, 由于Java自己都使用了双字节的字符, 而C语言自己都是单字节的字符, 因此须要进行转换.

JNIEnv *是每一个函数都有的参数, 它包含了不少有用的方法, 使用起来相似Java的反射, 也提供了这样一个编码转换的函数.

GetStringUTFChars()和NewStringUTF(), 第一个是从UTF8转换为C的编码格式, 第二个是根据C的字符串返回一个UTF8字符串.

ReleaseStringUTFChars()是用来释放对象的, 在Java中有虚拟机进行垃圾回收, 可是在C语言中, 这些对象必须手动回收. 不然可能形成内存泄漏.

函数的名字一眼看到就能够猜出功能, jni.h中的大部分函数名都是这样.

若是是C++的话, 这段代码该怎么写?

下面是C++的代码

#include "Sample1.h"

#include <string.h>

 

JNIEXPORT jint JNICALL Java_Sample1_intMethod

  (JNIEnv *env, jobject obj, jint num)

{

    return num * num;

}

 

JNIEXPORT jboolean JNICALL Java_Sample1_booleanMethod

  (JNIEnv *env, jobject obj, jboolean boolean)

{

    return !boolean;

}

 

JNIEXPORT jstring JNICALL Java_Sample1_stringMethod

  (JNIEnv *env, jobject obj, jstring string)

{

    const char* str = env->GetStringUTFChars(string, 0);

    char cap[128];

    strcpy(cap, str);

    env->ReleaseStringUTFChars(string, 0);

    return env->NewStringUTF(strupr(cap));

}

 

JNIEXPORT jint JNICALL Java_Sample1_intArrayMethod

  (JNIEnv *env, jobject obj, jintArray array)

{

    int i, sum = 0;

    jsize len = env->GetArrayLength(array);

    jint *body = env->GetIntArrayElements(array, 0);

     

    for (i = 0; i < len; ++i)

    {

        sum += body[i];

    }

    env->ReleaseIntArrayElements(array, body, 0);

    return sum;

}

上述两端代码很是类似, 只有一个不一样点

C代码: (*env)->GetStringUTFChars(env, string, 0);

C++代码: env->GetStringUTFChars(string, 0);

C语言中使用的是结构体的函数指针, 而在C++中使用的仍是struct, 咱们知道struct在C++中和class的功能是几乎同样的, struct也能够用来定义类, 因此env在C++中是个类对象的指针.

编译和运行

这里使用的是微软编译器, 编译C语言版的dll

>cl -I%JAVA_HOME%\include -I%JAVA_HOME%\include\win32 -LD Sample1.c -FeSample1.dll

编译C++版本的dll

>cl -I%JAVA_HOME%\include -I%JAVA_HOME%\include\win32 -LD Sample1.cpp -FeSample1.dll

运行

>java Sample1

注意: 64位版本的JDK可能会在运行时报错:

java.lang.UnsatisfiedLinkError: ...Sample1.dll: Can't load IA 32-bit .dll on a AMD 64-bit platform

若是您有这样的错误, 请使用32位的JDK来从新运行.

运行结果以下:

 
          intMethod:  
          25 
         
          booleanMethod:  
          false 
         
          stringMethod: JAVA 
         
          intArrayMethod:  
          36

源代码下载: Sample1.zip

运行其中的build&run.bat文件便可, 若有错误请根据实际状况修改其中的一些参数.

DLL工程文件VC6.0和VS2010的: VC6.0&VS2010.zip

参考文献:

Scott Stricker, 用 JNI 进行 Java 编程, http://www.ibm.com/developerworks/cn/education/java/j-jni/section2.html
JDK 6u30 docs, Java Native Interface Specification, Chapter 3 JNI Types and Data Structures, Type Signatures.