JNA(Java Native Access)框架是一個開源的Java框架,是SUN公司主導開發的,建立在經典的JNI的基礎之上的一個框架。非常強大、易用,功能上類似與.NET的P/Invoke。
你只需要下載一個jar包,就可以使用JNA的強大功能方便地調用動態鏈接庫中的C函數。
下載jna.jar
JNA例子
例子1
1,在Java項目中引入jna.jar包。
2,創建一個類:
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
import
com.sun.jna.Library;
import
com.sun.jna.Native;
import
com.sun.jna.Platform;
public
class
HelloWorld {
public
interface
CLibrary
extends
Library {
CLibrary INSTANCE = (CLibrary)
Native.loadLibrary((Platform.isWindows() ?
"msvcrt"
:
"c"
),
CLibrary.
class
);
void
printf(String format, Object... args);
}
public
static
void
main(String[] args) {
CLibrary.INSTANCE.printf(
"Hello, World/n"
);
for
(
int
i=
0
;i < args.length;i++) {
CLibrary.INSTANCE.printf(
"Argument %d: %s/n"
, i, args[i]);
}
}
}
|
3,執行,可以看到控制台中打印出了
Hello, World
但是,請注意,這個程序實際上是使用msvcrt.dll這個C運行時庫中的printf函數打印出上面這些字符的。
例子2
上面那個例子使用了操作系統自帶的動態鏈接庫,現在我們再自己寫一個動態鏈接庫試試。
1,在VS中選擇C++語言,然后選擇創建一個Win32程序。 選擇dll類型。
2,發布的C函數是:
#define MYLIBAPI extern "C" __declspec( dllexport )
MYLIBAPI void say(wchar_t* pValue);
這個函數的實現是:
void say(wchar_t* pValue){
std::wcout.imbue(std::locale("chs"));
std::wcout<<L"上帝說:"<<pValue<<std::endl;
}
它需要傳入一個Unicode編碼的字符數組。然后在控制台上打印出一段中文字符。
3,生成dll。然后把生成的dll文件復制到Eclipse項目中,放在項目下面。
4,編寫以下代碼:
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
import
com.sun.jna.Library;
import
com.sun.jna.Native;
import
com.sun.jna.WString;
public
class
TestDll1Service {
public
interface
TestDll1
extends
Library {
TestDll1 INSTANCE = (TestDll1)Native.loadLibrary(
"TestDll1"
, TestDll1.
class
);
public
void
say(WString value);
}
public
TestDll1Service() {
// TODO Auto-generated constructor stub
}
public
static
void
main(String[] args) {
// TODO Auto-generated method stub
TestDll1.INSTANCE.say(
new
WString(
"Hello World!"
));
System.out.println(
"HHEEH我我們無法萬惡"
);
}
}
|
5,執行這個Java類。可以看到控制台下如下輸出:
上帝說:Hello World!
HHEEH我我們無法萬惡
6,上面一行是C語言使用C++的std::wcout輸出的。
下面一行是Java語言輸出的。
JNA工作原理
JNA是建立在JNI技術基礎之上的一個Java類庫,它使您可以方便地使用java直接訪問動態鏈接庫中的函數。
原來使用JNI,你必須手工用C寫一個動態鏈接庫,在C語言中映射Java的數據類型。
JNA中,它提供了一個動態的C語言編寫的轉發器,可以自動實現Java和C的數據類型映射。你不再需要編寫C動態鏈接庫。
當然,這也意味着,使用JNA技術比使用JNI技術調用動態鏈接庫會有些微的性能損失。可能速度會降低幾倍。但影響不大。
JNA技術難點
1,當前路徑是在項目下,而不是bin輸出目錄下。
2,數據結構的對應關系:參見官方網站
JNA編程過程
JNA把一個dll/.so文件看做是一個Java接口。
Dll是C函數的集合、容器,這正和接口的概念吻合。
我們定義這樣一個接口,
public interface TestDll1 extends Library {
TestDll1 INSTANCE = (TestDll1)Native.loadLibrary("TestDll1", TestDll1.class);
public void say(WString value);
}
如果dll是以stdcall方式輸出函數,那么就繼承StdCallLibrary。否則就繼承默認的Library接口。
接口內部需要一個公共靜態常量:instance。
TestDll1 INSTANCE = (TestDll1)Native.loadLibrary("TestDll1", TestDll1.class);
通過這個常量,就可以獲得這個接口的實例,從而使用接口的方法。也就是調用外部dll的函數!
注意:
1,Native.loadLibrary()函數有2個參數:
A,dll或者.so文件的名字,但不帶后綴名。這符合JNI的規范,因為帶了后綴名就不可以跨操作系統平台了。
搜索dll的路徑是:
1)項目的根路徑
2)操作系統的全局路徑、
3)path指定的路徑。
B,第二個參數是本接口的Class類型。
JNA通過這個Class類型,根據指定的dll/.so文件,動態創建接口的實例。
2,接口中你只需要定義你需要的函數或者公共變量,不需要的可以不定義。
public void say(WString value);
參數和返回值的類型,應該和dll中的C函數的類型一致。
這是JNA,甚至所有跨平台調用的難點。
這里,C語言的函數參數是:wchar_t*。JNA中對應的Java類型是WStirng。
JNA的不足
JNA是建立在JNI技術基礎之上的一個框架。使用JNI技術,不僅可以實現Java訪問C函數,也可以實現C語言調用Java代碼。而JNA只能實現Java訪問C函數,作為一個Java框架,自然不能實現C語言調用Java代碼。此時,你還是需要使用JNI技術。
參考文獻:
http://blog.csdn.net/shendl/archive/2008/12/23/3589676.aspx
https://jna.dev.java.net/
