利用RJB在Ruby on Rails中使用Java代码的教程

开始之前
关于本教程

Ruby on Rails (Rails) 是用 Ruby 编写的一个 full-stack Web 应用程序框架，而 Ruby 是一种功能丰富的、免费的、可扩展的、可移植的、面向对象的脚本编制语言。Rails 在 Web 应用程序开发人员之间非常流行。通过它，可以快速有效地开发 Web 应用程序，并将其部署到任何 Web 容器中，例如 IBM? WebSphere? 或 Apache Tomcat。

在 Rails 和类似的 Web 应用程序开发框架出现之前，用于 Web 应用程序开发的标准工具是 Java 语言，因为 Java 语言是独立于平台的，并且有完整的 API 集。很多 Java Web 应用程序仍然在运行，这导致很多非常有用的、编写良好的 Java 代码（在本教程中统称遗留代码）具有良好的可用性。遗留 Java 代码通常被打包在一组 JAR 文件。

如果将 Web 应用程序开发平台改为 Rails，那么可以重用遗留 Java 代码。Ruby Java Bridge (RJB) 是一个工具包，通过它可以将 JAR 文件装载到 Rails 应用程序中，还可以在 Rail 应用程序中访问其中的方法和变量。本教程解释如何在 Rails 应用程序中配置和使用 RJB。
目标

在本教程中，您将学习如何：

下载、编译和安装 RJB
设置 RJB 以访问共享 Java 库
将遗留 Java 代码装载到 Rails 应用程序中并进行访问

本教程并不深入研究 Rails 的功能。与其他 Web 框架相比，Rails 有很多优点，其中一个优点就是用于该平台的文档的数量和质量都很高（参见参考资料）。
先决条件

本教程假设读者基本熟悉 Java 语言、Ruby 和 Ruby on Rails。
系统需求

本教程假设您使用 Linux? 系统（但是，在 Windows? 上的步骤基本上是相同的）。本教程假设您有一个可以工作的 Ruby on Rails。如果还没有，请在参考资料小节中找到相关文档的链接，以帮助您在自己的系统上安装和配置 Rails。

RJB 要求系统上安装有 Java SDK。如果需要一个 Java SDK，可以针对您的平台下载最新的 Java SE SDK，并马上安装它。

RJB 安装和设置

本节带您亲历 RJB 的下载、安装、编译和设置。
下载 RJB

可以下载标准 Ruby Gem 包或自己编译的源代码归档文件形式的 RJB。为了进行演示，我推荐下载源代码归档文件，所以我将使用这种方法。闲话少说，现在就下载 RJB 1.1.3 source .zip 文件（在撰写本教程之际，已经有了最新的 RJB 版本）。

确保设置或更新了以下环境变量，它们是安装 RJB 所必需的：

JAVA_HOME 必须指向 Java SDK 安装目录。
PATH 必须包括 $JAVA_HOME/bin。

例如，在 bash（仅用于 Linux 系统）中，假设已经将 Java SDK 安装到 /usr/local/jdk60，则执行以下命令：

[root@san]# export JAVA_HOME=/usr/local/jdk60

[root@san]# export PATH=$PATH:$JAVA_HOME/bin

编译和安装 RJB

下一步是通过执行以下命令编译和安装 RJB：

[root@san]# unzip rjb-1.1.3.zip

[root@san]# cd rjb-1.1.3

[root@san]# ruby setup.rb config

[root@san]# ruby setup.rb setup

[root@san]# ruby setup.rb install

确认安装成功

为了确认 RJB 安装成功，首先调用 Ruby 的交互式控制台 irb：

[root@san]# irb

然后输入 require 'rjb'：

irb(main):001:0> require 'rjb'

=> true

irb(main):002:0>exit

如果 require 'rjb' 命令返回 true，则意味着 Ruby 安装识别出新安装的 rjb 库。现在可以在应用程序中开始使用 RJB。

通过 RJB 使用遗留代码

在本节中，您将在 Rails 应用程序中装载和访问遗留 Java 代码。
示例项目

Java Tar package from ICE Engineering 是用 Java 语言编写的一个很好的工具包，用于处理归档文件。它提供了 tar 归档实用程序的本地 Java 实现，当与 java.util.zip 包相结合时，它可以处理 .tar.gz 文件。它还利用 Java 语言的平台独立性，可以不作修改地在所有 UNIX? 变体和 Windows 上运行。作为练习，您将使用它来解压一个样例 tar 文件的内容。通过类似的方法，可以在 Ruby on Rails 应用程序中使用任何遗留 Java 代码。

练习的目标是：

将 tar.jar 文件装载到一个 Rails 应用程序中。
将 JAR 文件所需的类装载到应用程序中。
解压使用这些类的样例 test.tar 文件的内容。

入门
获取样例文件

首先，需要为系统获取样例 tar 文件（test.tar）和 Java Tar 包：

将test.tar 下载并保存到一个方便的位置。
下载和保存javatar-2.5.tar.gz。
将 javatar-2.5.tar.gz 的内容解压到一个方便的位置。这个练习中，这个包中惟一需要用到的文件是 tar.jar，它在 jars 目录中。

访问共享库

RJB 使用 Java Native Interface (JNI) 实现它的功能。因此，它需要访问 JDK 安装中附带的一些共享对象文件（共享库）。您必须使用以下命令将这些文件的位置添加到 LD_LIBRARY_PATH 环境变量中：

[root@san]# export JAVA_HOME=/usr/local/jdk60

[root@san]# export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$JAVA_HOME/jre/lib/i386

[root@san]# export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$JAVA_HOME/jre/lib/i386/client

如果打算在独立的 Ruby 脚本中使用 RJB，那么只需在正在处理的 shell 中设置这些环境变量。对于您的 Ruby on Rails 应用程序，还必须在 Rails 应用程序的 environment.rb 文件中设置这些变量。
将 RJB 装载到 Rails 应用程序

要将 RJB 装载到 Rails 应用程序并将它设置为可以调用 Java 类，需要执行两个步骤：

告诉 Ruby 将 rjb 库包含到代码中。
装载 JVM，设置类路径和其他可选的 JVM 参数。

首先，使用下面的命令初始化 RJB：

require 'rjb'

接着，将 Rails 应用程序中将要使用的所有 legacy .jar 文件 — 本例中为 tar.jar — 添加到 classpath 变量：

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

可以将 jvmargs 留空，除非希望为 JVM 指定额外的参数。

现在，可以将准备使用的 Java 类导入到 Ruby 中，实例化这些类，并调用所需的方法。
将 Java 类导入到 Ruby 并实例化

清单 1 中的 Ruby 代码从 tar.jar 包中导入了需要的 Java 类，并从导入的类中创建了 Ruby 对象：
清单 1. 将 Java 类导入到 Ruby 并实例化

tararchive = Rjb::import('com.ice.tar.TarArchive')

fileinputstream = Rjb::import('java.io.FileInputStream')

file = Rjb::import('java.io.File')

file_instance = file.new_with_sig('Ljava.lang.String;','.')

fileinputstream_instance =
fileinputstream.new_with_sig('Ljava.lang.String;','test.tar')

tararchive_instance =
tararchive.new_with_sig('Ljava.io.InputStream;',fileinputstream_instance)

p "Let's verify that the objects created are indeed of the classes we
wanted..."
p "------------------------------"

p "For the File instance...."
p "Expecting: java.io.File , it is: " + file_instance._classname
p "------------------------------"

p "For the FileInputStream instance...."
p "Expecting: java.io.FileInputStream , it is: " +
fileinputstream_instance._classname
p "------------------------------"

p "For the TarArchive instance...."
p "Expecting: com.ice.tar.TarArchive , it is: " +
tararchive_instance._classname

导入 Java 类

清单 1 中的前三行将调用 RJB 的 import 方法，将所需的类分别导入到 Ruby 变量 tararchive、fileinputstream 和 file 中。必须指定类的完整包路径 — 例如，TarArchive 类为 com.ice.tar.TarArchive，而 FileInputStream 类为 java.io.FileInputStream— 就像使用 java 命令运行应用程序那样。
实例化导入的类

接着，清单 1 创建导入类的对象。可以通过调用每个类的 new 方法创建类，就像创建任何 Ruby 对象一样（例如，tararchive.new）。但是这样做会调用 TarArchive 类的默认的构造函数（没有参数），而您并不希望这样做。

当重载了类的构造函数后，需要对上面的对象创建方法进行一些修改。在这种情况下，必须按照下面的方式创建对象：

object = Classname.new_with_sig('signature', parameter[,more parameters])

第一个参数定义构造函数所需的参数的签名类型。它告诉 RJB 调用其输入参数匹配指定签名的构造函数。

清单 1 中的第 4 个和第 5 个语句分别创建 file 和 fileinputstream 类的对象，它们调用相应的构造函数，参数类型为 String。

在清单 1 的第 6 个语句中，TarArchive 类的其中一个构造函数接受 InputStream 类型的对象作为参数。该语句的签名类型是一个单独的 InputStream 输入参数。这些类型签名的详细细节在 getName API 的 Java SDK 文档中做了很好的描述（参见参考资料）。第二个参数是创建的 InputStream 类型对象。
检验对象创建

清单 1 中的其余内容将检验 RJB 创建的对象是否是指定类的对象，方法是调用添加到每个对象的 _classname 方法。例如，调用 tararchive_instance._classname 将返回 com.ice.tar.TarArchive，这意味着类被正确装载，并成功创建了该类的对象。
调用方法并捕获结果

将类装载到 Ruby 并从中创建了对象后，下一步是调用需要的方法并查看结果。例如，您希望使用 TarArchive 类的 extractContents 方法，将样例文件（test.tar）的内容提取到当前目录中。

和构造函数一样，可以使用两种方式调用方法。一种方式是直接调用方法，例如：

tararchive_instance.extractContents(file_instance)

当方法重载后，使用 _invoke 调用指定方法的每个参数的类型签名：

tararchive_instance._invoke('extractContents', 'Ljava.io.File;', file_instance)

这一步可以使 RJB 知道在方法重载时应该调用哪些方法。

和对待普通 Ruby 代码一样，您将捕获对象方法返回的结果（如果有的话），并在自己的应用程序中使用结果。方法调用返回的结果被自动转换为相应的对象类型。您只需在对象内直接调用方法。

Java TarArchive 类中实现的功能现在可以用于您的 Ruby 代码。通过使用相同的方法，Java 代码中已实现的任何功能可以不加修改地在您的 Ruby 和 Rails 应用程序中重用。
完整的代码

清单 2 展示了本教程示例的完整 Ruby 代码（也可以通过下载获得）：
清单 2. 完整的示例 Ruby 代码

# Include 'rjb' library into your application

require 'rjb'

# Load the JVM specifying the jar files to include and any other optional JVM arguments

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

# Import the classes you want to use into a Ruby variable
# specify the full package path to the classes.

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

# Create objects of the classes. Use the new method directly or use 
# the 'new_with_sig' call to invoke overloaded constructors with arguments

# Directory you want to extract the files in this case, the current directory

file_instance = file.new_with_sig('Ljava.lang.String;','.')

# inputstream instance of the file to extract

fileinputstream_instance = fileinputstream.new_with_sig('Ljava.lang.String;','test.tar')

# tararchive instance of the file to be extracted.

tararchive_instance = tararchive.new_with_sig('Ljava.io.InputStream;'\
        ,fileinputstream_instance)

# Invoke the method from the class and capture the results.
# Use either the direct call of the method,
# or the '_invoke' call to invoke overloaded methods.

p 'Extracting file.....'

tararchive_instance.extractContents(file_instance)

p 'Done...'

尝试这些代码，将清单 2 中的代码保存到一个文件中，并且扩展名为 .rb（或使用下载中的 rjb-javatar.rb），然后在 Ruby 解释程序中运行。

结束语

在全新的 Rails 应用程序中重用已有的遗留 Java 代码其实非常简单，方式如下：

安装 Java SDK 和 RJB。
将 JAVA_HOME 和 LD_LIBRARY_PATH 环境变量导出到您的 Rails 应用程序的 environment.rb 文件中。
在应用程序中包括 rjb 库。
通过指定希望使用的 JAR 文件，装载 RJB 和 JVM。
从希望使用的 JAR 文件中将类导入到 Ruby 变量并创建类的对象。
开始在 Rails 应用程序中使用刚刚创建的类，就像使用任何 Ruby 对象一样。

如果希望在 Rails 应用程序中重用已经使用 Java 代码实现的业务逻辑，RJB 非常有用，并且不需要使用 Ruby 重新实现。它同时提供了 Ruby on Rails 和 Java 编程的优点。
考虑替代方法

还可以使用一种称为 JRuby 的替代方法，它可以实现与 RJB 相同的目标。JRuby 是使用 Java 语言实现的完整的 Ruby 包，使 Ruby 能够运行在 JVM 之上（参见参考资料）。使用 JRuby，您可以访问所有 Java 库。JRuby 要求安装特定于 JRuby 的 Ruby Gems，因为针对非 Java 的 Ruby 的普通 Ruby Gems 不能与 JRuby 兼容。

RJB 和 JRuby 各有优缺点。对于 JRuby，Ruby 全部在 JVM 之上运行，每个 Ruby 调用将经过 JVM，这将使执行变得非常缓慢。同样，如果已经设置了一个 Rails 应用程序，需要从头开始设置，以便 JRuby 访问 Java 代码。作为原生 Ruby 包，RJB 易于安装，并且可以在已有的 Rails 设置中使用。如果需要在您的 Rails 应用程序中快速调用一些 Java 代码片段，那么 RJB 是最好的选择。

整体而言，在 Rails 应用程序中重用遗留 Java 代码的能力非常有用。使用 Java 语言实现的设计和编写都非常良好的业务逻辑不会搁置不用，相反，可以在新的 Web 应用程序中继续发挥有用的功能。