Présentation de Ruby On Rails

1) Architecture de Ruby On Rails :

Voici d'abord un schéma donnant une bonne idée du fonctionnement dynamique de Ruby On Rails :

2) Fonctionnalités transverses :

2.1) Gestion des pluriels, les inflexions :

La liste des exceptions par défaut aux règles de calcul des pluriels se trouve dans le fichier source de ROR :

active_support/inflections.rb

On peut rajouter des exceptions dans le fichier : config/initializers/inflections.rb :
Avec des instructions de la forme :

inflect.plural(<sing>, <plur>)
inflect.singular(<plur>, <sing>)
inflect.irregular(<sing>, <plur>)

#exemples :
inflect.irregular 'categorie', 'categories'
#génère l'inflexion suivante : (?i-mx:(c)ategorie$)		\1ategories

#Les instructions suivantes ne marchent pas : une règle générale prends le pas
#inflect.singular 'categories', 'categorie'
#inflect.plural 'categorie', 'categories'

3) Schéma de recherche des méthods Rails :

Le schéma suivant pourra vous aider à comprendre comment surcharger dynamiquement des classes / modules de Rails.

4) RailRoad - Génération de schémas représentant les Modèles et les Contrôleurs :

Cet outil peut vous aider à avoir une idée générale des Modèles et Contrôleurs de votre application.

Installation :

gem install railroad

#avec un système Unix :
ln -s /var/lib/gems/1.8/bin/railroad /usr/bin/

#installation de graphviz et de ses dépendances pour gérér le format dot
aptitude install graphviz

Correction d'une anomalie :

application

application_controller

/var/lib/gems/1.8/gems/railroad-0.5.0/lib/railroad/controllers_diagram.rb

portage vers Rails 1.9.1+ :

1) dans <RUBY_1.9.1+_ROOT>/gems/railroad-0.5.0/lib/railroad/app_diagram.rb

PALTFORM

RAILS_PLATFORM

2) dans <RUBY_1.9.1+_ROOT>gems/ruby-1.9.2-p136@global/gems/railroad-0.5.0/bin/railroad

$: << "."

...
COPYRIGHT      = "Copyright (C) 2007-2008 Javier Smaldone"

$: << "."

require 'railroad/options_struct'
...

Préparation :

Rake

#fichier : lib/task/diagrams.rake

namespace :doc do
	namespace :diagram do
		task :models do
			sh "railroad -i -l -a -m -M | dot -Tsvg | sed 's/font-size:14.00/font-size:11.00/g' >doc/models.svg"
		end

		task :controllers do
			sh "railroad -i -l -C | neato -Tsvg | sed 's/font-size:14.00/font-size:11.00/g' >doc/controllers.svg"
		end

		task :diagrams => %w(diagram:models diagram:controllers)
	end
end

Utilisation :

rake doc:diagrams

doc/models.svg
doc/controllers.svg