- Request与Response
request是DRF扩展的Request类的对象,由于DRF自带Parser解析器,会自动根据Content-Type指明的请求数据类型(如JSON、表单等)将请求数据进行parse解析,解析为类字典对象保存到request中
常用属性:data(解析后请求体数据),表单数据或者json数据
query_params (一般为解析后url参数),和django中request.GET一致
response是DRF扩展的Response类的对象,由于DRF自带Renderer渲染器,会根据Accept(接受数据类型声明)自动转换响应数据到对应格式,如果未声明则使用默认方式,可配置修改默认响应格式。
构造:Response(data, status=None, template_name=None, headers=None, content_type=None)
data:序列化处理后的数据 status:状态码,默认200
template_name:模板名称,如使用HTMLRenderer需指明
headers:头部信息字段 content_type:无需传递,会根据前端所需类型数据自动设置
常用属性:data(序列化后数据,但没render)
status_code 响应状态码 ,rest_framework.status模块中提供了常用状态码常量。
content(render后响应数据)
视图基类(APIView)
D:REST framework提供的所有视图的基类,继承自Django的View父类。
①传入视图方法的参数是DRF的Request对象,非Django中HttpRequest对象
②视图方法可返回DRF的Response对象,会自动render满足符合前端要求格式
③会捕获任何APIException异常,处理成合适的响应信息
④在dispatch()分发前,会对请求进行身份认证、权限检查、流量控制。
支持定义的属性:
authentication_classes 列表或元祖,身份认证类
permissoin_classes 列表或元祖,权限检查类
throttle_classes 列表或元祖,流量控制类
注意:在APIView还可以使用常规类视图定义get,post方法
GenericAPIView
D:继承自APIView,增加列表视图和详情视图,使用时搭配Mixin扩展类
支持定义的属性:
列表视图与详情视图通用:
- queryset 列表视图的查询集
- serializer_class 视图使用的序列化器
列表视图使用:
- pagination_class 分页控制类
- filter_backends 过滤控制后端
详情页视图使用:
- lookup_field 查询单一数据库对象时使用的条件字段,默认为'pk'
- lookup_url_kwarg 查询单一数据时URL中的参数关键字名称,默认与
look_field相同
提供的方法
列表视图与详情视图通用:
- get_queryset(self) 返回视图使用的查询集
- get_serializer_class(self) 返回序列化器类
- get_serializer(self, args, *kwargs) 返回序列化器对象,被其他视图或扩展类使用
注意:在提供序列化器对象的时候,REST framework会向对象的context属性补充三个数据:request、format、view,这三个数据对象可以在定义序列化器时使用。
详情视图使用:
- get_object(self) 返回详情视图所需的模型类数据对象
注意:若详情访问的模型类对象不存在,会返回404,
该方法会默认使用APIView提供的check_object_permissions方法检查当前对象是否有权限被访问。
视图集(ViewSet)
D:把一系列的业务操作放在同一个视图类去实现,,不再提供get,post方法,而是实现了action方法,通过在as_view方法走哪个将action方法和具体请求方式进行绑定
U:
1.视图类中自带了以下几种方法
- list() 提供一组数据
- retrieve() 提供单个数据
- create() 创建数据
- update() 保存数据
- destory() 删除数据
2.设置路由绑定
urlpatterns = [ url(r'^xx/$', xxViewSet.as_view({'get':'list'}), url(r'^xx/(?P<pk>\d+)/$', xxViewSet.as_view({'get': 'retrieve'})]
3.还可以自定义action方法,例如
定义视图类
class xxViewSet(ViewSet): def latest(self, request): pass def name(self, request, pk): pass
路由
urlpatterns = [ url(r'^xx/latest/', views.xxViewSet.as_view({'get': 'latest'})), url(r'^xx/(?P<pk>\d+)/name/$', views.xxViewSet.as_view({'put': 'name'})),]
|
|