JNI 실전 입문: Rust로 만든 초성 검색을 Java에서 부르기

jni-rust-example/ ├── Cargo.toml # Rust 라이브러리 설정 ├── src/lib.rs # 호출 받는 쪽: 초성 로직, JNI 함수 ├── java/com/example/Chosung.java # 호출하는 쪽: native 메서드 선언 ├── java/com/example/Main.java # 호출하는 쪽: 사용 예 └── run.sh # 빌드하고 실행

package com.example; /** Rust(libchosung_jni)로 구현한 초성 검색. 메서드 본문은 src/lib.rs의 Java_com_example_Chosung_* 함수다 */ public final class Chosung { static { // -Djava.library.path로 준 폴더에서 libchosung_jni.dylib(.so, .dll)를 찾는다 System.loadLibrary("chosung_jni"); } private Chosung() {} public static native String extract(String text); public static native int[] search(String[] names, String query); }

[package] name = "chosung_jni" version = "0.1.0" edition = "2024" [dependencies] jni = "0.21" [lib] crate-type = ["cdylib"] [profile.release] # 패닉을 abort로 바꾸지 않는다. 경계에서 catch_unwind로 잡아 Java 예외로 바꾼다 panic = "unwind"

#[unsafe(no_mangle)] pub extern "system" fn Java_com_example_Chosung_extract<'local>( mut env: JNIEnv<'local>, _class: JClass<'local>, text: JString<'local>, ) -> jstring { guard(&mut env, |env| { if text.is_null() { env.throw_new("java/lang/NullPointerException", "text가 null입니다")?; return Ok(std::ptr::null_mut()); } // Java 문자열을 Rust String으로 복사하고, 결과를 다시 Java 문자열로 만든다 let text: String = env.get_string(&text)?.into(); Ok(env.new_string(to_chosung(&text))?.into_raw()) }) }

#[unsafe(no_mangle)] pub extern "system" fn Java_com_example_Chosung_search<'local>( mut env: JNIEnv<'local>, _class: JClass<'local>, names: JObjectArray<'local>, query: JString<'local>, ) -> jintArray { guard(&mut env, |env| { if names.is_null() || query.is_null() { env.throw_new("java/lang/NullPointerException", "names와 query는 null일 수 없습니다")?; return Ok(std::ptr::null_mut()); } let query: String = env.get_string(&query)?.into(); let len = env.get_array_length(&names)?; let mut hits: Vec<jint> = Vec::new(); for i in 0..len { let item = JString::from(env.get_object_array_element(&names, i)?); if !item.is_null() { let name: String = env.get_string(&item)?.into(); if matches(&name, &query) { hits.push(i); } } env.delete_local_ref(item)?; // 원소마다 생긴 로컬 참조를 바로 지운다 } let out = env.new_int_array(hits.len() as i32)?; env.set_int_array_region(&out, 0, &hits)?; Ok(out.into_raw()) }) }

fn guard<T: Default>(env: &mut JNIEnv, body: impl FnOnce(&mut JNIEnv) -> jni::errors::Result<T>) -> T { match catch_unwind(AssertUnwindSafe(|| body(env))) { Ok(Ok(value)) => value, // 이미 Java 예외가 걸려 있다(예: 위의 NullPointerException). 그대로 반환하면 Java에서 던져진다 Ok(Err(jni::errors::Error::JavaException)) => T::default(), Ok(Err(e)) => { let _ = env.throw_new("java/lang/IllegalStateException", e.to_string()); T::default() } Err(_) => { let _ = env.throw_new("java/lang/RuntimeException", "Rust 쪽에서 패닉이 났습니다"); T::default() } } }

package com.example; import java.util.Arrays; public class Main { public static void main(String[] args) { String[] names = {"박선영", "김철수", "이선정", "박상훈", "Lee YoungHoon"}; System.out.println("초성: " + Chosung.extract("널스페이스 People")); for (String q : new String[] {"ㅂㅅ", "박ㅅ", "ㅅㅈ", "Lee"}) { int[] hits = Chosung.search(names, q); System.out.println(q + " -> " + Arrays.stream(hits).mapToObj(i -> names[i]).toList()); } try { Chosung.extract(null); } catch (NullPointerException e) { System.out.println("Rust가 던진 예외: " + e.getMessage()); } } }

#!/usr/bin/env bash set -euo pipefail cd "$(dirname "$0")" cargo build --release -q mkdir -p build javac -d build java/com/example/*.java java -Djava.library.path=target/release -cp build com.example.Main

초성: ㄴㅅㅍㅇㅅ People ㅂㅅ -> [박선영, 박상훈] 박ㅅ -> [박선영, 박상훈] ㅅㅈ -> [이선정] Lee -> [Lee YoungHoon] Rust가 던진 예외: text가 null입니다