luffy之课程表的创建、课程接口

luffy之课程表的创建、课程接口

复习

# celery：分布式异步任务框架   其他定时任务框架：apscheduler
	-异步任务
    -延迟任务
    -定时任务：
# 消息队列（redis），任务执行单元(worker),结果存储（redis）

# 如何使用:包管理的方式
	-包名
    	-celery.py    # celery对象的实例化
        -task1.py
        -task2.py
    -提交任务.py
    -查看任务.py
    
# 异步任务  函数.delay()
# 延迟任务： 函数.apply_async(args=[],eta=时间对象)
# 定时任务：在app的配置文件中配置

# 集成到django中
	-django服务和celery服务独立运行的
    -可能task的任务会放在app中，只要正常操作：task的py文件在app中注册，正常提交，都会正常执行
    
    
# 给轮播图接口加入缓存
	-cache.set(key,value)  # 响应的字典数据
    -自定义一个带缓存的视图类
# 加入缓存：数据不一致，双写一致性
	-定时更新
    -插入数据删除缓存
    -插入数据更新缓存

1 课程页面

# 路由的使用
## 第一步：需要在route的index.js中配置
import ActualCourse from "../views/ActualCourse";
const routes = [
  {
      //home 根路径下
    path: '/',
    name: 'Home',
    component: Home
  },
  {
      # 后加的
    path: '/actual-course',   #路径 网页跳转的路径
    name: 'ActualCourse',    #起一个名字，尽量见名知意
    component: ActualCourse  #浏览器输入这个路径跳转到这个页面组件 需要导入
  }
]

## 第二步：使用js实现路由跳转（只针对自己的页面）
	this.$router.push('路径')  # 在浏览器就会打开这个地址 127.0.0.1:8000/路径
    
#如何跳转外链接 比如百度等 写在按钮的单击事件里
	location.href='http://www.baidu.com'
    
#页面中标签跳转：to指定地址即可（内部地址）
<router-link to="/">  跳转到那个地址
	写自己的按钮 或者图片等
</router-link>


#在根组件中---》以后设置的路由调整，只会变化router-view内部的  app.view
改变只是边router-view内部的东西
<router-view/>
	
    
    
    
    
    
 # 课程相关需要的接口
	-课程分类接口比如python类 linux类
    -查询所有课程接口（按分类，价格。。过滤，排序）
    -课程详情接口

2 课程表分析

# 课程分类表 比如python类 linux类等
# 课程表（可能每个表字段不一样）  比如免费课 ，轻课，实战课
	-所有类型课程都放到一个表中 #不推荐，数据上来之后查询效率很低 免费课字段和实战课字段可能还不一样
    	-免费课：
        -实战课：
        -轻课：
    -每个类型的课程设计成一个表 #推荐
    	ActuCourse表
    	FreeCourse表
        LightCourse表
    
# 章节表
	#每一章内容
# 课时表
	#每一章还有课时
# 老师表
	#上课的老师

2.1创建数据表

#新建一个app course
from django.db import models

from utils.models import BaseModel

# 分类表
class CourseCategory(BaseModel):
    """分类"""
    name = models.CharField(max_length=64, unique=True, verbose_name="分类名称")
    class Meta:
        db_table = "luffy_course_category"
        verbose_name = "分类"
        verbose_name_plural = verbose_name

    def __str__(self):
        return "%s" % self.name


# 课程表()
class Course(BaseModel):
    """课程"""
    course_type = (
        (0, '付费'),
        (1, 'VIP专享'),
        (2, '学位课程')
    )
    level_choices = (
        (0, '初级'),
        (1, '中级'),
        (2, '高级'),
    )
    status_choices = (
        (0, '上线'),
        (1, '下线'),
        (2, '预上线'),
    )
    # 课程名字
    name = models.CharField(max_length=128, verbose_name="课程名称")
    # 课程图片
    course_img = models.ImageField(upload_to="courses", max_length=255, verbose_name="封面图片", blank=True, null=True)
    # 课程付费类型
    course_type = models.SmallIntegerField(choices=course_type, default=0, verbose_name="付费类型")
    # 课程介绍（bbs的文章内容）
    brief = models.TextField(max_length=2048, verbose_name="详情介绍", null=True, blank=True)
    # 课程难度等级
    level = models.SmallIntegerField(choices=level_choices, default=0, verbose_name="难度等级")
    # 课程发布日期
    pub_date = models.DateField(verbose_name="发布日期", auto_now_add=True)
    #建议学习周期
    period = models.IntegerField(verbose_name="建议学习周期(day)", default=7)
    # 文档（zip，课程资料）
    attachment_path = models.FileField(upload_to="attachment", max_length=128, verbose_name="课件路径", blank=True,
                                       null=True)
    # 课程状态
    status = models.SmallIntegerField(choices=status_choices, default=0, verbose_name="课程状态")




    # 学习人数
    students = models.IntegerField(verbose_name="学习人数", default=0)
    #总课时数量
    sections = models.IntegerField(verbose_name="总课时数量", default=0)
    # 课时更新数量
    pub_sections = models.IntegerField(verbose_name="课时更新数量", default=0)
    price = models.DecimalField(max_digits=6, decimal_places=2, verbose_name="课程原价", default=0)



    # 课程分类，跟分类表一对多，关联字段写在多的一方
    # db_constraint=False:实际编码中，外键关联是人为约束，不是直接使用关联
    # 不建立外键，但是orm使用跟之前一样
    # blank=True  后台管理，录入的时候，blank=True可以为空
    course_category = models.ForeignKey('CourseCategory', on_delete=models.SET_NULL, db_constraint=False, null=True, blank=True,
                                        verbose_name="课程分类")
    # 一套课程是一个老师讲，一对多
    teacher = models.ForeignKey("Teacher", on_delete=models.DO_NOTHING, null=True,db_constraint=False, blank=True, verbose_name="授课老师")

    class Meta:
        db_table = "luffy_course"
        verbose_name = "课程"
        verbose_name_plural = "课程"

    def __str__(self):
        return "%s" % self.name

class Teacher(BaseModel):
    """导师"""
    role_choices = (
        (0, '讲师'),
        (1, '导师'),
        (2, '班主任'),
    )
    name = models.CharField(max_length=32, verbose_name="导师名")
    # 身份
    role = models.SmallIntegerField(choices=role_choices, default=0, verbose_name="导师身份")
    # 头衔
    title = models.CharField(max_length=64, verbose_name="职位、职称")
    # 导师签名
    signature = models.CharField(max_length=255, verbose_name="导师签名", help_text="导师签名", blank=True, null=True)
    # 导师图片
    image = models.ImageField(upload_to="teacher", null=True, verbose_name="导师封面")
    # 导师描述
    brief = models.TextField(max_length=1024, verbose_name="导师描述")

    class Meta:
        db_table = "luffy_teacher"
        verbose_name = "导师"
        verbose_name_plural = verbose_name

    def __str__(self):
        return "%s" % self.name



class CourseChapter(BaseModel):
    """章节"""
    # 一对多，章节多
    # related_name：基于对象的跨表查询，反向操作替换掉 表名小写_set.all()
    # related_query_name:反向查询操作时，使用的连接前缀，用于替换表名
    course = models.ForeignKey("Course", related_name='coursechapters', on_delete=models.CASCADE, verbose_name="课程名称")
    # 第几章
    chapter = models.SmallIntegerField(verbose_name="第几章", default=1)
    # 章节名字
    name = models.CharField(max_length=128, verbose_name="章节标题")
    # 介绍
    summary = models.TextField(verbose_name="章节介绍", blank=True, null=True)
    #发布日期
    pub_date = models.DateField(verbose_name="发布日期", auto_now_add=True)

    class Meta:
        db_table = "luffy_course_chapter"
        verbose_name = "章节"
        verbose_name_plural = verbose_name

    def __str__(self):
        return "%s:(第%s章)%s" % (self.course, self.chapter, self.name)


class CourseSection(BaseModel):
    """课时"""
    section_type_choices = (
        (0, '文档'),
        (1, '练习'),
        (2, '视频')
    )
    # 一个章节下多个课时
    chapter = models.ForeignKey("CourseChapter", related_name='coursesections', on_delete=models.CASCADE,
                                verbose_name="课程章节")
    name = models.CharField(max_length=128, verbose_name="课时标题")
    #
    orders = models.PositiveSmallIntegerField(verbose_name="课时排序")
    section_type = models.SmallIntegerField(default=2, choices=section_type_choices, verbose_name="课时种类")
    section_link = models.CharField(max_length=255, blank=True, null=True, verbose_name="课时链接",
                                    help_text="若是video，填vid,若是文档，填link")
    duration = models.CharField(verbose_name="视频时长", blank=True, null=True, max_length=32)  # 仅在前端展示使用
    pub_date = models.DateTimeField(verbose_name="发布时间", auto_now_add=True)
    free_trail = models.BooleanField(verbose_name="是否可试看", default=False)

    class Meta:
        db_table = "luffy_course_Section"
        verbose_name = "课时"
        verbose_name_plural = verbose_name

    def __str__(self):
        return "%s-%s" % (self.chapter, self.name)
    
    
    

2.2admin注册 ，app也记得的要注册，这步容易忘

#settings里注册这个course的app

from . import models
admin.site.register(models.CourseCategory)
admin.site.register(models.Course)
admin.site.register(models.Teacher)
admin.site.register(models.CourseChapter)
admin.site.register(models.CourseSection)

###执行迁移命令

2.3 数据录入

-- 老师表
INSERT INTO luffy_teacher(id, orders, is_show, is_delete, created_time, updated_time, name, role, title, signature, image, brief) VALUES (1, 1, 1, 0, '2019-07-14 13:44:19.661327', '2019-07-14 13:46:54.246271', 'Alex', 1, '老男孩Python教学总监', '金角大王', 'teacher/alex_icon.png', '老男孩教育CTO & CO-FOUNDER 国内知名PYTHON语言推广者 51CTO学院2016\2017年度最受学员喜爱10大讲师之一 多款开源软件作者 曾任职公安部、飞信、中金公司、NOKIA中国研究院、华尔街英语、ADVENT、汽车之家等公司');

INSERT INTO luffy_teacher(id, orders, is_show, is_delete, created_time, updated_time, name, role, title, signature, image, brief) VALUES (2, 2, 1, 0, '2019-07-14 13:45:25.092902', '2019-07-14 13:45:25.092936', 'Mjj', 0, '前美团前端项目组架构师', NULL, 'teacher/mjj_icon.png', '是马JJ老师, 一个集美貌与才华于一身的男人，搞过几年IOS，又转了前端开发几年，曾就职于美团网任高级前端开发，后来因为不同意王兴(美团老板)的战略布局而出家做老师去了，有丰富的教学经验，开起车来也毫不含糊。一直专注在前端的前沿技术领域。同时，爱好抽烟、喝酒、烫头(锡纸烫)。 我的最爱是前端，因为前端妹子多。');

INSERT INTO luffy_teacher(id, orders, is_show, is_delete, created_time, updated_time, name, role, title, signature, image, brief) VALUES (3, 3, 1, 0, '2019-07-14 13:46:21.997846', '2019-07-14 13:46:21.997880', 'Lyy', 0, '老男孩Linux学科带头人', NULL, 'teacher/lyy_icon.png', 'Linux运维技术专家，老男孩Linux金牌讲师，讲课风趣幽默、深入浅出、声音洪亮到爆炸');

-- 分类表
INSERT INTO luffy_course_category(id, orders, is_show, is_delete, created_time, updated_time, name) VALUES (1, 1, 1, 0, '2019-07-14 13:40:58.690413', '2019-07-14 13:40:58.690477', 'Python');

INSERT INTO luffy_course_category(id, orders, is_show, is_delete, created_time, updated_time, name) VALUES (2, 2, 1, 0, '2019-07-14 13:41:08.249735', '2019-07-14 13:41:08.249817', 'Linux');

-- 课程表
INSERT INTO luffy_course(id, orders, is_show, is_delete, created_time, updated_time, name, course_img, course_type, brief, level, pub_date, period, attachment_path, status, students, sections, pub_sections, price, course_category_id, teacher_id) VALUES (1, 1, 1, 0, '2019-07-14 13:54:33.095201', '2019-07-14 13:54:33.095238', 'Python开发21天入门', 'courses/alex_python.png', 0, 'Python从入门到入土&&&Python从入门到入土&&&Python从入门到入土&&&Python从入门到入土&&&Python从入门到入土&&&Python从入门到入土&&&Python从入门到入土&&&Python从入门到入土&&&Python从入门到入土&&&Python从入门到入土&&&Python从入门到入土&&&Python从入门到入土', 0, '2019-07-14', 21, '', 0, 231, 120, 120, 0.00, 1, 1);

INSERT INTO luffy_course(id, orders, is_show, is_delete, created_time, updated_time, name, course_img, course_type, brief, level, pub_date, period, attachment_path, status, students, sections, pub_sections, price, course_category_id, teacher_id) VALUES (2, 2, 1, 0, '2019-07-14 13:56:05.051103', '2019-07-14 13:56:05.051142', 'Python项目实战', 'courses/mjj_python.png', 0, '', 1, '2019-07-14', 30, '', 0, 340, 120, 120, 99.00, 1, 2);

INSERT INTO luffy_course(id, orders, is_show, is_delete, created_time, updated_time, name, course_img, course_type, brief, level, pub_date, period, attachment_path, status, students, sections, pub_sections, price, course_category_id, teacher_id) VALUES (3, 3, 1, 0, '2019-07-14 13:57:21.190053', '2019-07-14 13:57:21.190095', 'Linux系统基础5周入门精讲', 'courses/lyy_linux.png', 0, '', 0, '2019-07-14', 25, '', 0, 219, 100, 100, 39.00, 2, 3);


-- 章节表
INSERT INTO luffy_course_chapter(id, orders, is_show, is_delete, created_time, updated_time, chapter, name, summary, pub_date, course_id) VALUES (1, 1, 1, 0, '2019-07-14 13:58:34.867005', '2019-07-14 14:00:58.276541', 1, '计算机原理', '', '2019-07-14', 1);

INSERT INTO luffy_course_chapter(id, orders, is_show, is_delete, created_time, updated_time, chapter, name, summary, pub_date, course_id) VALUES (2, 2, 1, 0, '2019-07-14 13:58:48.051543', '2019-07-14 14:01:22.024206', 2, '环境搭建', '', '2019-07-14', 1);

INSERT INTO luffy_course_chapter(id, orders, is_show, is_delete, created_time, updated_time, chapter, name, summary, pub_date, course_id) VALUES (3, 3, 1, 0, '2019-07-14 13:59:09.878183', '2019-07-14 14:01:40.048608', 1, '项目创建', '', '2019-07-14', 2);

INSERT INTO luffy_course_chapter(id, orders, is_show, is_delete, created_time, updated_time, chapter, name, summary, pub_date, course_id) VALUES (4, 4, 1, 0, '2019-07-14 13:59:37.448626', '2019-07-14 14:01:58.709652', 1, 'Linux环境创建', '', '2019-07-14', 3);


-- 课时表
INSERT INTO luffy_course_Section(id, is_show, is_delete, created_time, updated_time, name, orders, section_type, section_link, duration, pub_date, free_trail, chapter_id) VALUES (1, 1, 0, '2019-07-14 14:02:33.779098', '2019-07-14 14:02:33.779135', '计算机原理上', 1, 2, NULL, NULL, '2019-07-14 14:02:33.779193', 1, 1);

INSERT INTO luffy_course_Section(id, is_show, is_delete, created_time, updated_time, name, orders, section_type, section_link, duration, pub_date, free_trail, chapter_id) VALUES (2, 1, 0, '2019-07-14 14:02:56.657134', '2019-07-14 14:02:56.657173', '计算机原理下', 2, 2, NULL, NULL, '2019-07-14 14:02:56.657227', 1, 1);

INSERT INTO luffy_course_Section(id, is_show, is_delete, created_time, updated_time, name, orders, section_type, section_link, duration, pub_date, free_trail, chapter_id) VALUES (3, 1, 0, '2019-07-14 14:03:20.493324', '2019-07-14 14:03:52.329394', '环境搭建上', 1, 2, NULL, NULL, '2019-07-14 14:03:20.493420', 0, 2);

INSERT INTO luffy_course_Section(id, is_show, is_delete, created_time, updated_time, name, orders, section_type, section_link, duration, pub_date, free_trail, chapter_id) VALUES (4, 1, 0, '2019-07-14 14:03:36.472742', '2019-07-14 14:03:36.472779', '环境搭建下', 2, 2, NULL, NULL, '2019-07-14 14:03:36.472831', 0, 2);

INSERT INTO luffy_course_Section(id, is_show, is_delete, created_time, updated_time, name, orders, section_type, section_link, duration, pub_date, free_trail, chapter_id) VALUES (5, 1, 0, '2019-07-14 14:04:19.338153', '2019-07-14 14:04:19.338192', 'web项目的创建', 1, 2, NULL, NULL, '2019-07-14 14:04:19.338252', 1, 3);

INSERT INTO luffy_course_Section(id, is_show, is_delete, created_time, updated_time, name, orders, section_type, section_link, duration, pub_date, free_trail, chapter_id) VALUES (6, 1, 0, '2019-07-14 14:04:52.895855', '2019-07-14 14:04:52.895890', 'Linux的环境搭建', 1, 2, NULL, NULL, '2019-07-14 14:04:52.895942', 1, 4);

3 课程接口所有分类接口

3.1 序列化类

# 自定义课程分类表的序列化类
class CourseCategorySerializer(serializers.ModelSerializer):
    class Meta:
        model = CourseCategory
        fields = ['id', 'name']

3.2 视图类

#只查询所有ListModelMixin   自动生成路由GenericViewSet
# 视图类
from rest_framework.viewsets import GenericViewSet
# from rest_framework.mixins import ListModelMixin
from utils.base_utils import MyListModelMixin as ListModelMixin
from .serializer import CourseCategorySerializer
from .models import CourseCategory


class CourseCategoryView(GenericViewSet, ListModelMixin):
    serializer_class = CourseCategorySerializer
    queryset = CourseCategory.objects.filter(is_show=True, is_delete=False).order_by('orders')

3.3重写ListModelMixin

#因为想要自己重写的Response 所有重写ListModelMixin 修改了return
from rest_framework.mixins import ListModelMixin
from utils.response import APIResponse
#重写ListModelMixin
class MyListModelMixin(ListModelMixin):
    def list(self, request, *args, **kwargs):
        res=super().list(request, *args, **kwargs)
        return APIResponse(data=res.data)
        #{code:100,msg:成功,data[自己生成的]}

3.4 路由

#自动生成路由
router.register('category', views.CourseCategoryView, 'category')

路由分发记得加上
path('course/', include('course.urls')),

3.5接口测试如下http://127.0.0.1:8000/course/category/

4 课程接口之所有课程接口

4.1 序列化类

class TeacherSerializer(serializers.ModelSerializer):
    class Meta:
        model = Teacher
        fields = ['name', 'role_name', 'title', 'signature', 'image', 'brief']


class CourseSerializer(serializers.ModelSerializer):
    class Meta:
        model = Course
        fields = [
            'id',
            'name',
            'course_img',
            'brief',  # 课程介绍
            'attachment_path',  # 文档链接
            'pub_sections',  # 发布了多少课时
            'price',  # 价格
            'students',  # 学生人数
            'period',  # 建议学习周期
            'sections',  # 总课时数量

            # choice的字段
            'course_type_name',
            'level_name',
            'status_name',

            # 原来有这个字段，但是要重写
            'teacher',
            # 小于四个课时，有多少显示多少，多余四个，最多显示4个
            'section_list',

        ]
#choise的这几个字段需要重写可以在models重写
    #get_course_type_display 显示choise数字对应的中文
    # @property  方法变成属性
    @property
    def course_type_name(self):
        return self.get_course_type_display()
    @property
    def level_name(self):
        return self.get_level_display()
    
    @property
    def status_name(self):
        return self.get_status_display()
    
    #这个字段需要自己写比较特殊
    @property
    def section_list(self):

        # 定义一个列表 存课时
        session_list_use = []

        ## 小于四个课时，有多少显示多少，多余四个，最多显示4个，页面显示四个课时
        # 1.取出该课程所有章节 外键字段不在自己这，一个课程多个章节 反向查询 需要表名消息_set.all()，
        # 但是由于配置了related_name，所以直接这个名字.all()就ok

        coursechapter_list = self.coursechapters.all()
        # 2.循环所有章节
        for coursechapter in coursechapter_list:
            # 2.1取出该章节下所有课时 反向操作 一个章节对应多个课时
            course_section_list = coursechapter.coursesections.all()
            for course_section in course_section_list:
                session_list_use.append(
                    {'id': course_section.id, 'name': course_section.name, 'free_trail': course_section.free_trail})
                if len(session_list_use) >= 4:
                    return session_list_use
        return session_list_use
    
    

# 重写字段teacher 在序列化类里写
    # 方式一：
    # teacher=serializers.SerializerMethodField()
    #这个字段必须配合这个名字前加get的方法 方法返回什么 他就是什么
    # def get_teacher(self):
    #     return {}

    # 方式二：子序列化
    # 如果是多条要加many=True
    teacher = TeacherSerializer()  
    

4.2 视图类

# 查询课程详情和查询所有课程接口
from rest_framework.filters import OrderingFilter,SearchFilter
from django_filters.rest_framework import DjangoFilterBackend
class CourseView(GenericViewSet, ListModelMixin,RetrieveModelMixin):
    serializer_class = CourseSerializer
    queryset = Course.objects.filter(is_show=True, is_delete=False).order_by('orders')
    '''
    # 增加过滤功能 根据课程分类
    # 增加排序功能 根据价格、人数、id
    # 增加分页功能
    '''

    # 排序
    filter_backends = [OrderingFilter,DjangoFilterBackend]
    ordering_fields=['price','students','id']
    filter_fields = ('course_category',)  # 按课程分类过滤
    

4.3 路由

router.register('course_list', views.CourseView, 'course_list')

4.4使用排序，过滤

http://127.0.0.1:8000/course/course_list/?ordering=id  #排序 默认升序
http://127.0.0.1:8000/course/course_list/?ordering=-id #降序

4.5分页功能

新建一个page

from rest_framework.pagination import PageNumberPagination

class MyPageNumberPagination(PageNumberPagination):
    page_size = 2
    page_query_param = 'page'
    page_size_query_param = 'size'
    max_page_size = 5
    
    
    
#views视图类使用
    pagination_class = MyPageNumberPagination#分页

5 课程详情后台接口 和查询所有公用一个接口

# 前端的某一个页面的构成，不一定是一个接口

#总结：目前一共写了下面这4个接口

# 课程分类接口
# 查询所有课程接口（排序，过滤，分页）
# 查询单个课程详情接口（就用了上面查询所以，只是配置了一个：RetrieveModelMixin）
# 查询所有章节接口（可以按课程过滤）

5.1 视图类

# 查询课程详情和查询所有课程接口 和查询所有课程共用一个接口
class CourseView(GenericViewSet, ListModelMixin,RetrieveModelMixin):
    serializer_class = CourseSerializer
    queryset = Course.objects.filter(is_show=True, is_delete=False).order_by('orders')

    # 过滤 课程分类
    # 排序功能：价格，人数，id
    filter_backends = [OrderingFilter, DjangoFilterBackend]
    ordering_fields = ['price', 'students', 'id']  # 按price，student，id排序
    filter_fields = ('course_category',)  # 按课程分类过滤
    # 分页
    pagination_class = CommonPageNumberPagination

6 查询所有章节接口

6.1 序列化类

class CourseSectionSerializer(serializers.ModelSerializer):
    class Meta:
        model = CourseSection
        fields = ['id', 'name', 'orders', 'section_link', 'duration', 'free_trail']


class CourseChapterSerializer(serializers.ModelSerializer):
    class Meta:
        model = CourseChapter
        fields = ['id', 'name', 'coursesections']

    # 子序列化，注意many=True
    # 方式一：
    coursesections = CourseSectionSerializer(many=True)
    # 方式二：
    # coursesections=serializers.SerializerMethodField()
    # def get_coursesections(self,obj):
    #     return []

    # 方式三：写在models中
    def coursesections（self）:
        return[]

6.2 视图类

# 课程章节接口
class CourseChapterView(GenericViewSet, ListModelMixin):
    # 查询所有章节
    # 按课程过滤功能
    queryset = CourseChapter.objects.all()
    serializer_class = CourseChapterSerializer
    filter_backends = [DjangoFilterBackend]
    filter_fields = ('course',)

6.3 路由

router.register('course_chapter', views.CourseChapterView, 'course_chapter')