jni.hpp 使用教程

jni.hpp 使用教程

jni.hpp A modern, type-safe, header-only, C++14 wrapper for JNI 项目地址: https://gitcode.com/gh_mirrors/jn/jni.hpp

1. 项目介绍

jni.hpp 是一个现代化的、类型安全的、仅包含头文件的 C++14 包装器，用于 Java Native Interface (JNI)。它的目标是使得从 C++ 调用 Java 或从 Java 调用 C++ 变得方便和安全，同时不牺牲底层控制，这是传统代码生成方法所不具备的。

jni.hpp 提供了两级包装：

• 低级包装：与 JNI 一一对应的类型和函数包装。
• 高级包装：提供了更多语法便利和类型安全，特别是对于非原始 Java 类型。

2. 项目快速启动

首先，确保你的开发环境支持 C++14。以下是快速启动 jni.hpp 的基本步骤：

安装

克隆仓库到本地：

git clone https://github.com/mapbox/jni.hpp.git

编译

在克隆的仓库目录中，你可以使用 Makefile 来编译示例程序：

make

运行

编译成功后，运行示例程序：

./example

3. 应用案例和最佳实践

使用 jni.hpp，你可以轻松地创建安全的 JNI 代码。以下是一些应用案例和最佳实践：

创建 Java 类的引用

#include <jni.hpp>

// 假设存在一个名为 Math 的 Java 类
struct Math {
    static constexpr auto Name() {
        return "java/lang/Math";
    }
};

// 获取 Java 类的引用
auto cls = jni::FindClass<Math>(env);

调用 Java 方法

// 获取 Java 对象的引用
auto obj = jni::NewObject<Math>(env);

// 调用 Java 对象的非静态方法
auto result = jni::CallMethod<int, Math>(env, obj, "add", "(II)I", 5, 10);

访问 Java 字段

// 获取 Java 类的静态字段
auto field = jni::StaticField<Math, jni::jint>(env, "PI");

// 设置字段值
field.Set(env, 314);

// 获取字段值
auto pi_value = field.Get(env);

4. 典型生态项目

jni.hpp 可以与多种项目集成，以下是一些典型的生态项目：

• JavaCPP：一个简化了 Java 和 C++ 之间互操作性的库。
• SWIG：一个可以让 C/C++ 代码与多种编程语言交互的工具。
• JNA：一个允许 Java 调用本地库的库，而无需编写 JNI 代码。

通过上述案例和实践，你可以开始使用 jni.hpp 库来创建安全、高效的 JNI 代码。

jni.hpp A modern, type-safe, header-only, C++14 wrapper for JNI 项目地址: https://gitcode.com/gh_mirrors/jn/jni.hpp