第四章 DRF之Router 和 Serializer

Router简单配置和映射

router = routers.DefaultRouter()

router.register("grades",GradeViewSet,"grades")

router.register("study/grades0",GradViewSetTemp,"grades0")

router.register("study/grades8",GradeGenericViewSet,"grades8")

router = SimpleRouter(trailing_slash=False)

#去除URL 尾部斜杠/

router = DefaultRouter(trailing_slash=False) #去除URL 尾部斜杠/

DefaultRouter路由器类似于上面的SimpleRouter,但是还包括一个默认返回所有列表视图的超链接的API根视图。它还生成可选的.json样式格式后缀的路由

urlpatterns += router.urls

path('', include(router.urls)),

path('api/', include(router.urls)),

url(r'^api/', include((router.urls,'app_name'))),

url(r'^api/', include((router.urls,'app_name'), namespace='instance_name')),

Router其他Action

@action #根据Detail属性来区分是 detail_route 还是 list_route 因此可直接用下面俩

@detail_route  #对应的URL 一般是 grades/{pk}/方法名路径

@list_route    #对应的URL 一般就是 grades/方法名路径

http://127.0.0.1:8000/api/study/grades8/1/info/

如果不设置url_path 属性则默认的用函数名 api/study/grades8/1/get_grade_info /

http://127.0.0.1:8000/api/study/grades8/clist/?name=高三

http://127.0.0.1:8000/api/study/grades8/clist/

自定义Router

可自定义路由,继承SimpleRouter,比如只提供get/retrieve的映射从而达到只读路由的目的,本例直接取自官网,不再实验

Serializer

修改过程,以点击PUT为例,注意本次PUT的参数包含了id和日期

UpdateModelMixin 提供了update方法,点击put后进入update方法。根据URL里面的pk可通过instance= self.get_object() 从数据库查到该对象

然后获取serializer 调用其 is_valid方法该方法会生成校验后的validated_data

可以看到已经没有id和时间了,因为serializer里面定义了id和时间都是read_only=True

然后会调用serializer.save() 跳转到 serializer 的 update方法该方法给instance的属性赋值,然后调用 instance.save()保存入库,然后返回改对象。

# .save() will create a new instance.

serializer = GradeSerializer(data=data)

# .save() will update the existing `grade`instance.

serializer = GradeSerializer(grade,data=data)

ModelSerializer

ModelSerializer继承了Serializer,提供了数据库实体类和序列化属性的映射,并且提供了数据库操作,增删改。如下面的代码就实现了上一节的功能

Serializer验证

全局validate

通用方法验证


Serializer实现

Serializer一对一关系

准备工作

1,修改settings文件增加媒体相关配置

MEDIA_URL = '/media/'

MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

2,配置URL

# 配置上传文件的访问处理函数re_path(r'^media/(?P<path>.*)$', serve, {"document_root": MEDIA_ROOT}),

3,安装 Pillow 用户图片类型的支持:

增加Model和Serializer

用 migrate 生成数据库表后,通过配置admin后台手动增加了一条记录

用VUE作为前端进行增加/修改的测试

调整serializer

注意红色圈起来的地方。开始做案例的时候,create 和 update 总是其中一个抛异常。

CREATE:  grade是外键,是不允许为空的,但是,ModelViewSet在接受创建的时候grade是没值的,就导致直接验证失败,因此修改Model类,设置该值可为空。前端在创建的时候传值的时候不应该给grade赋值,实际也没法赋值。

UPDATE:  假如不加上exclude(‘grade’)在前端接收到了grade的值,如果前端不做处理,直接返回修改,ModelViewSet在update函数里进行serializer验证的时候会直接报错”grade值必须唯一”,因为最终保存的方法里可以手动指定grade(并且部分方法需要grade对象而不是grade_id)因此前端并不需要返回grade值。

这里有两种修改方式:

第一种方式是前端的修改方式就是要将grade值清空,然后再传给后台。

第二种方式是后台不序列化grade,不传给前端,也就是加上exclude(‘grade’)。

注意以下代码的红框部分

1, 给添加grade属性指向Grade对象

2,  Profile的id可以直接从Grade对象的profile读取

3,  将Grade对象的profile重新赋值成修改保存后的profile,然后返还用于前端更新

前端页面展示,这里先忽略图片格式及Text格式,后面再处理:

图片上传

1, 安装six

Pip install six

新建Base64ImageField

classBase64ImageField(serializers.ImageField):

完整代码见github https://github.com/zhaorch/DRFtutorial

调整GrageSerializer

前端VUE 使用的是vue-image-crop-upload 控件

新增的时候如果不提供图片,则需要设置图片的logo为null 或者空,本次样例是前端做的修改,判断未选择图片时logo一定要赋值 null 或者‘’ 不能赋值成 undefined。DRF也需要做一定的修改

修改的时候由于前端使用的patch修改,也就是部分修改,所以在图片未改变的情况下,将logo设置成 undefined 即可

富文本编辑

使用tinymce 富文本

https://github.com/aljosa/django-tinymce

pip installdjango-tinymce

INSTALLED_APPS= (

    ...

    'tinymce',

)

urlpatterns= [

    ...

    url(r'^tinymce/', include('tinymce.urls')),

]

from tinymce.models import HTMLField

前端:

本次使用的是别人封装好的

https://github.com/PanJiaChen/tinymce-all-in-one

需要注意一点的是,在编辑器切换绑定Model的时候需要手动指定一下该编辑器的hasChange属性,

Serializer一对多关系

本案例做了2个多对一,区别在于:Student可以逐个添加。而StudentsGoods属于Student的私人物品,严重依赖于Student因此在Student保存的时候批量增加和删除,不单独添加。


实体类

Serializer序列化类

StudentGoods 的 id 设置

Read_only = True :只读,返回给客户端,但是返回来的时候validate_data中会舍弃id属性。Id的默认属性就是read_only=True

Read_only=False:返回给客户端,也会返回来,且会出现在validate_data中

Write_only = True:不会返回给客户端,因此也无法修改

Write_only= Flase: 返回给客户端,也会返回来,且会出现在validate_data中

Require=False:新建goods的时候验证的时候如果不加上这个参数则会抛异常:id必须出现

ViewSet

Serializer多对多关系

关于Course的单表增删改查,不再赘述,效果图

Model

以Student 为主进行选课

Serializer

http://127.0.0.1:8000/api/students/list_student_course/

http://127.0.0.1:8000/api/students/1/set_course/

这两个方法主体结构都是从update 方法以及 list方法复制的,但是舍弃了update方法的validate。直接使用的 request.data。

第一章 DRF概述

第二章 DRF安装与项目创建

第三章 DRF之View进化论

第四章 DRF之Router 和 Serializer

第五章 DRF权限分页查询排序访问限制

第六章 DRF Linux部署

第七章 DRF其他知识

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 211,265评论 6 490
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,078评论 2 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 156,852评论 0 347
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,408评论 1 283
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,445评论 5 384
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,772评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,921评论 3 406
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,688评论 0 266
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,130评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,467评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,617评论 1 340
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,276评论 4 329
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,882评论 3 312
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,740评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,967评论 1 265
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,315评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,486评论 2 348