Active Support Concern

Типичный модуль выглядит так:

module M
  def self.included(base)
    base.extend ClassMethods
    base.class_eval do
      scope :disabled, -> { where(disabled: true) }
    end
  end

  module ClassMethods
    ...
  end
end

Используя ActiveSupport::Concern вышеуказанный модуль можно переписать следующим образом:

require "active_support/concern"

module M
  extend ActiveSupport::Concern

  included do
    scope :disabled, -> { where(disabled: true) }
  end

  class_methods do
    ...
  end
end

Кроме того, он корректно обрабатывает зависимости модулей. Предположим, есть модуль Foo и модуль Bar, который зависит от первого. Обычно мы записываем следующее:

module Foo
  def self.included(base)
    base.class_eval do
      def self.method_injected_by_foo
        ...
      end
    end
  end
end

module Bar
  def self.included(base)
    base.method_injected_by_foo
  end
end

class Host
  include Foo # We need to include this dependency for Bar
  include Bar # Bar is the module that Host really needs
end

Но почему Host должен заботиться о зависимостях Bar, а именно о Foo? Мы могли бы попытаться скрыть их от Host, напрямую включая Foo в Bar:

module Bar
  include Foo
  def self.included(base)
    base.method_injected_by_foo
  end
end

class Host
  include Bar
end

К сожалению, это не сработает, так как при включении Foo, его base — это модуль Bar, а не класс Host. С ActiveSupport::Concern, зависимости модулей корректно разрешаются:

require "active_support/concern"

module Foo
  extend ActiveSupport::Concern
  included do
    def self.method_injected_by_foo
      ...
    end
  end
end

module Bar
  extend ActiveSupport::Concern
  include Foo

  included do
    self.method_injected_by_foo
  end
end

class Host
  include Bar # It works, now Bar takes care of its dependencies
end

Префиксные зависимости

Как и include, зависимости также поддерживают prepend с соответствующим prepended do обратным вызовом. module ClassMethods или class_methods do также предваряются.

prepend также используется для любых зависимостей.