Rest_framework 和路由配置（一）

简介

Django REST framework是一个创建在Django基础之上的Web 应用开发框架，能够快速的开发REST API接口应用。

Rest_framework 核心思想: 缩减代码。

中文文档：https://q1mi.github.io/Django-REST-framework-documentation/#django-rest-framework

github: https://github.com/encode/django-rest-framework/tree/master

特色

• 提供了定义序列化器Serializer的方法，能够快速根据 Django ORM 或者其它库自动序列化/反序列化；

• 提供了丰富的类视图、Mixin扩展类，简化视图的编写；

• 丰富的定制层级：函数视图、类视图、视图集合到自动生成 API，知足各类须要；

• 多种身份认证和权限认证方式的支持；[jwt]

• 内置了限流系统；

• 直观的 API web 界面；

• 可扩展性，插件丰富

非drf 实现简单接口

1.建立django 项目
 django-admin startproject drf 2. 建立子应用目录booktest,在项目根目录下执行如下命令 python manage.py startapp booktest 建立一个数据库,drf create database drf charset=utf8; grant all privileges on book.* to root@localhost identified by '123456'; flush privileges; 3. 配置数据库信息 3.1 在主应用drf目录下的drf/__init__.py添加如下代码: import pymysql pymysql.install_as_MySQLdb() 3.2 在项目配置文件中，settings中修改数据连接信息。 DATABASES = { # 'default': {
    # 'ENGINE': 'django.db.backends.sqlite3',
    # 'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    # }
    'default': { 'ENGINE': 'django.db.backends.mysql', 'NAME': 'drf', 'USER': 'root', 'PASSWORD': '123456', 'HOST': '127.0.0.1', 'PORT': '3306', }, }

路由配置：

1. 视图    booktest  应用中的views.py  

from django.shortcuts import render from django.http import JsonResponse from django.views import View # Create your views here.


class BookAPI(View): def get(self,request): return JsonResponse({"name":"deng"})

 2.分路由         booktest  应用中的urls.py  

from django.urls import path from .views import BookAPI urlpatterns = [ path(r'books/',BookAPI.as_view()) ]

 

3. 主路由      主应用drf  中的url.py   

from django.contrib import admin from django.urls import path,re_path,include urlpatterns = { path('admin/', admin.site.urls),  path('api/',include('booktest.urls') ) }

 

 

 

  访问接口结果：

drf 实现简单接口

1.环境安装与配置

DRF须要如下依赖：

• Python (2.7, 3.2, 3.3, 3.4, 3.5, 3.6)

• Django (1.10, 1.11, 2.0)

DRF是以Django扩展应用的方式提供的，因此咱们能够直接利用已有的Django环境而无需重新建立。

（若没有Django环境，须要先建立环境安装Django）

 

1.安装

pip install djangorestframework

2. 终端建立建立django 项目

　　在终端执行如下命令建立django项目，比较纯净， 建议用此方法建立项目，而不是用pycharm 建立。

django-admin startproject drf

3. 添加rest_framework应用

  在settings.py的INSTALLED_APPS中添加'rest_framework'。

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'rest_framework'
]

接下来就可使用DRF进行开发了。在项目中若是使用rest_framework框架实现API接口，主要有如下三个步骤：

• 将请求的数据（如JSON格式）转换为模型类对象

• 操做数据库

• 将模型类对象转换为响应的数据（如JSON格式）

在booktest应用目录中新建serializers.py用于保存该应用的序列化器。

建立一个BookInfoSerializer用于序列化与反序列化。

建立序列化器   

1.底层的方式实现的序列化：

serializers.py  :

from rest_framework import serializers

# 序列化器 序列化
class BookSerializer(serializers.Serializer):
    # 自定义序列化的字段
    id = serializers.IntegerField(label='主键ID',read_only=True)#read_only=True只给用户看不让输入和修改
    title= serializers.CharField(label='书名',max_length=32)

    pub_date = serializers.DateField()

    bread = serializers.IntegerField(min_value=0)
    bcomment = serializers.IntegerField(min_value=0)

2. 编写视图

book 应用下的视图   view.py ：

# 序列化器 序列化阶段

from django.http import JsonResponse
from django.views import View

from book.models import Book # 导入模型类
from book.serializers import BookSerializer # 导入序列化器类


class BookView(View):

    # 展现全部数据
    def get(self,request):

        # 1 操做数据库

        books = Book.objects.all()

        # 2 .序列化
        '''
        建立序列化器对象
        参数1：instance 要序列化的模型数据   （数据库中的数据）
        参数2： data 要反序列化器的字典数据  （前端传来的数据）
        参数3：many 是否要序列化多个模型数据，多条数据many=True    默认False 一条
        参数4： context 序列化器使用的上下文，字典类型数据，能够经过context把视图中的数据传递给序列化器内部使用
        '''
        serializer = BookSerializer(instance=books,many=True) #  此处须要many=True 否则会报错
        # 经过 serializer.data 获取序列化完成之后的数据
        # print(serializer.data)
        #3. 返回响应
        return JsonResponse(serializer.data,safe=False)

3. 配置路由

      3.1在booktest应用的urls.py中定义路由信息。

from django.urls import path from .views import BookView  urlpatterns=[ path('book/',BookView.as_view()) ] 

　　3.2 总路由中  drf主应用中 url.py :

from django.contrib import admin from django.urls import path,re_path,include urlpatterns = { path('admin/', admin.site.urls), path('api/', include('book.urls')), }

2.底层的方式实现的反序列化：

serializers.py  :

# 序列化器 的反序列化阶段 # 全局自定义验证方法
def check_title(data): if data=='金梅': raise serializers.ValidationError('金梅是禁书！') return data   #自定义验证方法必定要返回数据

class Book2Serializer(serializers.Serializer): #自定义要反序列化的字段
    id = serializers.IntegerField(label='主键ID', read_only=True)  # read_only=True只给用户看不让输入和修改
    title = serializers.CharField(label='书名', max_length=32,required=True,min_length=1,validators=[check_title]) # validators 参数用来装全局自定义验证方法
    pub_date = serializers.DateField() bread = serializers.IntegerField(min_value=0) bcomment = serializers.IntegerField(min_value=0) # required = False 反序列化时，当前字段能够不填
    # 自定义验证方法 ，验证单个字段能够多个方法
    # 格式： def validate_字段名（self,data): # data当前字段对应的值

    def validate_title(self, data): if data=='金梅': raise serializers.ValidationError('金梅是禁书！') return data  # 必定要返回数据

    # 自定义验证对个方法 ，验证多个或全部字段，只能出现一次
    def validate(self, data):# data 这个是全部字段内容 ，字典类型
 bread = data.get('bread') bcomment = data.get('bcomment') if bcomment>bread: raise serializers.ValidationError('数据不真实！') return data def create(self, validated_data): # 保存数据，把字典转化成模型
        # validated_data 客户端提交过来的数据，并通过验证的数据
        instance = Book.objects.create( title=validated_data.get('title'), pub_date=validated_data.get('pub_date'), bread = validated_data.get('bread'), bcomment=validated_data.get('bcomment') ) return instance def update(self, instance, validated_data): # 更新一条数据
        instance.title = validated_data.get('title') instance.pub_date = validated_data.get('pub_date') instance.bread = validated_data.get('bread') instance.bcomment = validated_data.get('bcomment') # 调用orm 进行保存
 instance.save() # 返回模型对象
        return instance

2. 编写视图

book 应用下的视图   view.py ：

from django.http import JsonResponse from django.views import View from book.models import Book # 导入模型类
from book.serializers import BookSerializer # 导入序列化器类

from book.serializers import Book2Serializer class BookView(View):# 反序列化

    def post(self,request): # 添加一本书
        #1 接收数据
        data = request.POST # 反序列化
        from book.serializers import Book2Serializer serializer = Book2Serializer(data=data) # 2 验证数据
        serializer.is_valid(raise_exception=True) ## raise_exception=True 把验证的错误信息返回给客户端,同时阻止程序继续往下执行
        # # is_valid调用验证方式: 字段选项validators->自定义验证方法[单字段]->自定义验证方法[多字段]
        # 验证成功后的数据
        # print(serializer.validated_data)
        # 3. 转换数据成模型,同步到数据库中
 serializer.save() ## save会自动调用序列化器类里面声明的create/update方法，返回值是当前新增/更新的模型对象

        # 4 响应数据
        return JsonResponse(serializer.data) def put(self,request,pk): # 更新一条数据
        # 1 根据主键获取指定图书信息
        instance = Book.objects.get(pk=pk) # 2. 获取put 数据
        from django.http import QueryDict data = QueryDict(request.body) # 3.使用序列化器 反序列化
        # partial=True 接下里在反序列化中容许部分数据更新
        serializer = Book2Serializer(instance=instance,data=data,partial=True) # 4 验证数据
        serializer.is_valid(raise_exception=True) # save之因此能够自动识别，何时执行create ，何时执行update
        # 主要是看建立序列化器对象时，是否有传入instance参数，
        # 有instance参数，则save会调用序列化器内部的update方法
        # 没有instance参数，则save会调用序列化器内部的create方法

        #5 保存数据
 serializer.save() return JsonResponse(serializer.data)

3. 配置路由

      3.1在booktest应用的urls.py中定义路由信息。

from django.urls import path,re_path from book.views import BookView urlpatterns=[ #path("book/",BookView.as_view()),
 re_path("book/(?P<pk>\d+)/",BookView.as_view()), ]

3.2 总路由中  drf主应用中 url.py :

from django.contrib import admin from django.urls import path,include urlpatterns = [ path('admin/', admin.site.urls), path('api/',include('book.urls')) ]

模型序列化器

1. serializers.py  :

 3 模型序列化器 # 1. 能够帮咱们自动完成字段的声明[主要是从模型中的字段声明里面提取过来] # 2. 模型序列化器也能够帮咱们声明了create和update方法的代码
from rest_framework import serializers from book.models import Book class BookModelSerializer(serializers.ModelSerializer): # 模型序列化器也能够自定义验证字段[当某些数据不存在于数据库时,可是须要前端提交过来的,能够进行自定义,
    # 例如,验证码,确认密码]

    class Meta: model=Book fields = ["id","title"] # 能够给模型序列化器里面指定的字段设置限制选项
        extra_kwargs = { "bread":{"min_length":0,"required":True}, } # 自定义验证方法[验证单个字段,能够有多个方法]
    # def validate_<字段名>(self,data): # data当前字段对应的值
    def validate_btitle(self,data): # 例如,图书名不能是红楼梦
        if data=="红楼梦": # 抛出错误
            raise serializers.ValidationError("红楼梦是禁书~") # 验证方法中,把数据值必须返回给字段,不然字段值为空
        return data # 自定义验证方法[验证多个或者全部字段,只能出现一次]
    def validate(self,data): # data 这个是全部字段的内容,字典类型
        bread = data.get("bread") bcomment = data.get("bcomment") if bread>=bcomment: return data raise serializers.ValidationError("阅读量小于评论量,数据太假了")

2. 视图编写

3 模型序列化器 # 1. 能够帮咱们自动完成字段的声明[主要是从模型中的字段声明里面提取过来] # 2. 模型序列化器也能够帮咱们声明了create和update方法的代码 ######################################################
from django.views import View from django.http import JsonResponse from .serializers import BookModelSerializer class Book3View(View): def post(self,request): """添加一本图书"""
        # 接受数据
        data = request.POST # 反序列化
        serializer = BookModelSerializer(data=data) serializer.is_valid(raise_exception=True) result = serializer.save() # 响应数据
        return JsonResponse(serializer.data) def put(self,request,pk): """更新一个图书""" book = Book.objects.get(pk=pk) # 获取put提交的数据
        data = QueryDict(request.body) serializer = BookModelSerializer(instance=book,data=data,partial=True) serializer.is_valid(raise_exception=True) serializer.save() # 响应数据
        return JsonResponse(serializer.data)

3. 路由

from django.urls import path, re_path from . import views urlpatterns = [  path("books3/",views.Book3View.as_view()), ]

 

使用序列化器的简单版

1.建立序列化器 ，在app 1下 新建一个serializer.py 文件

from rest_framework import serializers from booktest.models import BookInfo class BookInfoSerializer(serializers.ModelSerializer): # 当前序列化器在序列化和反序列的类 序列化器类
    class Meta: model = BookInfo fields='__all__'

• model 指明该序列化器处理的数据字段从模型类BookInfo参考生成

• fields 指明该序列化器包含模型类中的哪些字段，'all'指明包含全部字段

2. 编写视图   app1       view.py

from django.shortcuts import render from booktest.models import BookInfo from .serializers import BookInfoSerializer from rest_framework.viewsets import ModelViewSet class BookInfoAPIView(ModelViewSet): queryset = BookInfo.objects.all() # 当前视图类使用序列化器类是谁
    serializer_class = BookInfoSerializer

• queryset 指明该视图集在查询数据时使用的查询集

• serializer_class 指明该视图在进行序列化或反序列化时使用的序列化器。

3. 定义路由

在app1 应用的urls.py中定义路由信息。

from rest_framework.routers import DefaultRouter from .views import BookInfoAPIView urlpatterns=[ ] # 建立路由对象
routers = DefaultRouter() # 经过路由对象对视图进行路由生成
routers.register('books',BookInfoAPIView)# books为路径
 urlpatterns += routers.urls

把上面的urls 添加到总路由中去：

from django.contrib import admin from django.urls import path, re_path, include urlpatterns = [ path('admin/', admin.site.urls),  path('api/',include('app1.urls') ) ]