Django REST framework 笔记
- GitHub
- 不立不破
- 关于我
- 工具篇
- GitBook 使用经验
- 2017
- 11 月
- Flask 命令行接口
- 10 月
- 《七武士》
- 9 月
- 10 行 HTML 实现 AR 效果
- 5 月
- git hook 简单介绍
- 4 月
- Django Channels
- 为什么 Python 被设计为带有 GIL？
- 3 月
- 剑与禅的碰撞──《浪客行》
- pip 与 Pipfile
- 《成人女性的动画时间》观感（未完）
- 攻壳机动队（Ghost in the Shell）系列作品简介
- 启用 SQLite JSON1 和 FTS5 扩展
- Linux kernel 代码中最奇怪的提交记录
- 2 月
- 使用 Homebrew
- 1 月
- 使用 ffmpeg 转换视频格式
- 11 月
- 2016
- 12 月
- 《你的名字。》观后感
- 使用 autossh 建立反向 SSH 连接
- 用命令行创建字符图案
- 在 Ubuntu 上安装 Sensu 和 Uchiwa
- 11 月
- 在 iTerm2 中查看图片
- 使用 YeoMan 快速创建项目
- 10 月
- 日本动画推荐
- 9 月
- 在 docker 中运行 Jupyter notebook
- Python 与 ES6
- NotImplemented 和 NotImpementedError
- 8 月
- 使用 Rocket.Chat 作为团队 IM
- Linux、Windows 和 Mac
- Python 中的元类（metaclass）
- Emacs 入门
- PostgreSQL 与 trigram 算法
- 表单提交该用什么 Content-Type？
- Python 是如何寻找包的？
- netdata 安装小记
- macOS 的一些独有命令行程序
- 7 月
- PostgreSQL 复杂数据类型的支持
- PostgreSQL 中的视图
- 6 月
- 使用 Let's Encrypt 为网站提供 HTTPS 服务
- git 简单配置
- PostgreSQL 简介及其生态
- 5 月
- Django-REST-framework 学习笔记
- 使用 docker 托管 PostgreSQL＋PostGIS
- 使用和配置 Tmux
- JS 中 void 的正确用法
- 4 月
- PostgreSQL 索引类型
- 2 月
- Vue.js 学习笔记
- 写给 Python 程序员看的 Rust 介绍
- 1 月
- git 简单教程
- git 周边支持
- Sentry 入门
- Django 自定义 User model
- 12 月
- 2015
- 2月
- Docker 速成
- 3月
- Python 3 的变化
- Pony ORM 的秘密
- Flask 与 Tornado 的路由定义
- 招聘贴中的那些坑
- WebSocket
- 4月
- 选择 Vagrant 还是 Docker？
- Python 中的方法绑定
- Python 中魔术方法
- Python future 库
- 5月
- Docker 最佳实践
- Django 和 Flask 中的类视图
- 乒乓
- IPython 与 jupyter 概念介绍
- 6月
- Quine
- 开始学习 Ruby！
- 7月
- Python encoding 原理及应用
- 侦测 Python web 应用中的僵尸代码
- 8月
- DyanmoDB 使用经验
- PostgreSQL 连接认证方式
- 闪烁的 git 提交信息
- Python 中的赋值
- 9月
- Redis 入门
- Python functools 库
- Filco Majestouch 2 Convertible 拆解
- 安装 IHaskell
- 12月
- 使用 AWS CLI
- 使用 AWS S3 服务
- 简单介绍 AWS
- 2月
- Python
- ACG
- 谈谈“物语”系列动画
- 黑客帝国动画版 The Animatrix
- （转载）庵野秀明的 anime style
- 乒乓
- （备份）竹取物语
- 十二国记
- （备份）十二国记之无责任地理考证
- （备份）十二国无责任考证之王宫篇
- （备份）十二国无责任考证之首都篇
- （备份）十二国无责任考证之四：国名篇
- Pages
- Mac 下常用 GUI 应用
- Mac 下常用 CLI 应用
- Chrome 常用插件
- 样式指南
- 使用 EditorConfig 统一编辑器设置
- 友情链接
- 我的链接
- GitHub
- 简历
- Python One to Many
- 本书使用 GitBook 发布
Django-REST-framework 学习笔记
Django REST framework 笔记
Django REST framework（以下简称 DRF）是一个开源的 Django 扩展，提供了便捷的 REST API 开发框架，拥有以下特性：
- 直观的 API web 界面。
- 多种身份认证和权限认证方式的支持。
- 内置了 OAuth1 和 OAuth2 的支持。
- 内置了限流系统。
- 根据 Django ORM 或者其它库自动序列化。
- 丰富的定制层级：函数视图、类视图、视图集合到自动生成 API，满足各种需要。
- 可扩展性，插件丰富。
- 广泛使用，文档丰富。
REST 和 RESTful
REST 全称 REpresentational State Transfer，即“表现层状态转化”，RESTful 架构即符合 REST 风格的架构。 网上关于 REST 的讨论很多，在一些细节的地方却经常稍有出入，不过大体思想都是充分利用 HTTP/HTTPS 协议的特点，比如 HTTP 方法、header 信息、HATEOAS，直接面向资源进行操作。
阮一峰的两篇介绍：
- http://www.ruanyifeng.com/blog/2011/09/restful.html
- http://www.ruanyifeng.com/blog/2014/05/restful_api.html
基础组件／基本概念
序列化（Serializer）
序列化（Serializer）是 DRF 的核心概念，提供了数据的验证和渲染功能，其工作方式类似越 Django Form，当然也提供了对应 ModelForm 的 ModelSerializer。 和 Django Form 类似，Serializer 也是基于 Field 进行字段验证，Field 类都来自于 rest_framework.fields。
class YourSerializer(Serializer):
field1 = Field()
def save(self, validated_data):
# save your data here
return saved_data
def update(self, instance, validated_data):
# update your instance
return instance
Serializer 的主要工作是将 Python 数据结构序列化为其它格式（XML／JSON 等等）。
序列化之后的数据保存在 serializer.data 中的，可以使用 SomeRenderer().render(serializer.data) 将其序列化为字符串对象作为 Response body 返回。
反序列化
data = SomeParser().parse(incoming_stream)
serializer = YourSerializer(data=data)
if serializer.is_valid(): # 这里会根据 Serialzier 的 Field 和自定义验证工具进行数据校验
logging.info(serializer. validated_data)
serializer.update() # 或者 serializer.create()
对于自定义 Serializer，你需要自己实现 create 和 update 方法。
你也可以使用 serializer.save(**data)，save 方法的行为取决于初始化的方式：
# .save() 会创建一个新实例
serializer = CommentSerializer(data=data)
# .save() 会更新 `comment` 实例
serializer = CommentSerializer(comment, data=data)
反序列化时应该先运行 serializer.is_valid() 判断数据是否合法，serializer.is_valid(raise_exception=True) 会直接返回 400 信息。
字段验证
可以通过 Field 类型定义或者 .validate_ 方法来自行判断。字段名已设置 required=False 时，validate_ 将自动跳过空字段。
对象级验证应当实现 .validate() 方法。
部分更新
部分更新和更新不一样，应当是使用 HTTP 的 PATCH 方法发送请求。
嵌套对象
DRF 支持数据嵌套创建和修改，不过这样不利于数据的扁平化管理和测试。
序列化关联对象
PrimaryKeyRelatedField HyperlinkedRelatedField SlugRelatedFieldHyperlinkedIdentityField YourSerializer
对于可写的 Serializer，queryset 是必须值。
对于自定义的多对多字段，需要手动设置 read_only=True。
HyperLinkedModelSerializer
HyperLinkedModelSerializer 是一个值得推荐的 Serializer，它能够自动为 HTMLRenderer 提供相关外键资源的超链接，便于 web 调试。
但是它的使用也有一些问题，需要注意一下：
搜索
可以在 Serializer 中定义 search_fields 来指定可以搜索的字段，DRF 的搜索是基于 like，因此并不支持模糊搜索，在数据量较大的情况下还会有性能问题。
View 和 ViewSet
DRF 通过 View 提供 API 接口，一个 View 可以对应多个 Renderer，针对不同的渲染条件提供不同的输出格式（HTML／XML／JSON）。
ViewSet 则是 View 的一个封装，一个 ViewSet 可以为同一个 URL 根据请求方法提供不同的接口。尤其是 ModelViewSet 会自动根据 Model 的定义生成 REST 接口和 URL，能够快速生成网站的一整套 API。
定义一个 ViewSet 需要为其声明 queryset 和 serializer 属性：
class UserViewSet(viewsets.ModelViewSet):
"""
API endpoint that allows users to be viewed or edited.
"""
queryset = User.objects.all().order_by('-date_joined')
serializer_class = UserSerializer
反序列化多个对象：http://www.django-rest-framework.org/api-guide/serializers/#dealing-with-multiple-objects
只写字段：http://www.django-rest-framework.org/api-guide/serializers/#additional-keyword-arguments
Meta 继承：
class AccountSerializer(MyBaseSerializer):
class Meta(MyBaseSerializer.Meta):
model = Account
bulk_create： http://www.django-rest-framework.org/api-guide/serializers/#listserializer
动态修改字段：http://www.django-rest-framework.org/api-guide/serializers/#dynamically-modifying-fields
Field
Field 和 Django Form 的 Field 类似，可用参数有：
source：对应的 Model 字段，可以是关联对象的字段。source='*' 用于嵌套显示。 initial：HTML form 中的初始值。 style：HTML 中的样式，类型为 Python dict。
自定义字段需要实现 .to_representation(self, obj) 和 to_internal_value(self, data) 序列化和反序列化字段。反序列化时可以调用 self.fail( 返回定制错误信息。
Filter 和 FilterSet
DRF 查询请求可以使用 Filter 进行过滤，通过定义 Filter 类来对 QuerySet 进行加工和修改。
Pagination
Pagination 是对 List 请求进行分页的类，默认支持 page 分页、cursor 分页等多种分页类型。
Parser
根据 Content-Type 自动寻找最合适的 Parser 序列化 Response 和 Request。
Parser 和 Serializer 的关系？
自动驼峰化字段名： https://github.com/vbabiy/djangorestframework-camel-case
路由和 URL 注册
嵌套路由：https://github.com/alanjds/drf-nested-routers
Renderer
Renderer 会在返回 HTTP 请求前对 Python 对象进行渲染，以生成符合用户 代理需求的请求内容。通过声明多个的 Renderer 为不同的用户代理提供最合适的请求结果。
权限判断 Permission
Django 自带了强大的权限验证系统，DRF 进一步扩展了这项能力。
Django 的 permission 是基于 group 和 permission，DRF 也是如此。我们可以这样定义一个新的 Permission：
class YourPermission(BasePermission):
class Meta:
# 命名为cms设计稿里面对应 '菜单权限' 的地方, 例如用户管理
permissions = (
("information.announcement", u"资讯管理-通知公
("exam.room", u"考务管理-考场管理"),
...
)
然后在 View／ViewSet 中指定该 Permission 类：
class DetailView(YourBaseView):
...
permission_classes = (IsAuthenticated, YourPermission)
...
DRF 设置
http://www.django-rest-framework.org/api-guide/settings/
测试
http://www.django-rest-framework.org/api-guide/testing/
流程图
title Django REST framework
Request-> Router: Authentication Response
//note right of Bob: Bob thinks about it
Router->ViewSet: 路由匹配
ViewSet->Authentication: 身份校验
Authentication->Throutting: 限流
Throutting->Serializer: 序列化请求
opt 反序列化
Serializer->Filter: 根据定义的 Filter 验证 Query
end
opt 序列化
Serializer->Field: 根据定义的 Field 序列化 Serializer 查询结果
end
Serializer->Responce: 返回结果和状态
Responce->Renderer: 根据请求头寻找最合适的 Renderer 渲染响应结果
提高
DRF 提供了简单的文档和调试页面，但是你也可以通过一些第三方工具来增强这方面的能力：http://www.django-rest-framework.org/topics/documenting-your-api/
和 SPA 集成
网站的 Ajax 接口可以通过 SessionAuthentication 进行身份验证，对于不同网站的调用可以使用 TokenAuthentication 提供身份认证。
对于网站来说，最好还应该提供 CSRF 防范。
对于同源问题，应当使用中间件来保证安全，可以使用 https://github.com/ottoyiu/django-cors-headers/ 。
一些需求
不同权限用户 API 访问频率限制
http://www.django-rest-framework.org/api-guide/throttling/#throttlinghttp://my.oschina.net/duoduo3369/blog/612730
对于不同参数返回不同的序列化结果（输出时使用不同的序列化类）
同一 URL 不同方法设置不同权限
覆盖 get_permissions 方法：
YourView(BaseView):
...
def get_permissions(self):
if self.request.method == 'GET':
return [IsAuthenticated()]
return [permission() for permission in self.permission_classes]
限制分页大小
默认情况下会 DRF 根据前端输入的分页大小进行分页，如果用户恶意传入一个极大的分页大小将会占用过多服务器资源，影响正常请求的处理，因此有必要限制分页最大大小。
class YouView(BaseView):
paginate_by = 10 # 覆盖 settings 中的默认分页
max_paginate_by = 100 # 限制最大分页大小
也可以动态地去判断最大分页大小：
class YouView(BaseView):
...
def paginate_queryset(self, queryset):
self.paginator.max_page_size = YOUR_PAGE_SIZE_LIMIT
return super(YouView, self).paginate_queryset(queryset)