README.md

rust-java samples

Chinese version, 中文版

desc

This repository contains sample Rust programs that call Java methods, and Java classes that call Rust methods.

sample list

0. sample000, call Rust method from Java

   • s000_hello.rs
   • HelloWorld.java

1. sample001, convert Java primitive types to bytes in Rust

   • s001_bytes.rs
   • Bytes.java

2. sample002, accept a Java object in Rust, and callback to Java

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

3. sample003, reverse Java bytes

   • s003_reverse_bytes.rs
   • ReverseBytes.java

4. sample004, access Java DirectBuffer in Rust

   • s004_direct_buf.rs
   • DirectBuf.java

5. sample005, access Java primitive array in Rust

   • s005_primitive_array.rs
   • PrimitiveArray.java

6. sample006, create Java object in Rust

   • s006_create_object.rs
   • ObjectCreator.java

7. sample007, set a field to Java object in Rust

   • s007_fill_field.rs
   • FieldFiller.java

8. sample008, load Java class in Rust

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

   s008_class_buf.rs is generated by java2u8vec.sh

9. sample009, register Java method dynamically in Rust

   • s009_reg_method.rs
   • NativeMethodRegister.java

more ..

build

cargo build --release

cargo will generate .so in target/release, and call build_java.sh to build .jar, which contains .so in resources folder.

how-to

1. call Java each JUnit test in IDE
2. call Java JUnit test suite in IDE

Note: need to setup JVM args: -DsampleLib=<path to lib>

or

1. execute Java each JUnit test in console

   gradle test --tests HelloWorldTest

2. execute Java each JUnit test suite in console

   gradle test --tests SamplesSuite

The JUnit report will be generated.

thanks

Thanks to metaworm(rust-java-demo). This article (url1/url2) is the most effective and detailed for learning how to call JNI through Rust.