класс ActionController::Metal
ActionController::Metal — это контроллер с минимальными настройками, предоставляющий интерфейс Rack без дополнительных возможностей, предоставляемых ActionController::Base.
Пример контроллера типа metal может выглядеть так:
class HelloController < ActionController::Metal
def index
self.response_body = "Hello World!"
end
end
А затем, чтобы направить запросы в ваш контроллер metal, добавьте что-то подобное в config/routes.rb:
get 'hello', to: HelloController.action(:index)
Метод action возвращает валидное приложение Rack для маршрутизатора Rails, к которому оно будет перенаправлено.
Вспомогательные методы рендеринга
ActionController::Metal по умолчанию не предоставляет утилиты для рендеринга представлений, частичных представлений или других ответов, кроме явного вызова response_body=, content_type=, и status=. Чтобы добавить привычные вспомогательные методы рендеринга обычного контроллера, выполните следующие действия:
class HelloController < ActionController::Metal
include AbstractController::Rendering
include ActionView::Layouts
append_view_path "#{Rails.root}/app/views"
def index
render "hello/index"
end
end
Перенаправление Вспомогательные методы
Чтобы добавить вспомогательные методы перенаправления в ваш контроллер metal, выполните следующие действия:
class HelloController < ActionController::Metal
include ActionController::Redirecting
include Rails.application.routes.url_helpers
def index
redirect_to root_url
end
end
Другие Вспомогательные методы
Вы можете обратиться к модулям, включённым в ActionController::Base, чтобы узнать о других возможностях, которые вы можете добавить в свой контроллер metal.
Публичные методы класса
# File actionpack/lib/action_controller/metal.rb, line 231
def self.action(name, klass = ActionDispatch::Request)
if middleware_stack.any?
middleware_stack.build(name) do |env|
new.dispatch(name, klass.new(env))
end
else
lambda { |env| new.dispatch(name, klass.new(env)) }
end
end Возвращает точку входа Rack для заданного имени действия.
# File actionpack/lib/action_controller/metal.rb, line 225 def self.call(env) req = ActionDispatch::Request.new env action(req.path_parameters[:action]).call(env) end
Превращает контроллер в точку входа Rack, которая выполняет действие в заданном ключе env объекта action_dispatch.request.path_parameters.
# File actionpack/lib/action_controller/metal.rb, line 113 def self.controller_name @controller_name ||= name.demodulize.sub(/Controller$/, '').underscore end
Возвращает последнюю часть имени контроллера, с подчёркиванием, без окончания Controller. Например, PostsController возвращает posts. Имена пространств имён опушены, поэтому Admin::PostsController возвращает posts также.
Возвращает
-
string
# File actionpack/lib/action_controller/metal.rb, line 219 def self.middleware middleware_stack end
Псевдоним для middleware_stack.
# File actionpack/lib/action_controller/metal.rb, line 131
def initialize
@_headers = {"Content-Type" => "text/html"}
@_status = 200
@_request = nil
@_response = nil
@_routes = nil
super
end # File actionpack/lib/action_controller/metal.rb, line 214 def self.use(*args, &block) middleware_stack.use(*args, &block) end
Добавляет заданный middleware Rack и его аргументы в нижнюю часть стека middleware.
Общедоступные методы экземпляра
# File actionpack/lib/action_controller/metal.rb, line 156 def content_type headers["Content-Type"] end
# File actionpack/lib/action_controller/metal.rb, line 152 def content_type=(type) headers["Content-Type"] = type.to_s end
Предлагаются базовые реализации для #content_type=, location=, и headers, чтобы снизить зависимость от модуля RackDelegation в Renderer и Redirector.
# File actionpack/lib/action_controller/metal.rb, line 118 def controller_name self.class.controller_name end
Делегирует вызов классу controller_name
# File actionpack/lib/action_controller/metal.rb, line 103
def env
@_env ||= {}
end # File actionpack/lib/action_controller/metal.rb, line 160 def location headers["Location"] end
# File actionpack/lib/action_controller/metal.rb, line 164 def location=(url) headers["Location"] = url end
# File actionpack/lib/action_controller/metal.rb, line 140 def params @_params ||= request.parameters end
# File actionpack/lib/action_controller/metal.rb, line 144 def params=(val) @_params = val end
# File actionpack/lib/action_controller/metal.rb, line 188 def performed? response_body || (response && response.committed?) end
Проверяет, уже произошёл рендер или переадресация.
# File actionpack/lib/action_controller/metal.rb, line 182 def response_body=(body) body = [body] unless body.nil? || body.respond_to?(:each) super end
# File actionpack/lib/action_controller/metal.rb, line 173 def status @_status end
# File actionpack/lib/action_controller/metal.rb, line 178 def status=(status) @_status = Rack::Utils.status_code(status) end
# File actionpack/lib/action_controller/metal.rb, line 169 def url_for(string) string end
Базовый #url_for, который можно переопределить для более расширенной функциональности
© 2004–2018 David Heinemeier Hansson
Licensed under the MIT License.