модуль ActiveSupport::LazyLoadHooks

Механизмы отложенной загрузки

LazyLoadHooks позволяет Rails откладывать загрузку многих компонентов, что ускоряет запуск приложения. Благодаря этому, теперь нет необходимости подключать ActiveRecord::Base во время запуска для применения конфигурации. Вместо этого регистрируется обработчик, который применяет конфигурацию после загрузки ActiveRecord::Base. Здесь ActiveRecord::Base используется в качестве примера, но этот механизм можно применить и в других местах.

Вот пример, где вызывается метод on_load для регистрации обработчика.

initializer 'active_record.initialize_timezone' do
  ActiveSupport.on_load(:active_record) do
    self.time_zone_aware_attributes = true
    self.default_timezone = :utc
  end
end

Когда весь ActiveRecord::Base будет обработан, вызывается run_load_hooks. Последняя строка в ActiveRecord::Base выглядит так:

ActiveSupport.run_load_hooks(:active_record, ActiveRecord::Base)

run_load_hooks затем выполнит все обработчики, зарегистрированные с помощью метода on_load. В приведенном выше примере это будет блок кода в initializer.

Регистрация обработчика, который уже выполнен, приводит к его немедленному выполнению. Это позволяет вкладывать обработчики для кода, зависящего от нескольких компонентов, загружаемых с отложением:

initializer "action_text.renderer" do
  ActiveSupport.on_load(:action_controller_base) do
    ActiveSupport.on_load(:action_text_content) do
      self.default_renderer = Class.new(ActionController::Base).renderer
    end
  end
end

Методы экземпляра

on_load(name, options = {}, &block) Показать исходный код

# File activesupport/lib/active_support/lazy_load_hooks.rb, line 60
def on_load(name, options = {}, &block)
  @loaded[name].each do |base|
    execute_hook(name, base, options, block)
  end

  @load_hooks[name] << [block, options]
end

Объявляет блок, который будет выполнен при полной загрузке компонента Rails. Если компонент уже загружен, блок выполняется немедленно.

Опции:

:yield - Возвращает объект, к которому run_load_hooks обращается, чтобы block.
:run_once - В данном случае block выполнится только один раз.

run_load_hooks(name, base = Object) Показать исходный код

# File activesupport/lib/active_support/lazy_load_hooks.rb, line 75
def run_load_hooks(name, base = Object)
  @loaded[name] << base
  @load_hooks[name].each do |hook, options|
    execute_hook(name, base, options, hook)
  end
end

Выполняет все блоки, зарегистрированные для name через on_load, используя base в качестве контекста выполнения.

ActiveSupport.run_load_hooks(:active_record, ActiveRecord::Base)

В случае вышеуказанного примера, будут выполнены все обработчики, зарегистрированные для :active_record внутри класса ActiveRecord::Base.