最近安裝了Jruby On Rails,發現網上雖然有很多資料可以參考,但是由于各種組件的不斷更新,很多資料已經過時,容易產生誤導,在這里介紹一下我個人的安裝經過,供大家參考.

首先是安裝環境,不同的軟件版本可能導致不同的安裝結果.我使用的環境是:

JDK------------------1.6.0_06
TOMCAT--------------6.0.16
MYSQL---------------5.0.22
JRUBY---------------1,1
RAILS----------------2.0.2
WARBLER------------0.9.5

接下來開始安裝,JDK,TOMCAT,MYSQL的安裝就不說了,別忘了配置JAVA_HOME環境變量.
接下來解壓JRUBY,將JRUBY_HOME指向解壓后的文件路徑,CLASSPATH指向該路徑的LIB.接下來轉到JRUBY的BIN路徑下,開始以下的安裝;

1,安裝RAILS,運行:

  jruby gem install rails -r -y --no-ri --no-rdoc

2,安裝Rails框架的數據庫接口和MYSQL適配器,運行:

  jruby gem install activerecord-jdbc-adapter -r -y --no-ri --no-rdoc
  jruby gem install activerecord-jdbcmysql-adapter -r -y --no-ri --no-rdoc

這里要說明一下,有些資料說要安裝ActiveRecord-JDBC,其實ActiveRecord-JDBC和activerecord-jdbc-adapter是同一種東西,只是名字換了,版本不同,ActiveRecord-JDBC的版本是0.5,activerecord-jdbc-adapter現在是0.8.另外因為安裝了activerecord-jdbcmysql-adapter,所以java語言MySQL數據庫接口軟件包就不用下載安裝了.

以上的模塊安裝完畢就可以創建一個RAILS工程了,例如:jruby -S rails demo

隨后修改config/database.yml，像是這樣：

  adapter: jdbcmysql
  hostname: localhost
  database: test
  username: root
  password:

這里再補充一點,有的資料說要修改config/environment.rb,要添加

if RUBY_PLATFORM =~ /java/   
    require 'rubygems'   
    RAILS_CONNECTION_ADAPTERS = %w(jdbc)   
end  

其實這項修改是針對RAILS2.0以前的版本的,現在的2.0.2已經不用改了.這一點在activerecord-jdbc-adapter的文檔有說明.

以上設置完畢就可以啟動WEBrick運行RAILS程序了.下面再說說RAILS程序如何部署到TOMCAT中.Goldspike已經稍顯陳舊了,現在我們可以使用更好的warbler.在JRUBY的BIN路徑下運行:

  jruby gem install warbler -r -y --no-ri --no-rdoc

這樣warbler就安裝好了,接下來如果在RAILS工程下打包,是可以生成.war文件的,但是放在TOMCAT下跑會有問題,原因是因為warbler沒有把數據庫連接的內容打到包里去.其實這也不是warbler的BUG,warbler無法知道用戶連接何種數據庫以及用什么方式連接,所以你需要自己配一下,修改

jruby-1.1\lib\ruby\gems\1.8\gems\warbler-0.9.5\generators\warble\templates\warble.rb文件,

在以下的位置:

# config.gems = ["activerecord-jdbc-adapter", "jruby-openssl"]   
# config.gems << "tzinfo"   
# config.gems["rails"] = "1.2.3"   

添加:

  %w{jdbc-mysql activerecord-jdbcmysql-adapter activerecord-jdbc-adapter}.each{|g| config.gems << g}

注意,上面的warble.rb其實并不是warbler打包的配置文件,它是一個生成配置文件的模板文件,要生成配置文件須要到RAILS工程路徑下運行:

  jruby -S warble config

這時你在工程路徑下config文件夾會找到一個warble.rb,這才是warbler打包的配置文件.上面的添加內容你也可以不在模板文件中添加,而是直接在這里添加.這一步完成后就可以打包了,運行:

  jruby -S warble war

把.war文件拷貝到TOMCAT的webapps下就可以運行了,但是會看到以下錯誤:

Rails Error: No :secret given to the #protect_from_forgery call. Set that or use a session store capable of generating its own keys (Cookie Session Store)

解決的對策是編輯該工程的web.xml文件,添加以下內容

<context-param>   
  <param-name>jruby.session_store</param-name>   
  <param-value>db</param-value>   
</context-param>  

以上的修改也可以在模板文件jruby-1.1\lib\ruby\gems\1.8\gems\warbler-0.9.5\web.xml.erb中進行,這樣就不用每次都要修改工程的web.xml文件了.現在一切正常了.

【編輯推薦】

1. JRuby性能優化的四點建議
2. 如何在tomcat上配置jruby on rails
3. JRuby是什么? JRuby語言概覽
4. JRuby中調用java帶可變參數的方法
5. 使用JRuby生成JVM代碼