drf (学习第二部)

目录

http请求处理

请求与响应

Response

常用属性

状态码

http请求处理

drf除了在数据序列化部分简写代码之外,还在视图中提供了简写操作.所以在Django原有的Django.views.View类基础上,def封装了多个视图子类出来提供给我我们使用.

DjangoREST framwork 提供的视图的主要作用:

• 控制序列化器的执行( 检验 ,保存 , 转换数据 ) 
• 控制数据库查询的执行
• 调用情趣类和响应类 ( 这俩个类也是由drf 帮我们再次扩展了一些功能类 ) 

为了方便我们的学习,所以先创建一个子应用req

python manage.py startapp req

注册子应用:

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',

    # 注册 rest_framework　的子应用
    'rest_framework',

    'students',
    'sers',
    'unsers',
    'homework',
    'req',     # 请求与响应
]

注册路由:

# 子应用路由
from django.urls import path
from . import views
urlpatterns = [

]


# 总路由
from django.contrib import admin
from django.urls import path,include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('students/', include("students.urls")),
    path('sers/', include("sers.urls")),
    path('unsers/', include("unsers.urls")),
    path('req/', include("req.urls")),
]

请求与响应

Request

REST framework 传入视图的 request对象不再是django 默认的HttPREQuser对象,而是RESTframework 提供的扩展了HttpRequest类的Request类的对象.

REST framework 提供了Parser 解释器, 在接收到请求后自动根据Content-Type指明的请求数据类型( 如JSON,表单等) 将请求数据进行Parse解析, 解析为类字典( Query Dict) 对象保存到Request对象中.

Request对象的数据是自动根据前端发送的数据的格式进行解析之后的结果.

无论前端发送的那种格式的数据, 我们都可以以统一的方式读取数据.

常用属性

1 )  .data

request.data 返回解析之后的< mark> 请求体</mark>数据.类似于Django中标准的 request>POST 和 request.FILES 属性, 提供如下特性:

• 包含了解释器之后的文件和非文件数据
• 包含了对POST,PUT ,PATCH请求方式解析后的数据
• 利用了REST framework 的怕热色人生解析器 不仅支持表单类型的数据,也支持JSON数据

2 ) .query_params

request.query_params 返回解析之后的<mark>查询字符串</mark>数据

request.query_params 与Django标准的 requestGET相同,只是更换了正确的名称而已.

Response

rest_framework.response.Response

REST framework提供了一个相应类 Response,使用该类构造响应对象时, 响应的具体数据内容会被转换( render 渲染器 ) 成符合前端需求的类型.

REST framework 提供了 Render而渲染器 用来根据请求头中的 Accept ( 请求数据类型声明) 来自动转换响应数据到对应格式. 如果前端请求中未进行Accept声明,则会采用默认方式处理响应数据,我们可以通过配置来修改默认响应格式. ( 简而言之, 就是Render而能通过请求找到Accept查询出客户端支持和希望的数据类型, 把视图的结果以客户端能识别的格式返回 ) 

可以在rest_framework.settings.py查找所有的drf默认配置项

REST_FRAMEWORK = {
    'DEFAULT_RENDERER_CLASSES': (  # 默认响应渲染类
        'rest_framework.renderers.JSONRenderer',  # json渲染器
        'rest_framework.renderers.BrowsableAPIRenderer',  # 浏览器API渲染器
    )
}

构造方式

Response(data, status=None, template_name=None, headers=None, content_type=None)

data数据不要是render处理之后的数据, 只需要传递Python的内建类型数据即可,REST framework会使用 Render而渲染器处理data.

data不能是复杂结构的数据, 如Django的模型类对象,对于这样的数据我们可以使用 serializer 序列化器序列化处理后 ( 转为Python字典类型 ) 再传递给data参数.

参数说明:

• data:为响应准备的序列化处理后的数据
• status: 状态码 ,默认200 
• template_name: 模板名称, 如果使用HTMLRenderer 时需要指明
• headers_ type: 响应数据的Content_Type, 通常此参数无需传递,REST framework 会根据前端所需要类型数据来设置该参数.

常用属性

1  ) .data 

传给response对象的序列化后, 但尚未render处理的数据

2  ) .status_code

状态码的数据

3  ) .comtent

经过render处理的响应数据

状态码

 为了方便状态码,REST framework在 rest-framework.status 模块中提供了常用的状态码常量.

1 ) 消息告知 -1xx

HTTP_100_CONTINUE
HTTP_101_SWITCHING_PROTOCOLS

2  0 成功 -2xx

HTTP_200_OK
HTTP_201_CREATED
HTTP_202_ACCEPTED
HTTP_203_NON_AUTHORITATIVE_INFORMATION
HTTP_204_NO_CONTENT
HTTP_205_RESET_CONTENT
HTTP_206_PARTIAL_CONTENT
HTTP_207_MULTI_STATUS

3  ) 重定向 -3xx

HTTP_300_MULTIPLE_CHOICES
HTTP_301_MOVED_PERMANENTLY
HTTP_302_FOUND
HTTP_303_SEE_OTHER
HTTP_304_NOT_MODIFIED
HTTP_305_USE_PROXY
HTTP_306_RESERVED
HTTP_307_TEMPORARY_REDIRECT

4   ) 客户端错误 -4xx

HTTP_400_BAD_REQUEST
HTTP_401_UNAUTHORIZED
HTTP_402_PAYMENT_REQUIRED
HTTP_403_FORBIDDEN
HTTP_404_NOT_FOUND
HTTP_405_METHOD_NOT_ALLOWED
HTTP_406_NOT_ACCEPTABLE
HTTP_407_PROXY_AUTHENTICATION_REQUIRED
HTTP_408_REQUEST_TIMEOUT
HTTP_409_CONFLICT
HTTP_410_GONE
HTTP_411_LENGTH_REQUIRED
HTTP_412_PRECONDITION_FAILED
HTTP_413_REQUEST_ENTITY_TOO_LARGE
HTTP_414_REQUEST_URI_TOO_LONG
HTTP_415_UNSUPPORTED_MEDIA_TYPE
HTTP_416_REQUESTED_RANGE_NOT_SATISFIABLE
HTTP_417_EXPECTATION_FAILED
HTTP_422_UNPROCESSABLE_ENTITY
HTTP_423_LOCKED
HTTP_424_FAILED_DEPENDENCY
HTTP_428_PRECONDITION_REQUIRED
HTTP_429_TOO_MANY_REQUESTS
HTTP_431_REQUEST_HEADER_FIELDS_TOO_LARGE
HTTP_451_UNAVAILABLE_FOR_LEGAL_REASONS

5   ) 服务器错误  -5xx

HTTP_500_INTERNAL_SERVER_ERROR
HTTP_501_NOT_IMPLEMENTED
HTTP_502_BAD_GATEWAY
HTTP_503_SERVICE_UNAVAILABLE
HTTP_504_GATEWAY_TIMEOUT
HTTP_505_HTTP_VERSION_NOT_SUPPORTED
HTTP_507_INSUFFICIENT_STORAGE
HTTP_511_NETWORK_AUTHENTICATION_REQUIRED