vue+rest-framework前后端分离整合

一、为什么要做前后端分离项目 1、满足多端适配
随着移动端的兴起,现在公司产品不只限于pc端的,包括Android,IOS。
按照以前的方式,我们后端其实就要有多套,pc一套,APP端两套。开发成本以及开发效率会很低,如果前后端分离,我们后端只需要有一套就可以了~
后端只提供接口,前端不管是pc还是APP都可以去调用数据。
2、前后端职责划分
以前的编程方式,前后端职责不清晰,模板语言前端后端都可以写。
3、开发效率
前后端互相等待。
4、解放前端能力
前端配合后端,只写模板语言,能力受限。
5、后端语言和模板语言解耦
后端开发语言与模板语言耦合度较高,依赖开发语言,更换后端语言的成本很高。
二、django路由配置 (1)项目urls.py修改如下:

from django.conf.urls import url, include urlpatterns = [ # path('admin/', admin.site.urls), url(r'^api/', include('api.urls')), ]

(2)应用目录下创建urls.py文件,配置如下:
from django.conf.urls import url, include from api.views import course urlpatterns = [ url(r'^(?P[v1|v2]+)/course/$', course.CourseView.as_view()), ]

(3)修改/api/views/course.py类视图文件如下所示:
from rest_framework.views import APIView from rest_framework.response import Response from rest_framework.versioning import QueryParameterVersioning, URLPathVersioning class CourseView(APIView): versioning_class = URLPathVersioning def get(self, request, *args, **kwargs): print(request.version) return Response('...')

(4)访问显示效果
vue+rest-framework前后端分离整合
文章图片

三、django部分构建中间件解决跨域问题 创建/api/cors.py,代码如下所示:
from django.middleware.common import CommonMiddleware# 通过它找到要引入的模块 from django.utils.deprecation import MiddlewareMixinclass CORSMiddleware(MiddlewareMixin): """自定义中间件""" def process_response(self, request, response): # 添加响应头# 允许你的域名来获取我的数据 response['Access-Control-Allow-Origin'] = "*" # 允许你携带Content-Type请求头,这里不能写* response['Access-Control-Allow-Headers'] = "Content-Type" # 允许你发送GET/POST/DELETE/PUT response['Access-Control-Allow-Methods'] = "GET, POST" return response

修改settings.py,添加中间件:
MIDDLEWARE = [ 'django.middleware.security.SecurityMiddleware', 'django.contrib.sessions.middleware.SessionMiddleware', 'django.middleware.common.CommonMiddleware', 'django.middleware.csrf.CsrfViewMiddleware', 'django.contrib.auth.middleware.AuthenticationMiddleware', 'django.contrib.messages.middleware.MessageMiddleware', 'django.middleware.clickjacking.XFrameOptionsMiddleware', 'api.cors.CORSMiddleware' ]

四、API示例数据录入 1、构建模型表并数据迁移
from django.db import models # Create your models here.class Course(models.Model): """课程表""" title = models.CharField(verbose_name='课程名称', max_length=32) course_img = models.CharField(verbose_name="课程图片", max_length=64) level_choices = ( (1, "初级"), (2, "中级"), (3, "高级"), ) level = models.IntegerField(verbose_name="课程难易程度", choices=level_choices, default=1)def __str__(self): return self.titleclass CourseDetail(models.Model): """课程详细表""" course = models.OneToOneField(to='Course', on_delete=models.CASCADE) slogon = models.CharField(verbose_name="口号", max_length=255) why = models.CharField(verbose_name="为什么要学习?", max_length=255) recommend_courses = models.ManyToManyField(verbose_name="推荐课程", to="Course", related_name="rc")def __str__(self): return "课程详细:" + self.course.titleclass Chapter(models.Model): """章节""" num = models.IntegerField(verbose_name="章节") name = models.CharField(verbose_name="章节名称", max_length=32) course = models.ForeignKey(verbose_name="所属课程", to="Course", on_delete=models.CASCADE)def __str__(self): return "课程章节" + self.name

执行数据迁移操作。
2、admin组件使用
from django.contrib import admin from api import models# Register your models here.""" root/root!2345 """ admin.site.register(models.Course) admin.site.register(models.CourseDetail) admin.site.register(models.Chapter)

3、数据录入
vue+rest-framework前后端分离整合
文章图片

五、api课程查询接口 基于rest-framework实现查询课程查询接口。
1、方式一:根据带不带id交给同一视图不同代码去处理
api/urls.py:
from django.conf.urls import url, include from api.views import courseurlpatterns = [ # 方式一: url(r'^(?P[v1|v2]+)/course/$', course.CourseView.as_view()), url(r'^(?P[v1|v2]+)/course/(?P\d+)/$', course.CourseView.as_view()), ]

api/views/course.py:
from rest_framework.views import APIView from rest_framework.response import Response from api import models from rest_framework import serializersclass CourseSerializer(serializers.ModelSerializer): """对django model 的实例进行序列化""" class Meta: # 帮忙转换没有自己写的字段 model = models.Course fields = "__all__"class CourseView(APIView):def get(self, request, *args, **kwargs): """ 查看所有的课程:http://127.0.0.1:8000/api/v1/course/ 查看某一课程:http://127.0.0.1:8000/api/v1/course/1 """ ret = {'code': 1000, 'data': None} try: pk = kwargs.get('pk') if pk:# 如果pk有值 obj = models.Course.objects.filter(id=pk).first() ser = CourseSerializer(instance=obj, many=False) else: queryset = models.Course.objects.all()# QuerySet里面是一个个对象 ser = CourseSerializer(instance=queryset, many=True)# 序列化结果 ret['data'] = ser.data except Exception as e: ret['code'] = 1001 ret['error'] = "获取课程失败"return Response(ret)

显示效果:
vue+rest-framework前后端分离整合
文章图片

这种方法虽然可以实现但是如果代码很多时,就看起来很不简洁了。如果能交给不同的方法来执行就比较好了。
2、方式二:由视图类中不同的方法来处理不同的查询操作
api/urls.py:
from django.conf.urls import url, include from api.views import courseurlpatterns = [ # 方式二:前提是要重写as_view url(r'^(?P[v1|v2]+)/course/$', course.CourseView.as_view({'get': 'list'})), url(r'^(?P[v1|v2]+)/course/(?P\d+)/$', course.CourseView.as_view({'get': 'retrieve'})), ]

api/views/course.py改写如下:
from rest_framework.viewsets import ViewSetMixinclass CourseView(ViewSetMixin, APIView):def list(self, request, *args, **kwargs): """ 课程列表接口 :param request: :param args: :param kwargs: :return: """ ret = {'code': 1000, 'data': None} try: queryset = models.Course.objects.all()# QuerySet里面是一个个对象 ser = CourseSerializer(instance=queryset, many=True)# 序列化结果True:queryset ret['data'] = ser.data except Exception as e: ret['code'] = 1001 ret['error'] = "获取课程失败"return Response(ret)def retrieve(self, request, *args, **kwargs): """ 课程详细接口 :param request: :param args: :param kwargs: :return: """ ret = {'code': 1000, 'data': None} try: pk = kwargs.get('pk') obj = models.Course.objects.filter(id=pk).first() ser = CourseSerializer(instance=obj, many=False)# many描述是model对象还是QuerySet False:对象 ret['data'] = ser.data except Exception as e: ret['code'] = 1001 ret['error'] = "获取课程失败"return Response(ret)

注意:many描述是model对象还是QuerySet,当many=True时,描述是QuerySet;当many=False时,描述是model对象。
六、api示例之课程详细接口 1、简单实现详细信息的序列化(depth)
course.py调整如下:
from rest_framework.views import APIView from rest_framework.response import Response from api import models from rest_framework import serializersclass CourseSerializer(serializers.ModelSerializer): """对django model 的实例进行序列化""" class Meta: # 帮忙转换没有自己写的字段 model = models.Course fields = "__all__"class CourseDetailSerializer(serializers.ModelSerializer): """课程详细序列化""" class Meta: model = models.CourseDetail fields = "__all__" depth = 1# 0-10之间,0是帮忙找一层(当前表关联的表)的数据,1是找两层(再往下找一层关联表)的数据from rest_framework.viewsets import ViewSetMixinclass CourseView(ViewSetMixin, APIView): def list(self, request, *args, **kwargs): """ 课程列表接口 :param request: :param args: :param kwargs: :return: """ ret = {'code': 1000, 'data': None} try: queryset = models.Course.objects.all()# QuerySet里面是一个个对象 ser = CourseSerializer(instance=queryset, many=True)# 序列化结果True:queryset ret['data'] = ser.data except Exception as e: ret['code'] = 1001 ret['error'] = "获取课程失败"return Response(ret)def retrieve(self, request, *args, **kwargs): """ 课程详细接口 :param request: :param args: :param kwargs: :return: """ ret = {'code': 1000, 'data': None} try: pk = kwargs.get('pk')# 课程id # 课程详细对象 obj = models.CourseDetail.objects.filter(course_id=pk).first() ser = CourseDetailSerializer(instance=obj, many=False) ret['data'] = ser.dataexcept Exception as e: ret['code'] = 1001 ret['error'] = "获取课程失败"return Response(ret)

主要是调整了retrieve方法,增加了CourseDetailSerializer来处理详细信息序列化。
注意:这里配置depth = 1官方推荐是:配置0-10之间,0是帮忙找一层(当前表关联的表)的数据,1是找两层(再往下找一层关联表)的数据。
显示效果:
vue+rest-framework前后端分离整合
文章图片

虽然这种方法可以实现效果,但是它往往给的数据过多了。
2、指定数据库字段在页面显示
对CourseDetailSerializer做了如下修改:
class CourseDetailSerializer(serializers.ModelSerializer): """课程详细序列化""" # 自定义字段serializers默认对model对象做序列化 title = serializers.CharField(source="course.title")# source与数据库的某个字段绑定,这样写完成了跨表查询 img = serializers.CharField(source="course.course_img") # level = serializers.CharField(source="course.level")# 这个只是拿到了数字 level = serializers.CharField(source="course.get_level_display")class Meta: model = models.CourseDetail fields = ["course", "title", "img", "level", "slogon", "why"]

注意source的用法,且get_字段名_display()可以用来获取对应字段的值
显示效果:
vue+rest-framework前后端分离整合
文章图片

3、进一步拿到推荐课程信息
source用来解决一对一、外键、choice的跨表查询。但是遇到多对多就不好用了。
class CourseDetailSerializer(serializers.ModelSerializer): """课程详细序列化""" # 自定义字段serializers默认对model对象做序列化 title = serializers.CharField(source="course.title")# source与数据库的某个字段绑定,这样写完成了跨表查询 img = serializers.CharField(source="course.course_img") # level = serializers.CharField(source="course.level")# 这个只是拿到了数字 level = serializers.CharField(source="course.get_level_display")# 针对多对多字段使用SerializerMethodField recommends = serializers.SerializerMethodField()# 取get_recommends(obj)的返回值class Meta: model = models.CourseDetail fields = ["course", "title", "img", "level", "slogon", "why", "recommends"]def get_recommends(self, obj):# 注意这个方法必须是“get_"拼接配置了SerializerMethodField的字段。 # 获取推荐的所有课程 queryset = obj.recommend_courses.all() return [{'id': row.id, 'title': row.title} for row in queryset]

注意多对多的字段使用SerializerMethodField,recommends取的是get_recommends函数的返回值。
注意这个方法必须是“get_"拼接配置了SerializerMethodField的字段。显示效果如下:
vue+rest-framework前后端分离整合
文章图片

七、api示例之课程优化(练习题 ) 1、查询所有课程level字段修改为中文
修改CourseSerializer实现对课程列表序列化修改:
class CourseSerializer(serializers.ModelSerializer): """对django model 的实例进行序列化""" # 自定义字段 level = serializers.CharField(source="get_level_display")class Meta: # 帮忙转换没有自己写的字段 model = models.Course fields = ["id", "title", "course_img", "level"]

显示效果:
vue+rest-framework前后端分离整合
文章图片

2、查询课程详细——显示该课程相关的所有章节
修改CourseDetailSerializer如下所示:
class CourseDetailSerializer(serializers.ModelSerializer): """课程详细序列化""" # 自定义字段serializers默认对model对象做序列化 title = serializers.CharField(source="course.title")# source与数据库的某个字段绑定,这样写完成了跨表查询 img = serializers.CharField(source="course.course_img") # level = serializers.CharField(source="course.level")# 这个只是拿到了数字 level = serializers.CharField(source="course.get_level_display")# 针对多对多字段使用SerializerMethodField recommends = serializers.SerializerMethodField()# 取get_recommends(obj)的返回值 chapter = serializers.SerializerMethodField()class Meta: model = models.CourseDetail fields = ["course", "title", "img", "level", "slogon", "why", "recommends", "chapter"]def get_recommends(self, obj):# 注意这个方法必须是“get_"拼接配置了SerializerMethodField的字段。 # 获取推荐的所有课程 queryset = obj.recommend_courses.all() return [{'id': row.id, 'title': row.title} for row in queryset]def get_chapter(self, obj):# obj是课程详细的对象 queryset = obj.course.chapter_set.all()# course.chapter_set反向查找,取到所有的章节 return [{'id': row.id, 'name': row.name} for row in queryset]

Django 中的一对多关系用 ForeignKey 来实现,一对多的反向查询是通过:按表名小写_set.all() 来实现的。
显示效果如下所示:
vue+rest-framework前后端分离整合
文章图片

3、序列化和视图解耦
创建/api/serializers/course.py文件夹和文件,将序列化相关内容迁移过来,如下所示:
from api import models from rest_framework import serializersclass CourseSerializer(serializers.ModelSerializer): """课程序列化""" # 自定义字段 level = serializers.CharField(source="get_level_display")class Meta: # 帮忙转换没有自己写的字段 model = models.Course fields = ["id", "title", "course_img", "level"]class CourseDetailSerializer(serializers.ModelSerializer): """课程详细序列化""" # 自定义字段serializers默认对model对象做序列化 title = serializers.CharField(source="course.title")# source与数据库的某个字段绑定,这样写完成了跨表查询 img = serializers.CharField(source="course.course_img") # level = serializers.CharField(source="course.level")# 这个只是拿到了数字 level = serializers.CharField(source="course.get_level_display")# 针对多对多字段使用SerializerMethodField recommends = serializers.SerializerMethodField()# 取get_recommends(obj)的返回值 chapter = serializers.SerializerMethodField()class Meta: model = models.CourseDetail fields = ["course", "title", "img", "level", "slogon", "why", "recommends", "chapter"]def get_recommends(self, obj):# 注意这个方法必须是“get_"拼接配置了SerializerMethodField的字段。 # 获取推荐的所有课程 queryset = obj.recommend_courses.all() return [{'id': row.id, 'title': row.title} for row in queryset]def get_chapter(self, obj):# obj是课程详细的对象 queryset = obj.course.chapter_set.all()# course.chapter_set反向查找,取到所有的章节 return [{'id': row.id, 'name': row.name} for row in queryset]

在view/course.py中引入序列化组件:
from rest_framework.views import APIView from rest_framework.response import Response from api import models from api.serializers.course import CourseDetailSerializer, CourseSerializer from rest_framework.viewsets import ViewSetMixinclass CourseView(ViewSetMixin, APIView):def list(self, request, *args, **kwargs): """ 课程列表接口 :param request: :param args: :param kwargs: :return: """ ret = {'code': 1000, 'data': None} try: queryset = models.Course.objects.all()# QuerySet里面是一个个对象 ser = CourseSerializer(instance=queryset, many=True)# 序列化结果True:queryset ret['data'] = ser.data except Exception as e: ret['code'] = 1001 ret['error'] = "获取课程失败"return Response(ret)def retrieve(self, request, *args, **kwargs): """ 课程详细接口 :param request: :param args: :param kwargs: :return: """ ret = {'code': 1000, 'data': None} try: pk = kwargs.get('pk')# 课程id # 课程详细对象 obj = models.CourseDetail.objects.filter(course_id=pk).first()ser = CourseDetailSerializer(instance=obj, many=False) ret['data'] = ser.dataexcept Exception as e: ret['code'] = 1001 ret['error'] = "获取课程失败"return Response(ret)


【vue+rest-framework前后端分离整合】

    推荐阅读