Rjb is Ruby-Java bridge using Java Native Interface.

The Ruby Kaigi 2010 Presentation on Rjb.

A short introduction in English.

Some examples in Japanese, but the source code is clear for everybody.

How to install

You need to install Java2 sdk, and setup JAVA_HOME enviromental varible except for OS X. I assume that OS X's JAVA_HOME is reported by calling /usr/libexec/java_home.

This done please proceed with:

ruby setup.rb config
ruby setup.rb setup
# (in Unix)
sudo ruby setup.rb install


# (in win32)
ruby setup.rb install

How to test

On Windows based machines:

cd test
ruby test.rb

On Unix based machines plese see test/readme.unix. You need to set LD_LIBRARY_PATH environmental variable to run rjb.

Notice for opening non-ASCII 7bit filename

If you'll plan to open the non-ascii character named file by Java class through Rjb, it may require to set LC_ALL environment variable in you sciprt.

For example in Rails, set above line in production.rb as your environment:

ENV['LC_ALL'] = 'en_us.utf8' # or ja_JP.utf8 etc.

cf: http://bugs.sun.com/view_bug.do?bug_id=4733494 (Thanks Paul for this information).


[email protected]