Represents an HTTP response generated by a controller action. One can use
an ActionController::AbstractResponse
object to retrieve the current state of the response, or customize the
response. An AbstractResponse object
can either represent a "real" HTTP response (i.e. one that is
meant to be sent back to the web browser) or a test response (i.e. one that
is generated from integration tests). See CgiResponse and TestResponse, respectively.
AbstractResponse is mostly a Ruby on Rails framework implement detail, and should never
be used directly in controllers. Controllers should use the methods defined
in ActionController::Base instead. For example, if
you want to set the HTTP response‘s content MIME type, then use
ActionControllerBase#headers instead of AbstractResponse#headers.
Nevertheless, integration tests may want to inspect controller responses in
more detail, and that‘s when AbstractResponse can be useful for
application developers. Integration test methods such as
ActionController::Integration::Session#get and
ActionController::Integration::Session#post return objects of type TestResponse (which are of course also of type
AbstractResponse).
For example, the following demo integration "test" prints the
body of the controller response to the console:
class DemoControllerTest < ActionController::IntegrationTest
def test_print_root_path_to_console
get('/')
puts @response.body
end
end