DjangoRestFramework实践笔记

1、Restful服务的实现方式一共三种：function based view，class based view，viewset+router，这三种实现方式的封装重度依序升高，越往后越适合典型CURD服务，因为我们的产品是互联网产品，服务接口大多数是业务操作，所以主要以function based view为主，偶尔使用class based view。

2、序列化器Serializer的使用，序列化器在输入处理中类似Form，实际是反序列化的作用。同时对输出数据的格式有所定制，真正的序列化定制。当然序列化要想完整使用，就要用modal序列化器，而这个序列化器要直接使用需要是RDB存储，这在如今这个NoSQL盛行的时代，有所约束，不过也算好了。

3、基本配置

1. REST_FRAMEWORK = {
2. 'DEFAULT_PARSER_CLASSES': (
3. 'rest_framework.parsers.JSONParser',#主要使用JSon解析器
4. ),
5. 'DEFAULT_AUTHENTICATION_CLASSES': (
6. 'rest_framework.authentication.TokenAuthentication',#for Restful服务验证
7. 'rest_framework.authentication.SessionAuthentication',#for 自动生成文档页面的验证
8. ),
9. 'DEFAULT_PERMISSION_CLASSES': (
10. 'rest_framework.permissions.IsAuthenticated',#所有view的默认认证
11. )
12. }

4、form文件上传问题，默认使用的JSon解析器可能会对multipart的data body有干扰，导致request.Files解析直接失败，给客户端返回415答复，这个时候需要手动给相关view修改解析器，比如如下函数装饰器配置：

1. @parser_classes((MultiPartParser,))

5、引用到user的序列化器对user外键字段的输出要格外小心，这个地方有可能连user的密码字段都输出掉，所以引用user的外键，一定要从序列化器的depth设置或者序列化器关系字段定义等方式上，让user的输出符合你的要求。

6、Field的定制，Field的定制化改写方式是改写to_representation或to_internal_value，前者负责把变量转化成字符串，后者负责把字符串转化成变量，我们这个项目中的FileField为了输出完整路径，改写了to_representation方法：

1. class TFileField(serializers.FileField):
2. def to_representation(self, obj):
3. if not obj:
4. return None
5. if obj.name.find("/static/") == 0:
6. return MEDIA_DOMAIN + obj.name
7. else:
8. return MEDIA_DOMAIN + "/static/" + obj.url

7、Serializer的定制化改写，我说一个我的改写场景，某对象的聚合对象的属性需要和主对象属性并列，这个采用官方Serializer的特性只能做到一个外键ID属性并列，其他属性都不可以，于是可以改写Serializer的to_representation如下：

1. def to_representation(self, instance):
2. ret = super(ContactSerializer,self).to_representation(instance)
3. ret["username"] = instance.user.username
4. return ret

8、调用序列化对象的save时报错：

1. ValueError: "<Topic: Topic object>" needs to have a value for field "topic" before this many-to-many relationship can be used.

这个错误在form的save操作时也会出，错误原因，一个新对象在未存储前，不能对他的ManyToMany的关系做操作，原因也很简单，ManyToMany需要新对象的ID，方法就是在序列化器的存储前，先对对象本身save一下，这样新对象有了ID，操作就Ok了。

8、应用加载不完全错误：错误提示：

1. AttributeError: type object 'Token' has no attribute 'objects'

错误原因，Token所在的应用'rest_framework.authtoken'没有加在INSTALLED_APPS配置里面，加上即可解决问题。