Maîtriser le système de modules Ruby : `include` vs. `extend`

Le système de modules de Ruby est un outil puissant pour l’organisation du code et sa réutilisabilité. Deux méthodes clés, include et extend, permettent d’incorporer les fonctionnalités d’un module dans des classes, mais elles le font de manière fondamentalement différente. Cet article clarifie leurs distinctions et vous guide dans le choix de la méthode appropriée à vos besoins.

Table des matières

• Comprendre include en Ruby
• Comprendre extend en Ruby
• Quand utiliser include vs. extend
• Conclusion
• FAQ

Comprendre include en Ruby

La méthode include intègre les méthodes d’un module dans les instances d’une classe. Chaque objet créé à partir de la classe héritera et pourra utiliser ces méthodes.

module Sayable
  def speak(message)
    puts message
  end
end

class Dog
  include Sayable
end

sparky = Dog.new
sparky.speak("Woof!") # => Woof!

Dans cet exemple, les instances de Dog, comme sparky, obtiennent la méthode speak grâce à include.

Comprendre extend en Ruby

extend, inversement, ajoute les méthodes d’un module directement à la classe elle-même, et non à ses instances. Ces méthodes sont appelables sur la classe mais pas sur les objets individuels créés à partir de cette classe.

module Growlable
  def growl
    puts "Grrrr!"
  end
end

class Cat
  extend Growlable
end

Cat.growl # => Grrrr!
whiskers = Cat.new
# whiskers.growl  # => NoMethodError: undefined method 'growl' for #<Cat:0x...>

Seule la classe Cat peut appeler growl ; whiskers, une instance de Cat, ne le peut pas.

Quand utiliser include vs. extend

La décision dépend entièrement de savoir si vous avez besoin de méthodes accessibles au niveau des instances ou au niveau de la classe.

• Utiliser include lorsque : vous ajoutez des méthodes qui doivent être disponibles pour chaque objet (instance) de la classe. Il s’agit du cas d’utilisation le plus courant. Pensez à ajouter des comportements ou des fonctionnalités à des objets individuels.
• Utiliser extend lorsque : vous ajoutez des méthodes qui opèrent sur la classe elle-même, telles que les méthodes de niveau classe (par exemple, les méthodes d’usine), ou les méthodes qui modifient le comportement de la classe. Ces méthodes n’ont généralement pas besoin d’accéder aux variables d’instance.

Conclusion

include et extend sont tous deux des outils précieux dans l’arsenal de Ruby. Comprendre leurs comportements distincts — méthodes de niveau instance versus méthodes de niveau classe — est crucial pour écrire du code propre, maintenable et efficace. Le choix de la bonne approche a un impact significatif sur la conception et la lisibilité du code.

FAQ

• Peut-on extend plusieurs modules ? Oui, étendre plusieurs modules ajoute leurs méthodes à la classe.
• Peut-on include et extend le même module ? Oui, fournissant ainsi des méthodes de niveau instance et de niveau classe à partir de ce module.
• Que se passe-t-il si les modules définissent des méthodes du même nom ? Le dernier module inclus ou étendu l’emporte ; sa méthode remplace les autres (méthode de remplacement).
• Y a-t-il des implications sur les performances ? Les différences de performance sont généralement négligeables. Privilégiez la conception du code aux optimisations de performance mineures.