README_cn.md

rust-java 样例

English version, 英文版

简介

这个仓库包含调用 Java 方法的 Rust 代码，以及调用 Rust 方法的 Java 类。

样例清单

0. sample000, 从 Java 调用 Rust 方法

   • s000_hello.rs
   • HelloWorld.java

1. sample001, 在 Rust 中将 Java 原始类型转换为字节

   • s001_bytes.rs
   • Bytes.java

2. sample002, 在 Rust 中接受 Java 对象，并回调到 Java

   • s002_callback.rs
   • Caller.java
   • s002_callback_fast.rs
   • Caller2.java

3. sample003, 逆转 Java 字节

   • s003_reverse_bytes.rs
   • ReverseBytes.java

4. sample004, 在 Rust 中访问 Java 非堆内存

   • s004_direct_buf.rs
   • DirectBuf.java

5. sample005, 在 Rust 中访问 Java 基本类型数组

   • s005_primitive_array.rs
   • PrimitiveArray.java

6. sample006, 在 Rust 中创建 Java 对象

   • s006_create_object.rs
   • ObjectCreator.java

7. sample007, 在 Rust 中为 Java 对象设置字段值

   • s007_fill_field.rs
   • FieldFiller.java

8. sample008, 在 Rust 中加载 Java 类

   • s008_load_class.rs
   • s008_class_buf.rs
   • MemClassLoader.java

   s008_class_buf.rs 是通过 java2u8vec.sh 生成的

9. sample009, 在 Rust 中动态注册 Java 方法

   • s009_reg_method.rs
   • NativeMethodRegister.java

更多...

构建

cargo build --release

cargo 在 target/release 构建 .so, 并会调用 build_java.sh 构建 .jar，里面的 resources 文件夹会包含 .so。

如何使用

1. 在 IDE 中调用 Java 单元测试
2. 在 IDE 中调用 Java 单元测试集

备注：需要设置 JVM 参数: -DsampleLib=<path to lib>

或者

1. 在命令行中执行 Java 单元测试

   gradle test --tests HelloWorldTest

2. 在命令行中执行 Java 单元测试集

   gradle test --tests SamplesSuite

可在 JUnit 报告 中观察结果

感谢

感谢 metaworm(rust-java-demo)。当时我在学如何通过 Rust 调用 JNI 时，这篇文章 (url1/url2) 是最有效最详细的。