JNA使用入門

jackieathome發表於2024-08-09

JNA即Java Native Access。

  • 官方主頁
  • 程式碼倉庫
  • 官方樣例
  • maven中心倉庫主頁

官方文件

  • Getting Started
  • Functional Description.
  • Mapping between Java and Native
  • Using Pointers and Arrays
  • Using Structures and Unions
  • Using By-Reference Arguments
  • Customization of Type Mapping
  • Callbacks/Function Pointers/Closures
  • Dynamically Typed Languages (JRuby/Jython)
  • Platform Library
  • Direct Method Mapping (Optimization)
  • Frequently Asked Questions (FAQ)
  • Avoiding Crashes

使用樣例

準備Java程式碼檔案，內容來源於Getting Started，如下：

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

/** Simple example of JNA interface mapping and usage. */
public class HelloWorld {

    // This is the standard, stable way of mapping, which supports extensive
    // customization and mapping of Java to native types.

    public interface CLibrary extends Library {
        CLibrary INSTANCE = (CLibrary)
            Native.load((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]);
        }
    }
}

修改專案的pom.xml，增加如下依賴：

<!-- https://mvnrepository.com/artifact/net.java.dev.jna/jna -->
<dependency>
    <groupId>net.java.dev.jna</groupId>
    <artifactId>jna</artifactId>
    <version>5.14.0</version>
</dependency>

等待依賴下載完畢，構建完畢，執行前述樣例程式碼。

從原始碼構建JNA

  • Setting up a Windows Development Environment
    在Windows環境執行構建，執行如下命令：
    cd C:\Code\jna

set JAVA_HOME=C:\Tools\jdk
set ANT_HOME=C:\Tools\ant
set CYGWIN_HOME=C:\Tools\cygwin64

set PATH=%JAVA_HOME%\bin;%ANT_HOME%\bin;%CYGWIN_HOME%\bin;%PATH%

"C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" x64

ant
    在Linux環境執行構建，執行如下命令：
    cd /path/to/jna_code

export JAVA_HOME=/path/to/jdk
export ANT_HOME=/path/to/ant
export PATH=$JAVA_HOME/bin:$ANT_HOME/bin:$PATH
ant
  • Android Development Environment
    在Linux環境執行構建，執行如下命令：
    
cd /path/to/jna_code

export JAVA_HOME=/path/to/jdk
export ANT_HOME=/path/to/ant
export PATH=$JAVA_HOME/bin:$ANT_HOME/bin:$PATH

export NDK_PLATFORM=/path/to/android-ndk-r12b/platforms/android-21
export PATH=$NDK_PLATFORM/../../toolchains/aarch64-linux-android-4.9/prebuilt/linux-x86_64/bin/:$PATH
ant -Dos.prefix=android-aarch64

參考資料

  • JNA Examples
    可以覆蓋日常開發過程中大部分的應用場景。
  • JNA實現JAVA呼叫C/C++動態庫
  • JNA介紹
  • SpringBoot整合JNA呼叫動態庫
  • Java 之 JNA(呼叫第三方庫)
  • JNA學習（一）C++ 類庫(Dll)建立及呼叫
  • java高階用法之:呼叫本地方法的利器JNA
  • JNA （Java 本地訪問）理論概述與入門
  • JNA介紹以及簡單使用
  • java高階用法之:在JNA中使用型別對映
  • Java呼叫第三方庫JNA(C/C++)
  • JNI便捷開發框架JNA框架之入門（一）
  • JNI，JNA使用總結
  • 記一次JNA踩坑歷程 -- JNA呼叫DLL
  • 【Hotspot】 JNI/JNA呼叫、Native呼叫
  • JNA——模擬c++中類及成員
  • JNI，JNA，jawin，jacob和Jcom之間的區別是什麼，它們的呼叫效率怎麼排名？
  • Java 外部函式介面：JNI, JNA, JNR
  • JNA簡介及使用
  • Java——本地方法（JNA）詳解
  • Java 之 JNA(呼叫第三方庫)
  • Java使用jna呼叫c++動態庫（Linux）

相關文章