Django Rest Framework - 安装，配置与新建 Serialization

1.安装

安装 Rest FrameWork 使用的是 pip 安装， Linux 与 Mac OS可以安装pip进行直接操作下面命令：

pip install djangorestframework #安装框架

windows 的话，可以通过 Anaconda 中的pip命令进行安装配置；

包管理工具安装可以看：

windows 下安装 anaconda 与 linux 下安装pip配置

2.配置

mysite/setting.py

配置INSTALLED_APPS

INSTALLED_APPS = [...'rest_framework', #配置 rest_framework app...
]

e.g

INSTALLED_APPS = ['django.contrib.admin','django.contrib.auth','django.contrib.contenttypes','django.contrib.sessions','django.contrib.messages','django.contrib.staticfiles','testapp','testrestapi','rest_framework', #配置 rest_framework app
]

好吧，配置如此简单。更多 REST_FRAMEWORK 的配置将在后面使用到的时候，进行列举。

3. 开启api工程

api工程和django中的app一样，使用命令新建即可。

比如我们新建名为 testrestapi 的 app：

python manage.py startapp testrestapi #新建app

更多内容： Django - 创建工程和 APP 与开发工具，别忘记在 setting.py 和 urls.py 中进行配置。

4. 新建model

testrestapi/model.py

新建实体 Party ，添加ordering 以创建日期排序；

class Party(models.Model):create_date = models.DateTimeField(auto_now_add=True)content = models.TextField()title = models.CharField(max_length=50, default='this is a party')address = models.CharField(max_length=50, default="ShangHai")is_off = models.BooleanField(default=False)link = models.CharField(max_length=200, default="http://www.baidu.com")class Meta:ordering = ('create_date',)

4. 新建Serializer

在testrestapi 下新建 serializer.py ，实现 PartySerializer

testrestapi/serializer.py

Serializer 实现，这里列举2种简单的实现方式：继承 ModelSerializer

1）指定部分字段

class PartySerializer(serializers.ModelSerializer):class Meta:model = Partyfields = ('id', 'create_date', 'content', 'title', 'address', 'is_off', 'link')

2）指定全部字段

class PartySerializer(serializers.ModelSerializer):class Meta:model = Partyfields = '__all__'

5. Serializer 进阶

这里以Person及其Serializer进行说明

实体 Person

class Person(models.Model):name = models.CharField(max_length=20, default='Lao')weight = models.FloatField()height_cm = models.IntegerField()

序列化 Person1Serializer

class Person1Serializer(serializers.ModelSerializer):name = serializers.CharField(max_length=20)weight = serializers.FloatField()height = serializers.IntegerField()# validate_fieId : 验证name是否符合需求def validate_name(self, value):print('validate_name', type(value), value)return valuedef validate(self, attrs):print('validate', type(attrs), attrs)if attrs['weight'] > 100:raise serializers.ValidationError('your weight is too fat')return attrsdef create(self, validated_data):print('create', type(validated_data), validated_data)height = validated_data['height']weight = validated_data['weight']name = validated_data['name']print(height)person = Person(name=name, weight=weight, height=height)person.save()return persondef update(self, instance, validated_data):print('update', type(instance), instance, validated_data)instance.name = validated_data.get('name', instance.name)instance.weight = validated_data.get('weight', instance.weight)instance.height_cm = validated_data.get('height', instance.height_cm)instance.save()return instanceclass Meta:model = Personfields = ('name', 'weight', 'height')

提交的json

Content - type : application/json

{"name": "test","weight": 123,"height": 12,
}

属性说明：

比如说这个序列化中有name ， weight , height 三个属性，必须对应的是Class Meta中的fieIds中的固定值，而fieIds最好与表单中的或json中提交的参数一致，当然还有实体中的属性，见上面的Person实体，PsersonSerializer ， 提交的 Json 。

方法说明：

validate_fieId 可以验证某个字段是否符合条件
validate 通过attrs参数，可以拿到表单或json提交的数据，以验证数据
create 方法可以进行查询/存储操作，参数 validated_data 是验证后的数据
update 执行修改的时候将要执行操作参数 validated_data 是验证后的数据，instance 是model对应的实体

6. 总结

参考： Tutorial 1: Serialization

源码： django-mysite-frist