Django REST Framework框架

Django REST Framework框架

【1】概述

Django REST Framework（简称DRF）是基于Django Web框架的一个开源的Web API框架。它提供了一组用于快速构建Web API的工具和库，包括序列化器、认证、权限、视图、路由和文档化等功能。

DRF的主要特点包括：

• 提供了强大的序列化器，可以将模型对象序列化为JSON等格式，并支持反序列化

• 提供了多种认证方式，包括基本认证、Token认证、OAuth认证等

• 提供了多种权限校验方式，包括基于角色的权限校验、基于对象的权限校验等

• 提供了多种视图类，包括基于函数的视图、基于类的视图、通用视图等

• 提供了路由功能，可以轻松地将URL映射到对应的视图

• 可扩展性，插件丰富

DRF官方：https://www.django-rest-framework.org/

GitHub：https://github.com/encode/django-rest-framework

【2】安装DRF框架

DRF框架依赖于Django，需先安装Django环境。

pip install djangorestframework

【3】注册DRF

在Django项目中使用DRF框架进行开发时，需要将rest_framework在INSTALLED_APPS中进行注册。

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'task_api',
    'Api01',
    'Api02',
    'rest_framework',
]
'
运行
运行

字段类型与选项参数

【1】字段类型

【2】选项参数

max_length和min_length是针对字符串类型的参数；max_value和min_value是针对数字类型的参数。

无论哪种字段类型都可以使用以下可选参数。

定义序列化器类的字段时，如果没有指定read_only和write_only，则这两个参数默认值都为False，表明对应的字段既在序列化时使用，也在反序列化时使用

【3】常见字段参数

• 除了CharField以外，还要很多别的—>表模中 models.CharField ----> 基本–对应
• 如果跟 表模型中对不上，统一用CharField

#1 字段类上，有参数，他们作用是做反序列化校验的  max_length...
#2 通用字段参数：
required	表明该字段在反序列化时必须输入，默认True
default	    反序列化时使用的默认值
allow_null	表明该字段是否允许传入None，默认False
validators	该字段使用的验证器--》字段自己的校验[1 max_lenght 2 validators ]，局部钩子，全局钩子 
	name=serializer.CharField(validators=[valida_name])

error_messages	包含错误编号与错误信息的字典

label	用于HTML展示API页面时，显示的字段名称
help_text	用于HTML展示API页面时，显示的字段帮助提示信息

'''             -------非常重要------
read_only	表明该字段仅用于序列化输出，默认False
write_only	表明该字段仅用于反序列化输入，默认False      '''

# 3 CharField
max_length	最大长度
min_lenght	最小长度
allow_blank	是否允许为空
trim_whitespace	是否截断空白字符

# 4 IntegerField
max_value	最小值
min_value	最大值

写一个data_name验证器

​ 验证器可以应用于任何您想要验证的字段上，包括 task_time、task_id 和 task_name。您可以在需要的任何字段上使用这个验证器，以确保输入的数据符合您的要求。

​ 通过将验证器应用于多个字段，您可以在不同的字段上共享相同的验证逻辑，从而实现代码的重用和简化。这种方式使得在整个序列化器中保持一致的验证逻辑变得更加容易。

from rest_framework import serializers
from rest_framework.exceptions import ValidationError

def data_name(name):
    if name.startswith('shi'):
        raise ValidationError('不能用shi开头')
    else:
        return name

class TaskSerializer(serializers.Serializer):
    # required=False表明该字段在反序列化时必须输入，默认True
    # allow_null	表明该字段是否允许传入None，默认False
    # default	    反序列化时使用的默认值
    task_name = serializers.CharField(required=False,allow_null=True,default='默认字段',validators=[data_name])
    task_id = serializers.CharField(max_length=64,validators=[data_name])
    task_time = serializers.DateTimeField()