Django REST framework 简介

1. 在序列化与反序列化时，虽然操作的数据不尽相同，但是执行的过程却是相似的，也就是说这部分代码是可以复用简化编写的。
2. 在开发REST API的视图中，虽然每个视图具体操作的数据不同，但增、删、改、查的实现流程基本套路化，所以这部分代码也是可以复用简化编写的：
   • 增：校验请求数据 -> 执行反序列化过程 -> 保存数据库 -> 将保存的对象序列化并返回
   • 删：判断要删除的数据是否存在 -> 执行数据库删除
   • 改：判断要修改的数据是否存在 -> 校验请求的数据 -> 执行反序列化过程 -> 保存数据库 -> 将保存的对象序列化并返回
   • 查：查询数据库 -> 将数据序列化并返回

 Django REST framework 框架是一个用于构建Web API 的强大而又灵活的工具。帮助我们简化开发REST API的工作。DRF框架是建立在Django框架基础之上，由Tom Christie大牛二次开发的开源项目。

特点

• 提供了定义序列化器Serializer的方法，可以快速根据 Django ORM 或者其它库自动序列化/反序列化；
• 提供了丰富的类视图、Mixin扩展类，简化视图的编写；
• 丰富的定制层级：函数视图、类视图、视图集合到自动生成 API，满足各种需要；
• 多种身份认证和权限认证方式的支持；
• 内置了限流系统；
• 直观的 API web 界面；
• 可扩展性，插件丰富

官方文档：http://www.django-rest-framework.org/

Github源码：https://github.com/encode/django-rest-framework/tree/master

DRF工程搭建

DRF是以Django扩展应用的方式提供的，所以我们可以直接利用已有的Django环境而无需从新创建。（若没有Django环境，需要先创建环境安装Django）

 1. 安装DRF

pip install djangorestframework

2. 添加rest_framework应用

利用在Django框架创建的工程，在settings.py的INSTALLED_APPS中添加‘rest_framework‘。

INSTALLED_APPS = [
    ...
    ‘rest_framework‘,
]

3. 创建序列化器

Django REST framework中的Serializer使用类来定义，须继承自rest_framework.serializers.Serializer。

例如，我们已有了一个数据库模型类BookInfo

class BookInfo(models.Model):
    btitle = models.CharField(max_length=20, verbose_name=‘名称‘)
    bpub_date = models.DateField(verbose_name=‘发布日期‘, null=True)
    bread = models.IntegerField(default=0, verbose_name=‘阅读量‘)
    bcomment = models.IntegerField(default=0, verbose_name=‘评论量‘)
    image = models.ImageField(upload_to=‘booktest‘, verbose_name=‘图片‘, null=True)

(1)定义Serializer

在index应用中新建serializers.py用于保存该应用的序列化器。

创建一个BookInfoSerializer用于序列化与反序列化。

class BookInfoSerializer(serializers.Serializer):
    """图书数据序列化器"""
    id = serializers.IntegerField(label=‘ID‘, read_only=True)
    btitle = serializers.CharField(label=‘名称‘, max_length=20)
    bpub_date = serializers.DateField(label=‘发布日期‘, required=False)
    bread = serializers.IntegerField(label=‘阅读量‘, required=False)
    bcomment = serializers.IntegerField(label=‘评论量‘, required=False)
    image = serializers.ImageField(label=‘图片‘, required=False)
    class Meta:
        model = BookInfo
        fields = ‘__all__‘

• model 指明该序列化器处理的数据字段从模型类BookInfo参考生成
• fields 指明该序列化器包含模型类中的哪些字段，‘__all__‘指明包含所有字段

注意：serializer不是只能为数据库模型类定义，也可以为非数据库模型类的数据定义。serializer是独立于数据库之外的存在。

(2)字段与选项

常用字段类型：

选项参数：

通用参数：

4. 编写视图

 在index应用的views.py中创建视图BookInfoViewSet，这是一个视图集合。

from rest_framework.viewsets import ModelViewSet
from .serializers import BookInfoSerializer
from .models import BookInfo

class BookInfoViewSet(ModelViewSet):
    queryset = BookInfo.objects.all()
    serializer_class = BookInfoSerializer

• queryset 指明该视图集在查询数据时使用的查询集
• serializer_class 指明该视图在进行序列化或反序列化时使用的序列化器

5. 定义路由

在booktest应用的urls.py中定义路由信息。

from . import views
from rest_framework.routers import DefaultRouter

urlpatterns = [
    ...
]

router = DefaultRouter()  # 可以处理视图的路由器
router.register(r‘books‘, views.BookInfoViewSet)  # 向路由器中注册视图集

urlpatterns += router.urls  # 将路由器中的所以路由信息追到到django的路由列表中

6. 运行测试

运行当前程序（与运行Django一样）

python manage.py runserver

在浏览器中输入网址127.0.0.1:8000，可以看到DRF提供的API Web浏览页面：

1）点击链接127.0.0.1:8000/books/ 可以访问获取所有数据的接口，呈现如下页面：

 2）在页面底下表单部分填写图书信息，可以访问添加新图书的接口，保存新书：

点击POST后，返回如下页面信息：

3）在浏览器中输入网址127.0.0.1:8000/books/1/，可以访问获取单一图书信息的接口（id为1的图书），呈现如下页面：

4）在页面底部表单中填写图书信息，可以访问修改图书的接口：

 点击PUT，返回如下页面信息：

 5）点击DELETE按钮，可以访问删除图书的接口：

返回，如下页面：