mirror of
https://github.com/encode/django-rest-framework.git
synced 2024-11-23 01:57:00 +03:00
Update generic view documentation
This commit is contained in:
parent
27935f6f66
commit
1ceca69e5f
|
@ -49,21 +49,21 @@ For very simple cases you might want to pass through any class attributes using
|
||||||
|
|
||||||
The following classes are the concrete generic views. If you're using generic views this is normally the level you'll be working at unless you need heavily customized behavior.
|
The following classes are the concrete generic views. If you're using generic views this is normally the level you'll be working at unless you need heavily customized behavior.
|
||||||
|
|
||||||
|
## CreateAPIView
|
||||||
|
|
||||||
|
Used for **create-only** endpoints.
|
||||||
|
|
||||||
|
Provides `post` method handlers.
|
||||||
|
|
||||||
|
Extends: [GenericAPIView], [CreateModelMixin]
|
||||||
|
|
||||||
## ListAPIView
|
## ListAPIView
|
||||||
|
|
||||||
Used for **read-only** endpoints to represent a **collection of model instances**.
|
Used for **read-only** endpoints to represent a **collection of model instances**.
|
||||||
|
|
||||||
Provides a `get` method handler.
|
Provides a `get` method handler.
|
||||||
|
|
||||||
Extends: [MultipleObjectBaseAPIView], [ListModelMixin]
|
Extends: [MultipleObjectAPIView], [ListModelMixin]
|
||||||
|
|
||||||
## ListCreateAPIView
|
|
||||||
|
|
||||||
Used for **read-write** endpoints to represent a **collection of model instances**.
|
|
||||||
|
|
||||||
Provides `get` and `post` method handlers.
|
|
||||||
|
|
||||||
Extends: [MultipleObjectBaseAPIView], [ListModelMixin], [CreateModelMixin]
|
|
||||||
|
|
||||||
## RetrieveAPIView
|
## RetrieveAPIView
|
||||||
|
|
||||||
|
@ -71,7 +71,31 @@ Used for **read-only** endpoints to represent a **single model instance**.
|
||||||
|
|
||||||
Provides a `get` method handler.
|
Provides a `get` method handler.
|
||||||
|
|
||||||
Extends: [SingleObjectBaseAPIView], [RetrieveModelMixin]
|
Extends: [SingleObjectAPIView], [RetrieveModelMixin]
|
||||||
|
|
||||||
|
## DestroyAPIView
|
||||||
|
|
||||||
|
Used for **delete-only** endpoints for a **single model instance**.
|
||||||
|
|
||||||
|
Provides a `delete` method handler.
|
||||||
|
|
||||||
|
Extends: [SingleObjectAPIView], [DestroyModelMixin]
|
||||||
|
|
||||||
|
## UpdateAPIView
|
||||||
|
|
||||||
|
Used for **update-only** endpoints for a **single model instance**.
|
||||||
|
|
||||||
|
Provides a `put` method handler.
|
||||||
|
|
||||||
|
Extends: [SingleObjectAPIView], [UpdateModelMixin]
|
||||||
|
|
||||||
|
## ListCreateAPIView
|
||||||
|
|
||||||
|
Used for **read-write** endpoints to represent a **collection of model instances**.
|
||||||
|
|
||||||
|
Provides `get` and `post` method handlers.
|
||||||
|
|
||||||
|
Extends: [MultipleObjectAPIView], [ListModelMixin], [CreateModelMixin]
|
||||||
|
|
||||||
## RetrieveDestroyAPIView
|
## RetrieveDestroyAPIView
|
||||||
|
|
||||||
|
@ -79,15 +103,15 @@ Used for **read or delete** endpoints to represent a **single model instance**.
|
||||||
|
|
||||||
Provides `get` and `delete` method handlers.
|
Provides `get` and `delete` method handlers.
|
||||||
|
|
||||||
Extends: [SingleObjectBaseAPIView], [RetrieveModelMixin], [DestroyModelMixin]
|
Extends: [SingleObjectAPIView], [RetrieveModelMixin], [DestroyModelMixin]
|
||||||
|
|
||||||
## RetrieveUpdateDestroyAPIView
|
## RetrieveUpdateDestroyAPIView
|
||||||
|
|
||||||
Used for **read-write** endpoints to represent a **single model instance**.
|
Used for **read-write-delete** endpoints to represent a **single model instance**.
|
||||||
|
|
||||||
Provides `get`, `put` and `delete` method handlers.
|
Provides `get`, `put` and `delete` method handlers.
|
||||||
|
|
||||||
Extends: [SingleObjectBaseAPIView], [RetrieveModelMixin], [UpdateModelMixin], [DestroyModelMixin]
|
Extends: [SingleObjectAPIView], [RetrieveModelMixin], [UpdateModelMixin], [DestroyModelMixin]
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
@ -121,7 +145,7 @@ The mixin classes provide the actions that are used to provide the basic view be
|
||||||
|
|
||||||
Provides a `.list(request, *args, **kwargs)` method, that implements listing a queryset.
|
Provides a `.list(request, *args, **kwargs)` method, that implements listing a queryset.
|
||||||
|
|
||||||
Should be mixed in with [MultipleObjectBaseAPIView].
|
Should be mixed in with [MultipleObjectAPIView].
|
||||||
|
|
||||||
## CreateModelMixin
|
## CreateModelMixin
|
||||||
|
|
||||||
|
@ -133,19 +157,19 @@ Should be mixed in with any [BaseAPIView].
|
||||||
|
|
||||||
Provides a `.retrieve(request, *args, **kwargs)` method, that implements returning an existing model instance in a response.
|
Provides a `.retrieve(request, *args, **kwargs)` method, that implements returning an existing model instance in a response.
|
||||||
|
|
||||||
Should be mixed in with [SingleObjectBaseAPIView].
|
Should be mixed in with [SingleObjectAPIView].
|
||||||
|
|
||||||
## UpdateModelMixin
|
## UpdateModelMixin
|
||||||
|
|
||||||
Provides a `.update(request, *args, **kwargs)` method, that implements updating and saving an existing model instance.
|
Provides a `.update(request, *args, **kwargs)` method, that implements updating and saving an existing model instance.
|
||||||
|
|
||||||
Should be mixed in with [SingleObjectBaseAPIView].
|
Should be mixed in with [SingleObjectAPIView].
|
||||||
|
|
||||||
## DestroyModelMixin
|
## DestroyModelMixin
|
||||||
|
|
||||||
Provides a `.destroy(request, *args, **kwargs)` method, that implements deletion of an existing model instance.
|
Provides a `.destroy(request, *args, **kwargs)` method, that implements deletion of an existing model instance.
|
||||||
|
|
||||||
Should be mixed in with [SingleObjectBaseAPIView].
|
Should be mixed in with [SingleObjectAPIView].
|
||||||
|
|
||||||
[cite]: https://docs.djangoproject.com/en/dev/ref/class-based-views/#base-vs-generic-views
|
[cite]: https://docs.djangoproject.com/en/dev/ref/class-based-views/#base-vs-generic-views
|
||||||
[MultipleObjectMixin]: https://docs.djangoproject.com/en/dev/ref/class-based-views/mixins-multiple-object/
|
[MultipleObjectMixin]: https://docs.djangoproject.com/en/dev/ref/class-based-views/mixins-multiple-object/
|
||||||
|
@ -153,9 +177,9 @@ Should be mixed in with [SingleObjectBaseAPIView].
|
||||||
[multiple-object-mixin-classy]: http://ccbv.co.uk/projects/Django/1.4/django.views.generic.list/MultipleObjectMixin/
|
[multiple-object-mixin-classy]: http://ccbv.co.uk/projects/Django/1.4/django.views.generic.list/MultipleObjectMixin/
|
||||||
[single-object-mixin-classy]: http://ccbv.co.uk/projects/Django/1.4/django.views.generic.detail/SingleObjectMixin/
|
[single-object-mixin-classy]: http://ccbv.co.uk/projects/Django/1.4/django.views.generic.detail/SingleObjectMixin/
|
||||||
|
|
||||||
[BaseAPIView]: #baseapiview
|
[GenericAPIView]: #genericapiview
|
||||||
[SingleObjectBaseAPIView]: #singleobjectbaseapiview
|
[SingleObjectAPIView]: #singleobjectapiview
|
||||||
[MultipleObjectBaseAPIView]: #multipleobjectbaseapiview
|
[MultipleObjectAPIView]: #multipleobjectapiview
|
||||||
[ListModelMixin]: #listmodelmixin
|
[ListModelMixin]: #listmodelmixin
|
||||||
[CreateModelMixin]: #createmodelmixin
|
[CreateModelMixin]: #createmodelmixin
|
||||||
[RetrieveModelMixin]: #retrievemodelmixin
|
[RetrieveModelMixin]: #retrievemodelmixin
|
||||||
|
|
Loading…
Reference in New Issue
Block a user