ExpertiDict

Ruby · Avançado · Inglês · Técnico

included hook

/ɪnˈkludəd hʊk/método de gancho

Método de classe que o Ruby chama no módulo logo depois de ele ser incluído em uma classe, recebendo essa classe. Permite estendê-la com extend, validações ou configuração.

Onde usar

Aparece em mixins que precisam adicionar métodos de classe junto com os de instância, padrão que o ActiveSupport::Concern automatiza.

Em código

module Rastreavel
  def self.included(base)
    puts "#{self} em #{base}"
  end
end
class Pedido
  include Rastreavel
end  # => Rastreavel em Pedido

Exemplos

The module extends the class in its included hook.

O módulo estende a classe no seu hook included.

Concern is a shortcut for the included hook pattern.

O Concern é um atalho para o padrão do hook included.

Cuidado

Não o confunda com include, o método que de fato inclui; included é só o gancho chamado depois e se define com def self.included.

Sinônimos

callback de inclusão

Veja também

Todos os termos de Ruby