Ruby on Rails 整合舊有 Java 資產：RJB 橋接器完整實戰指南

企業遷移至 Ruby on Rails 時，往往擁有大量成熟的 Java 業務邏輯（打包為 JAR）。Ruby Java Bridge (RJB) 透過 JNI 讓 Rails 應用直接載入 JVM、實例化 Java 物件、呼叫方法，無需重寫業務邏輯。本文涵蓋 RJB 安裝、環境配置、JAR 載入、類導入、建構子與多載方法處理、完整範例與替代方案對比。

環境準備

• JDK 6+（設定 JAVA_HOME）
• Linux 需設定 LD_LIBRARY_PATH 指向 $JAVA_HOME/jre/lib/<arch> 及 client 目錄
• Rails 應用 config/environment.rb 中同步設定上述環境變數

RJB 安裝與驗證

# 下載源碼編譯安裝
unzip rjb-1.1.3.zip && cd rjb-1.1.3
ruby setup.rb config && ruby setup.rb setup && ruby setup.rb install

# 驗證
irb -r rjb -e "puts 'RJB OK'"

核心 API 流程

1. require 'rjb'
2. Rjb::load(classpath, jvmargs) — 啟動 JVM、設定類路徑
3. Rjb::import('fully.qualified.ClassName') — 導入 Java 類
4. ClassName.new_with_sig('signature', args...) — 呼叫多載建構子
5. obj.method(args) 或 obj._invoke('method', 'sig', args) — 呼叫方法

完整範例：解壓 tar.gz 檔案

require 'rjb'
Rjb::load(classpath = '.:/path/to/tar.jar', jvmargs = [])

TarArchive   = Rjb::import('com.ice.tar.TarArchive')
FileInputStream = Rjb::import('java.io.FileInputStream')
File         = Rjb::import('java.io.File')

dir        = File.new_with_sig('Ljava.lang.String;', '.')
input      = FileInputStream.new_with_sig('Ljava.lang.String;', 'test.tar')
archive    = TarArchive.new_with_sig('Ljava.io.InputStream;', input)

archive.extractContents(dir)
puts "Done."

關鍵點解析

• new_with_sig 簽名格式參考 Class.getName()：Ljava.lang.String;、Ljava.io.InputStream;
• 多載方法必須用 _invoke('method', 'signature', args) 顯式指定
• 回傳值自動轉換為 Ruby 物件

RJB vs JRuby 選型建議

總結

RJB 讓 Rails 以極低成本復用 Java 資產，適合漸進式遷移。若系統高度依賴 Java 生態，JRuby 則是更徹底的選擇。