Django Rest framework基础使用之 serializer

rest-framework文档地址：http://www.django-rest-framework.org/


Django Rest framework是一个非常强大且灵活的工具包，用于构建web API

选择rest framework的理由：

　　1）在线可视的API

　　2）验证策略涵盖了OAuth1a和OAuth2

　　3）同时支持ORM（对象关系映射）和非ORM数据源的序列化

　　4）大量文档及强大社区支持

1、安装：pip install djangorestframework

　　说明：如果安装coreapi的时候，出现utf-8报错，可以将虚拟环境中的Lib---->site package--->pip--->compat---__init__.py中的第75行return s.decode("utf-8")改为"gbk"，然后uninstall coreapi，再重新安装。

2、将 "rest_framework"加入到INSTALLED_APPS 设置中

3、配置url

　　from django.conf.urls import url, include

　　url(r"^api-auth/", include("rest_framework.urls"))

　　------这个url是restframework登录和登出的url，在使用浏览器API测试的时候是很有用的，如果你定义的某个接口是需要登录之后才能被调用的话。

　　from rest_framework.documentation import include_docs_urls

　　url(r"docs", include_docs_urls(title=""))

　　------配置DRF生成自动API文档

4、restframework的serializer.Serializer

　　类似于Django的Form类，可用来序列化和反序列化实例对象

　　

使用serializer序列化model实例：

　　

我们也可以用serializer来序列化querysets，序列化querysets的时候，我们需要在serializer参数中加上many=True的标志

　　

5、ModelSerializer

　　从上面的例子中可以看出来，使用Serializer在定义序列化字段的时候，写的很复杂，几乎需要把我们的mode全部复制一遍，为了减少代码量，ModelSerializer应运而生

　　同样是上面的例子，我们用ModelSerializer来重构如下：

　　

　　那么 ModelSerializer到底做了什么？通过下面这几行代码，我们可以看出来它只是通过model将字段自动关联起来了：

　　from snippets.serializers import SnippetSerializer
　　serializer = SnippetSerializer()
　　print(repr(serializer))
　　

　　我们再去看它的ModelSerializer源码，可以看到，它里面已经为我们写好了create和update函数