класс 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, к которому он должен обращаться.
Helpers
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
Перенаправление Helpers
Чтобы добавить помощники перенаправления в свой контроллер металл, выполните следующие действия:
class HelloController < ActionController::Metal
include ActionController::Redirecting
include Rails.application.routes.url_helpers
def index
redirect_to root_url
end
end
Другие Helpers
Вы можете обратиться к модулям, включённым в ActionController::Base, чтобы увидеть другие возможности, которые вы можете добавить в свой контроллер металл.
Публичные методы класса
# File actionpack/lib/action_controller/metal.rb, line 234
def self.action(name)
app = lambda { |env|
req = ActionDispatch::Request.new(env)
res = make_response! req
new.dispatch(name, req, res)
}
if middleware_stack.any?
middleware_stack.build(name, app)
else
app
end
end Возвращает точку входа Rack для заданного имени действия.
# File actionpack/lib/action_controller/metal.rb, line 128
def self.controller_name
@controller_name ||= (name.demodulize.delete_suffix("Controller").underscore unless anonymous?)
end Возвращает последнюю часть имени контроллера, соединённую нижним подчеркиванием, без заключительной части Controller. Например, PostsController возвращает posts. Пространства имён пропускаются, поэтому Admin::PostsController возвращает posts также.
Возвращает
-
string
# File actionpack/lib/action_controller/metal.rb, line 250
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 132
def self.make_response!(request)
ActionDispatch::Response.new.tap do |res|
res.request = request
end
end # File actionpack/lib/action_controller/metal.rb, line 229 def self.middleware middleware_stack end
Псевдоним для middleware_stack.
# File actionpack/lib/action_controller/metal.rb, line 152 def initialize @_request = nil @_response = nil @_routes = nil super end
# File actionpack/lib/action_controller/metal.rb, line 222 def use(*args, &block) middleware_stack.use(*args, &block) end
Добавляет указанный middleware Rack и его аргументы в конец стека middleware.
Публичные методы экземпляра
# File actionpack/lib/action_controller/metal.rb, line 143 def controller_name self.class.controller_name end
Делегирует вызов к методу класса controller_name.
# File actionpack/lib/action_controller/metal.rb, line 159 def params @_params ||= request.parameters end
# File actionpack/lib/action_controller/metal.rb, line 163 def params=(val) @_params = val end
# File actionpack/lib/action_controller/metal.rb, line 183 def performed? response_body || response.committed? end
Проверяет, был ли уже выполнен рендеринг или перенаправление.
# File actionpack/lib/action_controller/metal.rb, line 208 def reset_session @_request.reset_session end
# File actionpack/lib/action_controller/metal.rb, line 174 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 170 def url_for(string) string end
Базовый url_for, который можно переопределить для более функционального использования.
© 2004–2020 David Heinemeier Hansson
Licensed under the MIT License.