update route method docs

This commit is contained in:
Raphael Deem 2017-01-30 16:42:43 -08:00
parent 6d18fb6bae
commit 1501c56bbc

View File

@ -64,23 +64,37 @@ async def folder_handler(request, folder_id):
## HTTP request types ## HTTP request types
By default, a route defined on a URL will be used for all requests to that URL. By default, a route defined on a URL will be avaialble for only GET requests to that URL.
However, the `@app.route` decorator accepts an optional parameter, `methods`, However, the `@app.route` decorator accepts an optional parameter, `methods`,
which restricts the handler function to the HTTP methods in the given list. whicl allows the handler function to work with any of the HTTP methods in the list.
```python ```python
from sanic.response import text from sanic.response import text
@app.route('/post') @app.route('/post', methods=['POST'])
async def post_handler(request, methods=['POST']): async def post_handler(request):
return text('POST request - {}'.format(request.json)) return text('POST request - {}'.format(request.json))
@app.route('/get') @app.route('/get', methods=['GET'])
async def GET_handler(request, methods=['GET']): async def get_handler(request):
return text('GET request - {}'.format(request.args)) return text('GET request - {}'.format(request.args))
``` ```
There are also shorthand method decorators:
```python
from sanic.response import text
@app.post('/post')
async def post_handler(request):
return text('POST request - {}'.format(request.json))
@app.get('/get')
async def get_handler(request):
return text('GET request - {}'.format(request.args))
```
## The `add_route` method ## The `add_route` method
As we have seen, routes are often specified using the `@app.route` decorator. As we have seen, routes are often specified using the `@app.route` decorator.