Commencer avec Ruby on Rails

Rails est organisé selon l'architecture MVC (Modèle-Vue-Contrôleur). Cela lui permet :

• d'isoler la logique métier de l'interface utilisateur ;
• de maintenir le code « DRY » ;
• de conserver le code là où il doit résider, pour une meilleure maintenance.

Action Controller
C'est le composant qui gère les contrôleurs de l'application. Les services rendus par le composant sont la gestion de session, le rendu de templates, et la gestion de redirection.

Action View
Gère la partie vue de vos applications. Il permet de créer du HTML et du XML par défaut. Les services rendus par ce composant sont le rendu de templates, l'inclusion et le rendu de templates partiels (« partials »), et le support d'AJAX.

Active Record
C'est la base des modèles dans vos applications Rails. Il fournit l'indépendance vis-à-vis des bases de données, la base des fonctionnalités CRUD (Create-Retrieve-Update-Delete), et la capacité à relier les modèles entre eux par exemple.

Active Resource
Ce composant fournit un framework pour gérer la connexion entre des objets métier et des services web RESTful. Il implémente une façon de mapper des ressources web à des objets locaux avec une sémantique CRUD.

Active Support
C'est une collection extensive de classes utilitaires et d'extensions Ruby standards, utilisées à la fois dans vos applications et dans le code du framework Rails.

Les principes de base de REST sont les suivants :

• l'utilisation d'URL pour représenter des ressources ;
• l'utilisation de verbes HTTP pour toutes les opérations nécessaires (GET, POST, PUT et DELETE) ;
• l'utilisation des standards HTML et XML.

Par exemple, dans une application Rails une requête du type :

DELETE /photos/17

fait référence à une ressource de type photo, d'identifiant 17, et l'action entreprise est de type suppression.

Si vous souhaitez plus de précisions sur REST, il est conseillé de consulter l'article « A brief introduction to REST ».

La première opération à effectuer avant de créer un projet Rails est évidemment d'installer Rails. Rails est disponible sous la forme d'un gem. Pour l'installer, lancer la commande :

gem install rails

La version de Rails utilisée lors de ce tutoriel est la version 2.3.2. Elle sert de base pour tout le reste du présent document.

Dans le cadre de ce tutoriel, nous allons constituer une application complète de gestion des contacts. Cette application devra fournir :

• une gestion multiutilisateur ;
• une gestion personnelle de contacts avec leurs caractéristiques ;
• un moyen d'importer des contacts provenant d'autres applications (gmail, hotmail…) ;
• un moyen d'exporter des contacts sous plusieurs formes ;
• un code source de haute qualité répondant aux standards Rails.

Procédons à la création du projet. Tout ce que vous avez à faire est de taper :

rails mycontacts

Lorsque vous lancez cette commande, la base de données qui va être utilisée par défaut est SQLite. Si vous souhaitez utiliser une autre base de données, il suffit de suffixer la commande avec l'option -d et le nom de la base de données. Exemple pour MySQL :

rails mycontacts -d mysql

Positionnez-vous maintenant dans le dossier de l'application avec la commande :

cd mycontacts

Si vous listez le contenu du répertoire, vous obtiendrez la structure standard d'un projet Rails. En voici le détail :

Notre application de gestion des contacts va reposer sur une base de données, ils nous faut donc la configurer. Lorsque nous avons créé le projet tout à l'heure, Rails a créé pour nous un fichier de configuration de la base de données, qui se situe dans config/database.yml. Ce fichier est un fichier de configuration au format YAML. YAML est le format de fichier de configuration par défaut utilisé dans tous les projets Rails. C'est un format assez simple à appréhender.

Sachez tout d'abord que tout projet Rails est créé avec trois environnements de travail par défaut :

• development : lorsque vous développez votre application, c'est dans ce mode que vous travaillez, c'est également celui par défaut. Chaque modification que vous ferez sur votre code dans ce mode sera prise en compte « à chaud » ;
• test : c'est le mode utilisé lorsque vous souhaitez lancer vos tests unitaires d'application ;
• production : c'est le mode utilisé lorsque votre projet est finalisé. Il contient des optimisations significatives qui font la différence lors de l'exécution.

Voyons maintenant à quoi ressemble notre fichier de configuration database.yml, en ne prenant en considération que la partie de l'environnement « development » :

# SQLite version 3.x
#   gem install sqlite3-ruby (not necessary on OS X Leopard)
development:
adapter: sqlite3
database: db/development.sqlite3
pool: 5
timeout: 5000

Commençons par le commentaire : on nous conseille d'installer le gem sqlite3-ruby, pour avoir le support SQLite. Faisons-le :

gem install sqlite3-ruby

Le paramètre « adapter » décrit le type de base de données. Il peut prendre la valeur du nom d'une quantité impressionnante de bases de données, toutes supportées par Rails. En voici une liste non exhaustive : SQLite, MySQL, PostgreSQL, Oracle, DB2…
Le paramètre « database » contient en général le nom de la base de données. Dans le cas de SQLite, il contient le chemin vers le fichier qui contient la base de données. Ce fichier n'existe pas encore, mais nous verrons plus loin comment le créer.
Le paramètre « pool » permet de déterminer le nombre de connexions à allouer pour la base de données.
Le paramètre « timeout », quant à lui, permet de déterminer, en millisecondes, le temps maximum à allouer à une requête sur la base de données.

Maintenant que la base de données est configurée, nous devons la créer. Pour cela, il suffit de taper :

rake db:create

Vous avez une application Rails fonctionnelle après avoir exécuté deux commandes seulement. Pas mal du tout ! Démarrez maintenant le serveur d'application Rails en lançant la commande :

ruby script/server

Le serveur démarre par défaut sur le port 3000. Ouvrez un navigateur Internet à l'adresse : http://localhost:3000. Voici ce que vous devriez voir :

Pour voir la page que vous venez de créer, ouvrez le navigateur à l'adresse : http://localhost:3000/home/index.

Vous voudrez probablement remplacer la page d'accueil par défaut de Rails par la page que vous venez de créer. Pour cela, vous devez supprimer le fichier index.html qui se situe dans le répertoire public :

rm public/index.html

Ensuite, vous devez configurer ce qui s'appelle les « routes », c'est-à-dire les chemins qui permettent de faire le lien entre des URL et les contrôleurs de l'application. Cela se passe dans le fichier config/routes.rb. À la fin du fichier, vous trouverez la configuration des chemins par défaut :

map.connect ':controller/:action/:id'
map.connect ':controller/:action/:id.:format'

Cela signifie que le format des URL est du style : contrôleur/action/identifiant. Par exemple, si nous voulions dans notre application de gestion des contacts supprimer un contact d'identifiant « 17 » (à compter que cette fonctionnalité soit implémentée), nous pourrions le faire via l'URL : http://localhost:3000/contacts/delete/17.

Revenons au cas de notre page par défaut. Il faut que le chemin par défaut de l'application pointe sur notre contrôleur, et plus précisément sur l'action « index ». Rajoutez ce qui suit au fichier routes.rb :

map.root :controller => "home"

Cela illustre le principe « convention over configuration » de Rails : nous n'avons pas précisé le nom de l'action dans la ligne ci-dessus, et pourtant la page d'accueil pointe bien maintenant sur home/index. Interrompez le serveur avec CTRL+C, relancez-le, et constatez le résultat en appelant http://localhost:3000.

Nous allons créer maintenant la partie données représentant les contacts de notre application. Nous ne serons pas exhaustifs, car cela fera l'objet de futurs tutoriels. Pour créer l'ensemble des fichiers nécessaires au CRUD, tapez la commande suivante :

ruby script/generate scaffold Contact name:string email:string

Nous ne verrons pas ici le détail des fichiers générés. Nous pouvons juste voir que nous avons créé une entité « Contact » avec comme attributs un nom et un email. Avant de pouvoir profiter du CRUD, nous devons d'abord créer la table correspondant à cette entité « Contact » en base de données. Pour cela, tapons la commande :

rake db:migrate

Ensuite, mettons à jour le fichier routes.rb pour qu'il pointe sur le contrôleur correspondant :

map.root :controller => "contacts"

Voici maintenant la nouvelle page d'accueil de l'application :

Cliquez sur « New contact » pour ajouter des contacts dans la liste, les modifier, les supprimer, ou encore les lister. Vous avez ici une première ébauche de l'application. Certes, ce n'est pas très personnalisé, mais vous n'avez pratiquement écrit aucune ligne de code.

La console Rails est une invite de commandes irb qui met à notre disposition toutes les classes de l'application Rails en cours. Vous pouvez donc par exemple interagir sur la base de données à volonté. Pour la lancer, il faut taper :

ruby script/console

Ensuite, vous pouvez par exemple lister les contacts existants :

>> Contact.find(:all)
 
=> #<Contact id= "1" name= "Vincent Dubois" email= "duboisv@hotmail.com" created_at= "2009-04-18 17:26:55" updated_at= "2009-04-18 17:26:55">,
#<Contact id= "2" name= "Albert Dupont" email= "adupont@mycontacts.fr" created_at= "2009-04-19 08:05:02" updated_at= "2009-04-19 08:05:02">]

Nous pouvons aisément constater que l'appel à find(:all) a ramené le jeu complet des données de la table « contacts », dans un tableau. Vous pouvez si vous le souhaitez créer des contacts :

>> my_contact = Contact.new(:name => "Pierre Martin", :email => "pm@mycontacts.fr")
=> #<Contact id= nil name= "Pierre Martin" email= "pm@mycontacts.fr" created_at= nil, updated_at= nil>
 
>> my_contact.save
=> true

Ou même en supprimer :

>> my_contact.destroy
 
=> #<Contact id= 3, name= "Pierre Martin", email= "pm@mycontacts.fr", created_at= "2009-04-19 10:02:54", updated_at= "2009-04-19 10:02:54">

Pour sortir de la console Rails, faites-le comme dans irb, avec la commande « exit ».

Voilà, vous avez les premières clés en main pour vous lancer dans l'exploration des répertoires d'une application Rails. N'hésitez pas à vous balader, aller voir le contenu des fichiers contrôleurs, des fichiers modèles, ou encore des fichiers vues, modifiez-les, observez les résultats. Bref, faites connaissance avec les possibilités de l'API Rails. Vous trouverez toute la documentation concernant cette API à l'adresse : http://api.rubyonrails.org/.

Dans le prochain chapitre, nous entrerons en profondeur dans le sujet des bases de données. Nous étudierons le composant Active Record, et plus particulièrement les migrations. Nous en profiterons pour peaufiner notre base de données.

Vous pouvez retrouver le source de ce tutoriel ici.