Délégation avec Forwardable

Fait partie de la section Programmation orientée objet du Journey Ruby de Coddy. Leçon 46 sur 57.

La délégation signifie qu’un objet confie une partie de son travail à un objet qu’il contient, au lieu d’en hériter. Une playlist qui contient un tableau de chansons est plus sûre qu’une playlist qui est un tableau, car le code extérieur n’accède qu’aux méthodes que vous choisissez de transférer :

class Playlist
  def initialize
    @songs = []
  end

  def add(song)
    @songs << song
    self
  end

  def size
    @songs.size
  end

  def first
    @songs.first
  end
end

list = Playlist.new.add("Intro").add("Dune")
puts list.size
puts list.first

Sortie :

2
Intro

Écrire chaque méthode de transfert à la main est répétitif. La bibliothèque standard Forwardable s’en charge : extend Forwardable, puis def_delegators :@songs, :size, :first transfère ces appels à l’objet contenu dans @songs :

require 'forwardable'

class Playlist
  extend Forwardable
  def_delegators :@songs, :size, :first, :last, :empty?, :include?

  def initialize
    @songs = []
  end

  def add(song)
    @songs << song
    self
  end
end

list = Playlist.new.add("Intro").add("Dune")
puts "#{list.size} #{list.first} #{list.last}"
puts list.include?("Dune")
puts list.empty?

Sortie :

2 Intro Dune
true
false

def_delegator :@songs, :push, :add transmet une méthode sous un nouveau nom. L’objet conserve le contrôle total de tout ce qu’il ne transmet pas, par exemple delete ou clear :

require 'forwardable'

class Queue2
  extend Forwardable
  def_delegator :@jobs, :push, :enqueue
  def_delegator :@jobs, :shift, :next_job
  def_delegators :@jobs, :size

  def initialize
    @jobs = []
  end
end

q = Queue2.new
q.enqueue("a")
q.enqueue("b")
puts q.next_job
puts q.size
puts q.respond_to?(:clear)

Résultat :

a
1
false

Préférez la délégation (« a un ») lorsqu’une classe n’a besoin que d’une partie du comportement d’une autre classe. Hériter de Array exposerait des dizaines de méthodes, telles que clear et delete_at, qui pourraient enfreindre les règles de la playlist :

class Playlist < Array      # toutes les méthodes d'Array sont publiques, y compris clear
end

class Playlist              # seul ce que vous déléguez est public
  extend Forwardable
  def_delegators :@songs, :size, :each
end

Défi

Facile

Complétez la classe Playlist avec Forwardable. Elle contient des chansons, chacune étant une paire [title, seconds], dans @songs. Déléguez size, empty? et first avec def_delegators, et déléguez push sous le nom add avec def_delegator. Sa propre méthode duration renvoie la durée totale au format m:ss, et titles renvoie les titres joints par , .

Le code fourni ajoute une chanson pour chaque ligne d’entrée (title,seconds) avec add, puis affiche la taille, le premier titre, les titres, la durée et si la playlist répond à clear.

Votre code doit être placé dans playlist.rb. main.rb contient le code d’entrée/sortie fourni et ne peut pas être modifié.

Essayez vous-même

require_relative 'playlist'

# Code d'entrée/sortie fourni : gardez-le tel quel
input = []
while (line = gets)
  input << line.chomp
end
list = Playlist.new
input.each do |line|
  title, seconds = line.split(",")
  list.add([title, seconds.to_i])
end
puts "songs: #{list.size}"
puts "first: #{list.empty? ? "none" : list.first[0]}"
puts "titles: #{list.titles}"
puts "duration: #{list.duration}"
puts "can clear: #{list.respond_to?(:clear)}"