HawtJNI 技术文档

1. 安装指南

1.1 环境要求

• Java 开发环境（JDK）
• Maven 构建工具

1.2 安装步骤

1. 下载并安装 JDK：确保你的系统上已经安装了 JDK，并且配置了 JAVA_HOME 环境变量。
2. 安装 Maven：如果你还没有安装 Maven，可以从 Maven 官方网站 下载并安装。
3. 添加 HawtJNI 依赖：在你的 Maven 项目中，添加以下依赖到 pom.xml 文件中：

<dependency>
    <groupId>org.fusesource.hawtjni</groupId>
    <artifactId>hawtjni-runtime</artifactId>
    <version>1.17</version>
</dependency>

4. 编译项目：在项目根目录下运行以下命令来编译项目：

mvn clean install

2. 项目的使用说明

2.1 定义 JNI 方法

在你的 Java 类中，使用 @JniClass 注解来标记类，并定义静态的 native 方法。例如：

@JniClass
public class Platform {
    public static native long open(String file, int flags, int mode);
}

2.2 加载本地库

你可以使用 System.loadLibrary 方法来加载本地库，或者使用 HawtJNI 提供的 Library 类来自动加载库：

@JniClass
public class Platform {
    private static Library library = new Library("hawtjni-example", 1, 0, 0);
    static {
        library.load();
    }
    public static native long open(String file, int flags, int mode);
}

2.3 生成 JNI 代码

编译你的 Java 类后，使用 hawtjni-generate.jar 工具生成 JNI 代码：

java -jar hawtjni-generate.jar -o target/native target/classes

生成的 JNI 代码将放置在 target/native 目录下。

3. 项目API使用文档

3.1 @JniClass 注解

用于标记包含 native 方法的 Java 类。

3.2 Library 类

用于加载本地库，支持自动解包和加载。

3.3 native 方法

定义静态的 native 方法，用于调用本地 C/C++ 函数。

4. 项目安装方式

4.1 通过 Maven 安装

在 pom.xml 中添加依赖：

<dependency>
    <groupId>org.fusesource.hawtjni</groupId>
    <artifactId>hawtjni-runtime</artifactId>
    <version>1.17</version>
</dependency>

4.2 手动安装

1. 下载 hawtjni-runtime 的 JAR 文件。
2. 将 JAR 文件添加到你的项目 classpath 中。

通过以上步骤，你可以成功安装并使用 HawtJNI 项目。