класс ActionController::Metal
ActionController::Metal — это самый простой контроллер, предоставляющий действительный интерфейс Rack без дополнительных удобств, предоставляемых ActionController::Base.
Пример контроллера типа «металл» может выглядеть так:
class HelloController < ActionController::Metal
def index
self.response_body = "Hello World!"
end
end
Затем, для перенаправления запросов на ваш контроллер «металл», вы добавите что-то подобное в 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
Перенаправление Вспомогательные функции
Чтобы добавить вспомогательные функции для перенаправления в свой контроллер «металл», выполните следующие действия:
class HelloController < ActionController::Metal
include ActionController::Redirecting
include Rails.application.routes.url_helpers
def index
redirect_to root_url
end
end
Другие Вспомогательные функции
Вы можете обратиться к модулям, включённым в ActionController::Base, чтобы увидеть другие возможности, которые можно добавить в свой контроллер «металл».
Публичные методы класса
# File actionpack/lib/action_controller/metal.rb, line 231
def self.action(name)
if middleware_stack.any?
middleware_stack.build(name) do |env|
req = ActionDispatch::Request.new(env)
res = make_response! req
new.dispatch(name, req, res)
end
else
lambda { |env|
req = ActionDispatch::Request.new(env)
res = make_response! req
new.dispatch(name, req, res)
}
end
end Возвращает точку входа Rack для указанного имени действия.
# File actionpack/lib/action_controller/metal.rb, line 127 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 249
def self.dispatch(name, req, res)
if middleware_stack.any?
middleware_stack.build(name) { |env| new.dispatch(name, req, res) }.call req.env
else
new.dispatch(name, req, res)
end
end Прямое выполнение контроллера. Создаёт экземпляр контроллера и выполняет действие с именем name.
# File actionpack/lib/action_controller/metal.rb, line 131
def self.make_response!(request)
ActionDispatch::Response.new.tap do |res|
res.request = request
end
end # File actionpack/lib/action_controller/metal.rb, line 226 def self.middleware middleware_stack end
Псевдоним для middleware_stack.
# File actionpack/lib/action_controller/metal.rb, line 151 def initialize @_request = nil @_response = nil @_routes = nil super end
# File actionpack/lib/action_controller/metal.rb, line 221 def self.use(*args, &block) middleware_stack.use(*args, &block) end
Добавляет указанный middleware Rack и его аргументы в конец стека middleware.
Публичные методы экземпляра
# File actionpack/lib/action_controller/metal.rb, line 142 def controller_name self.class.controller_name end
Делегирование методу класса controller_name.
# File actionpack/lib/action_controller/metal.rb, line 158 def params @_params ||= request.parameters end
# File actionpack/lib/action_controller/metal.rb, line 162 def params=(val) @_params = val end
# File actionpack/lib/action_controller/metal.rb, line 182 def performed? response_body || response.committed? end
Проверка, уже ли произошло рендеринг или перенаправление.
# File actionpack/lib/action_controller/metal.rb, line 207 def reset_session @_request.reset_session end
# File actionpack/lib/action_controller/metal.rb, line 173 def response_body=(body) body = [body] unless body.nil? || body.respond_to?(:each) response.reset_body! return unless body response.body = body super 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.