модуль 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.