класс ActiveSupport::ExecutionWrapper

Родитель:: Объект
Включённые модули:: ActiveSupport::Callbacks

Атрибуты

active[RW]

Публичные методы класса

register_hook(hook, outer: false) Показать исходный код

# File activesupport/lib/active_support/execution_wrapper.rb, line 49
def self.register_hook(hook, outer: false)
  if outer
    to_run RunHook.new(hook), prepend: true
    to_complete :after, CompleteHook.new(hook)
  else
    to_run RunHook.new(hook)
    to_complete CompleteHook.new(hook)
  end
end

Зарегистрировать объект для вызова во время run и complete шагов.

hook.complete будет передан значением, возвращённым hook.run, и будет вызван только в том случае, если run был вызван ранее. (В основном, это означает, что он не будет вызван, если в предыдущем to_run блоке возникнет исключение; все обычные to_complete блоки вызываются в этой ситуации.)

run!() Показать исходный код

# File activesupport/lib/active_support/execution_wrapper.rb, line 65
def self.run!
  if active?
    Null
  else
    new.tap do |instance|
      success = nil
      begin
        instance.run!
        success = true
      ensure
        instance.complete! unless success
      end
    end
  end
end

Запустить это выполнение.

Возвращает экземпляр, метод complete! которого обязательно должен быть вызван после выполнения работы.

Если возможно, предпочтительно использовать wrap.

to_complete(*args, &block) Показать исходный код

# File activesupport/lib/active_support/execution_wrapper.rb, line 20
def self.to_complete(*args, &block)
  set_callback(:complete, *args, &block)
end

to_run(*args, &block) Показать исходный код

# File activesupport/lib/active_support/execution_wrapper.rb, line 16
def self.to_run(*args, &block)
  set_callback(:run, *args, &block)
end

wrap() { || ... } Показать исходный код

# File activesupport/lib/active_support/execution_wrapper.rb, line 82
def self.wrap
  return yield if active?

  instance = run!
  begin
    yield
  ensure
    instance.complete!
  end
end

Выполнить работу в предоставленном блоке в качестве выполнения.

Публичные методы экземпляра

complete!() Показать исходный код

# File activesupport/lib/active_support/execution_wrapper.rb, line 117
def complete!
  run_callbacks(:complete)
ensure
  self.class.active.delete Thread.current
end

Завершить текущее выполнение. Этот метод обязательно должен быть вызван ровно один раз на результате любого вызова run!.

Если возможно, предпочтительно использовать wrap.