写点什么

一文解秘 Rust 如何与 Java 互操作

  • 2025-01-03
    福建
  • 本文字数:2848 字

    阅读完需:约 9 分钟

使用场景


JAVA 与 Rust 互操作让 Rust 可以背靠 Java 大生态来做更多事情,而 Java 也可以享受 Rust 语言特性的内存安全,所有权机制,无畏并发。


互操作的典型场景包括:

  • 性能优化:利用 Rust 处理计算密集型任务,提高 Java 应用的整体性能。

  • 系统级编程:结合 Rust 的底层控制能力与 Java 的高级抽象,实现更高效的系统交互。

  • 跨平台开发:使用 Rust 编写核心逻辑,通过 JNI 在不同平台上与 Java 交互,实现高效跨平台开发。

  • 安全关键应用:在金融、医疗等领域,利用 Rust 处理敏感数据和核心功能,保证高度安全性。

  • 实时系统:在游戏引擎、音频处理等延迟敏感的应用中,使用 Rust 处理时间关键部分。


背景知识


JNI



  • 全称 Java Native Interface,它允许 Java 代码与其他语言(如 C 或 C++)编写的应用程序进行互操作。

  • JNI Specification:这是 JNI 的官方规范,详细描述了 JNI 的使用方法、接口和功能。


Java 虚拟机(JVM)



JNI 是 Java 虚拟机的一部分,JVM 在启动时为每个线程创建一个 JNI 环境。JNI 环境包括指向 JVM 内部数据结构的指针,这些数据结构用于存储 Java 对象、方法和字段的信息。


JNIEnv (JNI 环境)


  • JNIEnv是一个指向结构体的指针,代表当前线程的 JNI 环境。它包含所有 JNI 相关函数的指针,让你能在本地代码中使用这些函数。每个线程都有自己独立的JNIEnv,所以不能在不同线程间传递这个指针。

  • 可以将JNIEnv视为一个"翻译器"。当 Rust 代码需要与 Java 交互时,它通过这个"翻译器"发送请求,当调用 Java 方法或获取 Java 对象的属性。每个线程都拥有自己独立的"翻译器",这确保了各线程与 Java 交互时的独立性。


另外


  • 当 Java 代码调用本地方法时,JVM 会加载相应的本地库并创建一个JNIEnv指针。

  • 本地代码可以使用这个指针访问 JNI 提供的函数,进行 Java 对象的操作。

  • 每个线程有独立JNIEnv,保证线程安全。新线程需调用AttachCurrentThread获取对应JNIEnv

  • JNI 提供了数据类型转换机制,实现 Java 与 C/C++之间的数据传递。


在 Rust 生态中使用 jni 0.21.1 库可以实现与 Java 代码的交互。


JNI 0.21.1 简介


该项目为 Rust 提供了完整的 JNI 绑定,允许:

  • 使用 Rust 代码与 Java 库进行交互,调用 Java 方法和访问 Java 对象。

  • 从 Rust 代码中使用 Java 类和接口。

  • 实现跨语言的高效数据交换。

  • 利用 Rust 的性能优势和 Java 的成熟生态系统


跨平台 UI 框架 Flutter 源码中的 MethodChannel 实现了 Dart 与 Android 层的通信,其底层 C++也是通过 JNI 调用插件中的 onMethodCall 来实现的。这与上述 jni 0.21.1 采用了相同的思路,但存在以下不同点:

  • 语言特性和类型安全:

  • Rust 的jni库提供了一种更安全的方式来处理 Java 对象和方法调用。它利用 Rust 的所有权系统来减少潜在的内存错误,使得在 Rust 中使用 JNI 时更易于管理资源和避免常见错误。

  • 多平台支持:jni 0.21.1 提供了更广泛的跨平台支持。


如何运行示例


在 Windows 11 环境下运行示例时,笔者遇到了两个问题:


  1. Windows 自带的 PowerShell 无法直接执行 Makefile

  2. 由于 Rust 配置了特定目标平台,出现了不明原因的编译错误


以下是解决这些问题的方法:


在 MinGW-w64 中执行 Makefile


  1. 确保已在 MinGW-w64 环境中安装 mingw32-make 工具(通常随 MinGW-w64 一起安装)

  2. 打开 MinGW-w64 命令行

  3. 导航至 Makefile 所在目录

  4. 执行以下命令


//当前示例中是makefile,直接执行mingw32-make -f makefile即可mingw32-make -f YourMakefileName
复制代码


确认当前 Rust 环境


举例来说,笔者在 C:\Users\xxx.cargo 目录下配置了 config.toml 文件:


[build]target = "aarch64-linux-android"
复制代码


这导致在 Windows 上使用 mingw32-make 来编译针对 Android 平台的 Rust .so 文件,造成了混乱并引发了莫名其妙的编译错误。解决方法是删除不必要的 config.toml 文件,确保当前运行环境与目标平台(如 Windows)一致。


输出结果:


Hello, josh![B@2f92e0f4factCallback: res = 720counterCallback: count = 1counterCallback: count = 2counterCallback: count = 3counterCallback: count = 4counterCallback: count = 5Invoking asyncComputation (thread id = 1)asyncCallback: thread id = 23, progress = 0%asyncCallback: thread id = 23, progress = 10%asyncCallback: thread id = 23, progress = 20%asyncCallback: thread id = 23, progress = 30%asyncCallback: thread id = 23, progress = 40%asyncCallback: thread id = 23, progress = 50%asyncCallback: thread id = 23, progress = 60%asyncCallback: thread id = 23, progress = 70%asyncCallback: thread id = 23, progress = 80%asyncCallback: thread id = 23, progress = 90%asyncCallback: thread id = 23, progress = 100%
复制代码


示例简析


让我们深入分析示例中 asyncComputation 的流程。其核心目的是在 Rust 端执行一个异步计算,同时 Rust 端会调用 Java 端来报告计算进度。



整体流程图说明:

  1. Java 的 main()方法调用 asyncComputation()。

  2. asyncComputation()通过 JNI 调用 Rust 的 Java_HelloWorld_asyncComputation()函数。

  3. Rust 函数创建一个新线程来执行异步计算。

  4. 在新线程中,Rust 执行计算并周期性地调用 Java 的 asyncCallback()方法报告进度。

  5. 当 Rust 完成计算后,控制权返回到 Java 的主线程。

这个过程展示了 Java 调用 Rust(步骤 1)和 Rust 回调 Java(步骤 4)的双向交互。


源码如下



1 将一个 HelloWorld 类实例传递给 Rust 端,这对应下方 Rust 侧实现中 #3 处的 callback 对象



Rust 实现说明


  1. JNIEnv 参数:详见上述相关概念中的解释。

  2. JClass:代表调用此本地方法的 Java 类引用,主要用于访问类级别的静态方法和字段。

  3. callback:Java 中新创建的 HelloWorld 对象实例。

  4. 获取 JVM 对象:因为 env 对象不支持线程间传递和共享(仅实现了 Send),而 JVM 支持。通过 JVM 对象可在线程间传递,并最终获得 env

  5. 创建全局引用:获取 HelloWorld() 实例对象的全局引用,防止被垃圾回收。

  6. 线程安全:每个线程都有自己的 JNIEnv,确保线程安全。在新线程中需调用 AttachCurrentThread 获取对应的 JNIEnv

  7. 反向调用 Java:通过 env 反向调用 Java 代码。调用对象是新创建的 HelloWorld 实例,回调方法是其中的 asyncCallback。在 JNI 中,"(I)V" 是方法签名,描述了 Java 方法的参数和返回类型。"(I)V" 表示接受一个整数参数并返回 void 的方法。在这里,asyncCallback 方法接收一个整数(progress)作为参数,无返回值。


总结


  1. Java 与 Rust 互操作让两种语言优势互补,提高性能和安全性,适用于多种场景如性能优化、系统级编程和跨平台开发。

  2. JNI(Java Native Interface)是实现 Java 与 Rust 互操作的关键技术,允许 Java 代码与其他语言编写的应用程序进行交互。

  3. 通过示例分析,我们了解了 Java 调用 Rust 函数和 Rust 回调 Java 方法的双向交互过程,展示了两种语言之间的无缝协作。


文章转载自:唯你Only

原文链接:https://www.cnblogs.com/programmingBB/p/18529163

体验地址:http://www.jnpfsoft.com/?from=001YH

用户头像

还未添加个人签名 2023-06-19 加入

还未添加个人简介

评论

发布
暂无评论
一文解秘Rust如何与Java互操作_Java_快乐非自愿限量之名_InfoQ写作社区