Class: ActionController::Metal
- Inherits:
-
AbstractController::Base
- Object
- AbstractController::Base
- ActionController::Metal
- Includes:
- Testing::Functional
- Defined in:
- lib/action_controller/metal.rb,
lib/action_controller/test_case.rb
Overview
ActionController::Metal
is the simplest possible controller, providing a valid Rack interface without the additional niceties provided by ActionController::Base
.
A sample metal controller might look like this:
class HelloController < ActionController::Metal
def index
self.response_body = "Hello World!"
end
end
And then to route requests to your metal controller, you would add something like this to config/routes.rb
:
get 'hello', to: HelloController.action(:index)
The action
method returns a valid Rack application for the Rails router to dispatch to.
Rendering Helpers
ActionController::Metal
by default provides no utilities for rendering views, partials, or other responses aside from explicitly calling of response_body=
, content_type=
, and status=
. To add the render helpers you’re used to having in a normal controller, you can do the following:
class HelloController < ActionController::Metal
include AbstractController::Rendering
include ActionView::Layouts
append_view_path "#{Rails.root}/app/views"
def index
render "hello/index"
end
end
Redirection Helpers
To add redirection helpers to your metal controller, do the following:
class HelloController < ActionController::Metal
include ActionController::Redirecting
include Rails.application.routes.url_helpers
def index
redirect_to root_url
end
end
Other Helpers
You can refer to the modules included in ActionController::Base
to see other features you can bring into your metal controller.
Class Method Summary collapse
-
.action(name) ⇒ Object
Returns a Rack endpoint for the given action name.
-
.binary_params_for?(action) ⇒ Boolean
:nodoc:.
-
.controller_name ⇒ Object
Returns the last part of the controller’s name, underscored, without the ending
Controller
. -
.dispatch(name, req, res) ⇒ Object
Direct dispatch to the controller.
-
.inherited(base) ⇒ Object
:nodoc:.
- .make_response!(request) ⇒ Object
-
.middleware ⇒ Object
Alias for
middleware_stack
. -
.use(*args, &block) ⇒ Object
Pushes the given Rack middleware and its arguments to the bottom of the middleware stack.
Instance Method Summary collapse
-
#controller_name ⇒ Object
Delegates to the class’
controller_name
. -
#dispatch(name, request, response) ⇒ Object
:nodoc:.
-
#initialize ⇒ Metal
constructor
A new instance of Metal.
- #params ⇒ Object
- #params=(val) ⇒ Object
-
#performed? ⇒ Boolean
Tests if render or redirect has already happened.
- #reset_session ⇒ Object
- #response_body=(body) ⇒ Object
-
#set_request!(request) ⇒ Object
:nodoc:.
-
#set_response!(response) ⇒ Object
:nodoc:.
-
#to_a ⇒ Object
:nodoc:.
-
#url_for(string) ⇒ Object
Basic url_for that can be overridden for more robust functionality.
Methods included from Testing::Functional
Methods inherited from AbstractController::Base
abstract!, action_methods, #action_methods, #action_name, #available_action?, clear_action_methods!, #controller_path, controller_path, #formats, internal_methods, method_added, #process, #response_body, supports_path?
Constructor Details
#initialize ⇒ Metal
Returns a new instance of Metal.
153 154 155 156 157 158 |
# File 'lib/action_controller/metal.rb', line 153 def initialize @_request = nil @_response = nil @_routes = nil super end |
Class Method Details
.action(name) ⇒ Object
Returns a Rack endpoint for the given action name.
232 233 234 235 236 237 238 239 240 241 242 243 244 |
# File 'lib/action_controller/metal.rb', line 232 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 |
.binary_params_for?(action) ⇒ Boolean
:nodoc:
139 140 141 |
# File 'lib/action_controller/metal.rb', line 139 def self.binary_params_for?(action) # :nodoc: false end |
.controller_name ⇒ Object
Returns the last part of the controller’s name, underscored, without the ending Controller
. For instance, PostsController returns posts
. Namespaces are left out, so Admin::PostsController returns posts
as well.
Returns
-
string
129 130 131 |
# File 'lib/action_controller/metal.rb', line 129 def self.controller_name @controller_name ||= name.demodulize.sub(/Controller$/, "").underscore end |
.dispatch(name, req, res) ⇒ Object
Direct dispatch to the controller. Instantiates the controller, then executes the action named name
.
248 249 250 251 252 253 254 |
# File 'lib/action_controller/metal.rb', line 248 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 |
.inherited(base) ⇒ Object
:nodoc:
215 216 217 218 |
# File 'lib/action_controller/metal.rb', line 215 def self.inherited(base) # :nodoc: base.middleware_stack = middleware_stack.dup super end |
.make_response!(request) ⇒ Object
133 134 135 136 137 |
# File 'lib/action_controller/metal.rb', line 133 def self.make_response!(request) ActionDispatch::Response.new.tap do |res| res.request = request end end |
.middleware ⇒ Object
Alias for middleware_stack
.
227 228 229 |
# File 'lib/action_controller/metal.rb', line 227 def self.middleware middleware_stack end |
.use(*args, &block) ⇒ Object
Pushes the given Rack middleware and its arguments to the bottom of the middleware stack.
222 223 224 |
# File 'lib/action_controller/metal.rb', line 222 def self.use(*args, &block) middleware_stack.use(*args, &block) end |
Instance Method Details
#controller_name ⇒ Object
Delegates to the class’ controller_name
.
144 145 146 |
# File 'lib/action_controller/metal.rb', line 144 def controller_name self.class.controller_name end |
#dispatch(name, request, response) ⇒ Object
:nodoc:
188 189 190 191 192 193 194 |
# File 'lib/action_controller/metal.rb', line 188 def dispatch(name, request, response) #:nodoc: set_request!(request) set_response!(response) process(name) request.commit_flash to_a end |
#params ⇒ Object
160 161 162 |
# File 'lib/action_controller/metal.rb', line 160 def params @_params ||= request.parameters end |
#params=(val) ⇒ Object
164 165 166 |
# File 'lib/action_controller/metal.rb', line 164 def params=(val) @_params = val end |
#performed? ⇒ Boolean
Tests if render or redirect has already happened.
184 185 186 |
# File 'lib/action_controller/metal.rb', line 184 def performed? response_body || response.committed? end |
#reset_session ⇒ Object
209 210 211 |
# File 'lib/action_controller/metal.rb', line 209 def reset_session @_request.reset_session end |
#response_body=(body) ⇒ Object
175 176 177 178 179 180 181 |
# File 'lib/action_controller/metal.rb', line 175 def response_body=(body) body = [body] unless body.nil? || body.respond_to?(:each) response.reset_body! return unless body response.body = body super end |
#set_request!(request) ⇒ Object
:nodoc:
200 201 202 203 |
# File 'lib/action_controller/metal.rb', line 200 def set_request!(request) #:nodoc: @_request = request @_request.controller_instance = self end |
#set_response!(response) ⇒ Object
:nodoc:
196 197 198 |
# File 'lib/action_controller/metal.rb', line 196 def set_response!(response) # :nodoc: @_response = response end |
#to_a ⇒ Object
:nodoc:
205 206 207 |
# File 'lib/action_controller/metal.rb', line 205 def to_a #:nodoc: response.to_a end |
#url_for(string) ⇒ Object
Basic url_for that can be overridden for more robust functionality.
171 172 173 |
# File 'lib/action_controller/metal.rb', line 171 def url_for(string) string end |