热门问题
时间线
聊天
视角

Java Native Access

来自维基百科,自由的百科全书

Remove ads

Java Native Access (JNA) 是一個由社區開發的庫,它使Java程序無需使用Java Native Interface即可輕鬆訪問本地共享庫。JNA的設計旨在以最少的努力以原生的方式提供本地訪問,且不需要樣板代碼膠水代碼

事实速览 原作者, 首次發布 ...
Remove ads

結構

JNA庫使用一個稱為外部函數接口庫(libffi英語libffi)的小型本機庫來動態調用本機代碼。JNA庫使用本地函數,允許代碼按名稱加載庫並檢索指向該庫中函數的指針,使用libffi庫來調用它,而無需靜態綁定,頭文件或任何編譯。開發人員使用Java interface描述目標本機庫中的函數和結構(struct)。這使得利用平台功能非常容易,而避免了配置或構建JNI的高開銷。

JNA支持在macOS,Microsoft Windows,FreeBSD / OpenBSD,Solaris,GNU/Linux,AIX,Windows Mobile和Android上構建和測試。經過適當調整和重編譯,可以使其在大多數能夠運行Java的平台上運行。

類型對應

這個表格顯示了JNA所支持的類型與java類型,Windows通用類型的對應關係.[2]

更多信息 C類型, 大小 ...

注意:根據一些預處理器指令和不同的實現,TCHAR可能為char或wchar_t。LPCTSTR也是一樣的。

Remove ads

數據結構的內存字節對齊

JNA沒有規定內存字節的對齊方式。JNA默認為遵循OS平台的設置,但也可以自定義對齊方式。如果本機庫的文檔中未提供關於內存對齊的詳細信息,則必須通過反覆試驗確定正確的對齊方式。

示例

下面這個例子展示了JNA如何加載C標準庫並使用其中的printf函數。

注意: 這個例子是跨平台的,這意味着它可以在 Windows / GNU+Linux / Unix / macOS 運行,並得到完全相同的結果。

import com.sun.jna.Library;
import com.sun.jna.Native;
import com.sun.jna.Platform;

/** 这个例子展示了JNA的一个用法 */
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]);
        }
    }
}

下面這個例子使用了C POSIX庫並調用其中的mkdir函數。

注意: 這個例子在POSIX兼容的系統中是跨平台的,這意味着它可以在所有POSIX兼容系統中運行並獲得相同結果,但它無法在大多數Windows系統上運行。

import com.sun.jna.Library;
import com.sun.jna.Native;

/** Simple example of native C POSIX library declaration and usage. */
public class ExampleOfPOSIX {
    public interface POSIX extends Library {
	    public int chmod(String filename, int mode);
	    public int chown(String filename, int user, int group);
	    public int rename(String oldpath, String newpath);
	    public int kill(int pid, int signal);
	    public int link(String oldpath, String newpath);
	    public int mkdir(String path, int mode);
	    public int rmdir(String path);
    }

    public static void main(String[] args) {
        POSIX posix = (POSIX) Native.loadLibrary("c", POSIX.class);
	    posix.mkdir("/tmp/newdir", 0777);
	    posix.rename("/tmp/newdir","/tmp/renamedir");
    }
}

下面這個例子加載了Kernel32.dll並調用了其中的Beep和Sleep函數。

注意: 這個例子只能在Windows下運行。

import com.sun.jna.Library;
import com.sun.jna.Native;

/** 这是JNA调用Windows dll的一个例子 */
public class BeepExample {
    public interface Kernel32 extends Library {
        // FREQUENCY可以为 37 和 32767间任意一整数
        // DURATION 的单位为毫秒
        public boolean Beep(int FREQUENCY, int DURATION);
        public void Sleep(int DURATION);
    }

    public static void main(String[] args) {
	    Kernel32 lib = (Kernel32) Native.loadLibrary("kernel32", Kernel32.class);
	    lib.Beep(698, 500);
	    lib.Sleep(500);
	    lib.Beep(698, 500);
    }
}
Remove ads

用處

JNA被用於下列項目中:

  • Armed Bear Common Lisp, 使用JNA實現CFFI。[3]
  • JRuby,使用JNA實現 POSIX 相關功能。[4][5]
  • Freedom for Media in Java (FMJ)。[6]
  • JetBrainsIntelliJ IDEA
  • OpenSearchServer,一個開源搜索引擎。
  • SVNKit, 一個純Java的Java Subversion client庫 ,通過JNA實現相關功能。
  • VLC media player, 在vlcj庫中使用。[7]
  • Cyberduck 適用於FTP, SFTP, WebDAV, Cloud Files & Amazon S3的瀏覽器。
  • Log4j,附加日誌庫。[8]
  • Hudson 和· Jenkins,持續集成服務器。
  • Webdriver
  • YAJSW (Yet Another Java Service Wrapper)。
  • Cassandra, 來自 Apache Software Foundation 的開源分布數據庫,使用JNA。[9]
Remove ads

另見

參考鏈接

外部連結

Loading related searches...

Wikiwand - on

Seamless Wikipedia browsing. On steroids.

Remove ads