7554e87374
Whoops! Totally missed that all the links pointed to `.html` files instead of `.md` files
83 lines
2.2 KiB
Markdown
83 lines
2.2 KiB
Markdown
# Class-Based Views
|
|
|
|
Class-based views are simply classes which implement response behaviour to
|
|
requests. They provide a way to compartmentalise handling of different HTTP
|
|
request types at the same endpoint. Rather than defining and decorating three
|
|
different handler functions, one for each of an endpoint's supported request
|
|
type, the endpoint can be assigned a class-based view.
|
|
|
|
## Defining views
|
|
|
|
A class-based view should subclass `HTTPMethodView`. You can then implement
|
|
class methods for every HTTP request type you want to support. If a request is
|
|
received that has no defined method, a `405: Method not allowed` response will
|
|
be generated.
|
|
|
|
To register a class-based view on an endpoint, the `app.add_route` method is
|
|
used. The first argument should be the defined class with the method `as_view`
|
|
invoked, and the second should be the URL endpoint.
|
|
|
|
The available methods are `get`, `post`, `put`, `patch`, and `delete`. A class
|
|
using all these methods would look like the following.
|
|
|
|
```python
|
|
from sanic import Sanic
|
|
from sanic.views import HTTPMethodView
|
|
from sanic.response import text
|
|
|
|
app = Sanic('some_name')
|
|
|
|
class SimpleView(HTTPMethodView):
|
|
|
|
def get(self, request):
|
|
return text('I am get method')
|
|
|
|
def post(self, request):
|
|
return text('I am post method')
|
|
|
|
def put(self, request):
|
|
return text('I am put method')
|
|
|
|
def patch(self, request):
|
|
return text('I am patch method')
|
|
|
|
def delete(self, request):
|
|
return text('I am delete method')
|
|
|
|
app.add_route(SimpleView.as_view(), '/')
|
|
|
|
```
|
|
|
|
## URL parameters
|
|
|
|
If you need any URL parameters, as discussed in the routing guide, include them
|
|
in the method definition.
|
|
|
|
```python
|
|
class NameView(HTTPMethodView):
|
|
|
|
def get(self, request, name):
|
|
return text('Hello {}'.format(name))
|
|
|
|
app.add_route(NameView.as_view(), '/<name>')
|
|
```
|
|
|
|
## Decorators
|
|
|
|
If you want to add any decorators to the class, you can set the `decorators`
|
|
class variable. These will be applied to the class when `as_view` is called.
|
|
|
|
```
|
|
class ViewWithDecorator(HTTPMethodView):
|
|
decorators = [some_decorator_here]
|
|
|
|
def get(self, request, name):
|
|
return text('Hello I have a decorator')
|
|
|
|
app.add_route(ViewWithDecorator.as_view(), '/url')
|
|
```
|
|
|
|
**Previous:** [Blueprints](blueprints.md)
|
|
|
|
**Next:** [Cookies](cookies.md)
|