如何通过JNI在Java中调用C库函数

使用Java语言进行开发时，可能由于处理速度、硬件控制或者复用既有的C/C++模块等方面的原因，需要Java层与使用C/C++编写的应用、模块或库进行交互，共同完成某些任务。在两者之间充当连接桥梁作用的就是Java本地接口（JNI，Java Native Interface）。本文通过一个小的例子，大致介绍下如何通过JNI在Java中调用C库函数的步骤。

 

开发环境

Windows XP / 7

JDK 1.6x

Microsoft Visual Studio 2010

 

1. 编写Java代码

 

写一个简单的Java类 - JNITest，并在该类中声明两个Native方法，接着在静态构造函数里调用System.loadLibrary()方法，加载具体实现本地方法的C运行库，源代码如下：

 

public class JNITest {
     native void printHello();
     native void printString(String str);
     
     static { System.loadLibrary("JNITest");}
     
     public static void main(String[] args) {
          JNITest myTest = new JNITest();
          myTest.printHello();
          myTest.printString("Hello, JNI's world!");
     }
}

 

2. 编译Java代码

 

在控制台里使用Java编译器(javac)编译步骤1中编写的Java源代码，生成.class文件：

> javac JNITest.java

 

3. 生成C语言头文件

 

运行Javah命令，生成C语言头文件，构建函数原型，以便C语言函数与Java代码中的本地方法映射在一起：

> javah JNITest

 

4. 编写C语言源代码

 

创建文件JNITest.c，编写源代码如下:

#include "JNITest.h"
#include <stdio.h>

JNIEXPORT void JNICALL Java_JNITest_printHello
  (JNIEnv *env, jobject obj)
  {
     printf("Hello World!\n");
     return;
  }
  
JNIEXPORT void JNICALL Java_JNITest_printString
  (JNIEnv *env, jobject obj, jstring string)
  {
     const char *str = (*env)->GetStringUTFChars(env, string, 0);
     printf("%s!\n", str);
     return;
  }

 

5. 生成C共享库

 

打开Visual Studio 2010 Command Prompt，输入如下编译命令，生成共享运行库JNTTest.dll：

> cl -I"C:\Program Files\Java\jdk1.7.0_06\include" -I"C:\Program Files\Java\jdk1.7.0_06\include\win32" -LD JNITest.c -FeJNITest.dll

6. 运行Java程序

 

执行java命令，运行JNTTest类，查看输出结果是否正常：

> java JNTTest

Hello World!
Hello, JNI's world!!