Dans ce post, je vais décrire comment installer JRuby. Ensuite je vous montrerai comment faire tourner une application Rails 3 de base avec JRuby.
Tout d'abord, vous allez devoir installer JRuby. Vous pouvez installer directement les exécutables, que vous téléchargez sur le
site de JRuby.
Toutefois, si, comme moi, vous utilisez plusieurs versions de Ruby, je vous conseille fortement d'utiliser
Ruby Version Manager (RVM).
Une fois que RVM est installé, une seule ligne de commande suffit pour installer JRuby:
rvm install jruby
Ensuite, pour commencer à utiliser JRuby:
rvm use jruby
Quand vous aurez fini, pour revenir à votre version de Ruby par défaut, il suffit de faire:
rvm reset
Vous pouvez vérifier la version de JRuby que vous allez utiliser:
jruby -v
A présent, installons Ruby on Rails:
jruby -S gem install rails
Pour créer une nouvelle application Rails 3:
jruby -S rails new demo_jrails -m http://jruby.org/rails3.rb
Rails 3 inclut toutes les dépendances vers les libraires externes (gems en Ruby) dans un seul fichier Gemfile. Pour installer ces dépendances sur votre machine locale, il suffit de faire:
jruby -S bundle install
Quant à votre fichier de configuration de base de données, il ne dévoilera pas que vous utilisez JDBC et aura l'air tout à fait ordinaire (notez que j'utilise Postgresql):
development:
adapter: postgresql
encoding: unicode
database: demo_jrails_development
pool: 5
username: USER
password: PWD
Si vous avez des problèmes avec la connection à la base de données, commencez par regarder
le README d'ActiveRecord JDBC Adapter sur GitHub.
Enfin, si vous voulez utiliser des JARs dans votre JRuby, il convient de créer une variable d'environnement CLASSPATH. J'ai fait pointer la mienne vers le répertoire lib de JRuby:
export CLASSPATH=/~/.rvm/rubies/jruby-1.5.1/lib
Amusez-vous bien avec JRuby et Rails!
Dans un prochain post, nous verrons comment créer un fichier de déploiement Java.