mirror of
https://github.com/sinatra/sinatra
synced 2023-03-27 23:18:01 -04:00
Document body and status helper methods. Fixes #146.
This commit is contained in:
parent
08d568217b
commit
9a22d7c81c
1 changed files with 27 additions and 0 deletions
27
README.rdoc
27
README.rdoc
|
@ -762,6 +762,33 @@ A route can punt processing to the next matching route using <tt>pass</tt>:
|
|||
The route block is immediately exited and control continues with the next
|
||||
matching route. If no matching route is found, a 404 is returned.
|
||||
|
||||
=== Setting body and status
|
||||
|
||||
It is possible and recommended to set the status code and response body with the
|
||||
return value of the route block. However, in some scenarios you might want to
|
||||
set the body at an arbritary point in the execution flow. You can do so with the
|
||||
`body` helper method. If you do so, you can use that method from there on to
|
||||
access the body:
|
||||
|
||||
get '/foo' do
|
||||
body "bar"
|
||||
end
|
||||
|
||||
after do
|
||||
puts body
|
||||
end
|
||||
|
||||
It is also possible to pass a block to body, that will be executed by the rack
|
||||
handler (this can be used to implement streaming, see
|
||||
[Return values](#Return%20values)).
|
||||
|
||||
Similar to the body, you can also set the status code:
|
||||
|
||||
get '/foo' do
|
||||
status 418
|
||||
halt "I'm a tea pot!"
|
||||
end
|
||||
|
||||
=== Accessing the Request Object
|
||||
|
||||
The incoming request object can be accessed from request level (filter, routes, error handlers) through the `request` method:
|
||||
|
|
Loading…
Reference in a new issue