Django provides several decorators that can be applied to views to support various HTTP features.
Allowed HTTP methods¶
The decorators in django.views.decorators.http can be used to restrict access to views based on the request method. These decorators will return a django.http.HttpResponseNotAllowed if the conditions are not met.
This decorator is used to ensure that a view only accepts particular request methods. Usage:
from django.views.decorators.http import require_http_methods @require_http_methods(["GET", "POST"]) def my_view(request): # I can assume now that only GET or POST requests make it this far # ... pass
Note that request methods should be in uppercase.
Decorator to require that a view only accept the GET method.
Decorator to require that a view only accept the POST method.
Conditional view processing¶
The following decorators in django.views.decorators.http can be used to control caching behavior on particular views.
These decorators can be used to generate ETag and Last-Modified headers; see conditional view processing.
The decorators in django.views.decorators.gzip control content compression on a per-view basis.
This decorator compresses content if the browser allows gzip compression. It sets the Vary header accordingly, so that caches will base their storage on the Accept-Encoding header.
Having trouble? We'd like to help!
- Try the FAQ — it's got answers to many common questions.
- Search for information in the archives of the django-users mailing list, or post a question.
- Ask a question in the #django IRC channel, or search the IRC logs to see if it has been asked before.
- If you notice errors with this documentation, please open a ticket and let us know! Please only use the ticket tracker for criticisms and improvements on the docs. For tech support, use the resources above.