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 = Party        fields = ('id', 'create_date', 'content', 'title', 'address', 'is_off', 'link')

2）指定全部字段

class PartySerializer(serializers.ModelSerializer):    class Meta:        model = Party        fields = '__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 value    def validate(self, attrs):        print('validate', type(attrs), attrs)        if attrs['weight'] > 100:            raise serializers.ValidationError('your weight is too fat')        return attrs    def 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 person    def 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 instance    class Meta:        model = Person        fields = ('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