寫在最前面

Java中呼叫C庫函式，依賴JNI，本文使用一個非常簡單的例子來說明JNI開發流程，具體步驟如下：

第一步：編寫Java程式碼

第二步：編譯Java程式碼

第三步：生成C語言標頭檔案

第四步：編寫C程式碼

第五步：生成C共享庫

第六步：執行Java程式

注：本文中將僅在Java程式碼中宣告的方法稱為本地方法，使用C/C++實現的函式稱為本地函式。

第一步：編寫Java程式碼

若想在Java程式碼中通過JNI呼叫C函式，首先在Java類中宣告本地方法，本地方法僅在Java程式中進行宣告，使用C/C++等本地語言來實現。

如下程式碼HelloJNI.java

1 class HelloJNI
  2 {
  3     // 本地方法宣告
  4     native void printHello();
  5     native void printString(String str);
  6 
  7     // 載入庫
  8     static{ System.loadLibrary("hello"); }
  9 
 10     public static void main(String args[])
 11     {
 12         HelloJNI myJNI = new HelloJNI();
 13 
 14         // 呼叫本地方法（實際呼叫的事使用C語言編寫的JNI本地函式）
 15         myJNI.printHello();
 16         myJNI.printString("Hello World from printString fun");
 17     }
 18 }
 

如下，不同平臺下System.loadLibrary()方法載入的C執行庫

第二步：編譯Java程式碼

使用Java編譯器（javac），編譯Java原始碼，命令如下

javac HelloJNI.java

第三步：生成C語言標頭檔案

使用javah命令生成C語言標頭檔案，命令如下

javah HelloJNI

 1 /* DO NOT EDIT THIS FILE - it is machine generated */
  2 #include <jni.h>
  3 /* Header for class HelloJNI */
  4 
  5 #ifndef _Included_HelloJNI
  6 #define _Included_HelloJNI
  7 #ifdef __cplusplus
  8 extern "C" {
  9 #endif
 10 /*
 11  * Class:     HelloJNI
 12  * Method:    printHello
 13  * Signature: ()V
 14  */
 15 JNIEXPORT void JNICALL Java_HelloJNI_printHello
 16   (JNIEnv *, jobject);
 17 
 18 /*
 19  * Class:     HelloJNI
 20  * Method:    printString
 21  * Signature: (Ljava/lang/String;)V
 22  */
 23 JNIEXPORT void JNICALL Java_HelloJNI_printString
 24   (JNIEnv *, jobject, jstring);
 25 
 26 #ifdef __cplusplus
 27 }
 28 #endif
 29 #endif
 

第四步：編寫C程式碼

在C函式原型檔案生成後，開始編寫C程式碼，HelloJNI.c，如下

1 #include "HelloJNI.h"
  2 #include <stdio.h>
  3 
  4 JNIEXPORT void JNICALL Java_HelloJNI_printHello(JNIEnv *env, jobject object)
  5 {
  6     printf("Hello World!\n");
  7     return;
  8 }
  9 
 10 JNIEXPORT void JNICALL Java_HelloJNI_printString(JNIEnv *env, jobject object, jstring string)
 11 {
 12     // 將 Java String轉換為C字串
 13     const char *str = (*env)->GetStringUTFChars(env,string,0);
 14     printf("%s!\n", str);
 15 
 16     return;
 17 }

第五步：生成C共享庫

mac環境下使用如下命令生成動態連結庫

gcc -dynamiclib -I /Library/Java/JavaVirtualMachines/jdk1.8.0_40.jdk/Contents/Home/include/ HelloJNI.c -o libHelloJNI.jnilib

In file included from HelloWorldImpl.c:1:
/Library/Java/JavaVirtualMachines/jdk1.8.0_40.jdk/Contents/Home/include/jni.h:45:10: fatal error:
      'jni_md.h' file not found
#include "jni_md.h"
         ^
1 error generated.

sudo cp /Library/Java/JavaVirtualMachines/jdk1.8.0_40.jdk/Contents/Home/include/darwin/jni_md.h /Library/Java/JavaVirtualMachines/jdk1.8.0_40.jdk/Contents/Home/include

然後再執行生成動態庫的命令即可。

第六步：執行Java程式

最後執行java程式，如下命令

java HelloJNI

Hello World!
Hello World from printString fun!

總結

通過以上步驟，我們知道了Java本地方法如何通過JNI連結到C函式，以及具體實現等

最後，做個小結，梳理一下

（1）在Java類中宣告本地方法

（2）使用javah命令，生成包含JNI本地函式原型的標頭檔案

（3）實現JNI本地函式

（4）生成C共享庫

（5）通過JNI，呼叫JNI的本地函式