Spec-Zone.ru › Ruby on Rails 6.0

класс AbstractController::Base

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

AbstractController::Base — это API низкого уровня. Никто не должен использовать его напрямую, и ожидается, что подклассы (например, ActionController::Base) предоставят собственный render метод, так как отображение имеет разное значение в зависимости от контекста.

Атрибуты

abstract[R]
abstract?[R]

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

abstract!() Показать исходный код
# File actionpack/lib/abstract_controller/base.rb, line 40
def abstract!
  @abstract = true
end

Определить контроллер как абстрактный. См. ::internal_methods для получения более подробной информации.

action_methods() Показать исходный код
# File actionpack/lib/abstract_controller/base.rb, line 74
def action_methods
  @action_methods ||= begin
    # All public instance methods of this class, including ancestors
    methods = (public_instance_methods(true) -
      # Except for public instance methods of Base and its ancestors
      internal_methods +
      # Be sure to include shadowed public instance methods of this class
      public_instance_methods(false))

    methods.map!(&:to_s)

    methods.to_set
  end
end

Список имён методов, которые следует рассматривать как действия. Это включает все публичные методы экземпляра контроллера, за вычетом внутренних методов (см. ::internal_methods), с добавлением обратно любых методов, которые являются внутренними, но всё ещё существуют в классе.

Возвращает

  • Set — множество всех методов, которые следует рассматривать как действия.

clear_action_methods!() Показать исходный код
# File actionpack/lib/abstract_controller/base.rb, line 92
def clear_action_methods!
  @action_methods = nil
end

Методы ::action_methods кэшируются, и иногда необходимо их обновить. ::clear_action_methods! позволяет это сделать, так что в следующий раз при выполнении ::action_methods, они будут пересчитаны.

controller_path() Показать исходный код
# File actionpack/lib/abstract_controller/base.rb, line 106
def controller_path
  @controller_path ||= name.sub(/Controller$/, "").underscore unless anonymous?
end

Возвращает полное имя контроллера, с подчеркиванием, без окончания «Controller».

class MyApp::MyPostsController < AbstractController::Base

end

MyApp::MyPostsController.controller_path # => "my_app/my_posts"

Возвращает

  • String

internal_methods() Показать исходный код
# File actionpack/lib/abstract_controller/base.rb, line 59
def internal_methods
  controller = self

  controller = controller.superclass until controller.abstract?
  controller.public_instance_methods(true)
end

Список всех внутренних методов контроллера. Этот метод находит первый абстрактный суперкласс контроллера и получает список всех публичных методов экземпляра этого абстрактного класса. Публичные методы экземпляра контроллера обычно считаются методами действия, поэтому методы, объявленные в абстрактных классах, удаляются. (ActionController::Metal и ActionController::Base определены как абстрактные)

method_added(name) Показать исходный код
# File actionpack/lib/abstract_controller/base.rb, line 111
def method_added(name)
  super
  clear_action_methods!
end

Обновить кэшированные ::action_methods при добавлении нового метода действия.

Вызывает метод суперкласса
supports_path?() Показать исходный код
# File actionpack/lib/abstract_controller/base.rb, line 174
def self.supports_path?
  true
end

Возвращает true, если данный контроллер может отобразить путь. Подкласс AbstractController::Base может вернуть false. Например, контроллер Email не поддерживает пути, а только полные URL.

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

action_methods() Показать исходный код
# File actionpack/lib/abstract_controller/base.rb, line 145
def action_methods
  self.class.action_methods
end

Делегирует вызов к методу класса ::action_methods

action_name() Показать исходный код
# File actionpack/lib/abstract_controller/base.rb, line 25
attr_internal :action_name

Возвращает имя действия, обрабатываемого этим контроллером.

available_action?(action_name) Показать исходный код
# File actionpack/lib/abstract_controller/base.rb, line 159
def available_action?(action_name)
  _find_action_name(action_name)
end

Возвращает true, если метод для действия доступен и может быть обработан, иначе false.

Обратите внимание, что action_methods.include?("foo") может вернуть false, а available_action?("foo") возвращает true, потому что этот метод учитывает действия, которые также доступны другими способами, например, неявные.

Параметры

  • action_name — имя действия, подлежащего проверке

controller_path() Показать исходный код
# File actionpack/lib/abstract_controller/base.rb, line 140
def controller_path
  self.class.controller_path
end

Делегирует вызов к методу класса ::controller_path

formats() Показать исходный код
# File actionpack/lib/abstract_controller/base.rb, line 29
attr_internal :formats

Возвращает форматы, которые могут быть обработаны контроллером.

performed?() Показать исходный код
# File actionpack/lib/abstract_controller/base.rb, line 166
def performed?
  response_body
end

Проверяет, установлено ли тело ответа. Используется для определения того, нужно ли завершать обратный вызов process_action в AbstractController::Callbacks.

process(action, *args) Показать исходный код
# File actionpack/lib/abstract_controller/base.rb, line 127
def process(action, *args)
  @_action_name = action.to_s

  unless action_name = _find_action_name(@_action_name)
    raise ActionNotFound, "The action '#{action}' could not be found for #{self.class.name}"
  end

  @_response_body = nil

  process_action(action_name, *args)
end

Вызывает действие, проходя через весь стек обработки действий.

Фактический вызываемый метод определяется вызовом method_for_action. Если метод не может обработать действие, то генерируется ошибка AbstractController::ActionNotFound.

Возвращает

  • self

response_body() Показать исходный код
# File actionpack/lib/abstract_controller/base.rb, line 21
attr_internal :response_body

Возвращает тело HTTP-ответа, отправленного контроллером.

© 2004–2019 David Heinemeier Hansson
Licensed under the MIT License.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API