数据库设计规约

注意：数据库设计规约并不是数据库设计的严格规范，根据不同团队的不同要求设计
本项目参考《阿里巴巴Java开发手册》：五、MySQL数据库

1、库名与应用名称尽量一致

2、表名、字段名必须使用小写字母或数字，禁止出现数字开头，

3、表名不使用复数名词

4、表的命名最好是加上“业务名称_表的作用”。如，edu_teacher

5、表必备三字段：id, gmt_create, gmt_modified

6、单表行数超过 500 万行或者单表容量超过 2GB，才推荐进行分库分表。 说明：如果预计三年后的数据量根本达不到这个级别，请不要在创建表时就分库分表。

7、表达是与否概念的字段，必须使用 is_xxx 的方式命名，数据类型是 unsigned tinyint （1 表示是，0 表示否）。

说明：任何字段如果为非负数，必须是 unsigned。

注意：POJO 类中的任何布尔类型的变量，都不要加 is 前缀。数据库表示是与否的值，使用 tinyint 类型，坚持 is_xxx 的 命名方式是为了明确其取值含义与取值范围。

正例：表达逻辑删除的字段名 is_deleted，1 表示删除，0 表示未删除。

8、小数类型为 decimal，禁止使用 float 和 double。 说明：float 和 double 在存储的时候，存在精度损失的问题，很可能在值的比较时，得到不 正确的结果。如果存储的数据范围超过 decimal 的范围，建议将数据拆成整数和小数分开存储。

9、如果存储的字符串长度几乎相等，使用 char 定长字符串类型。

10、varchar 是可变长字符串，不预先分配存储空间，长度不要超过 5000，如果存储长度大于此值，定义字段类型为 text，独立出来一张表，用主键来对应，避免影响其它字段索引效率。

11、唯一索引名为 uk_字段名(unique key)；普通索引名则为 idx_字段名(index)。

说明：uk_ 即 unique key；idx_ 即 index 的简称

12、不得使用外键与级联，一切外键概念必须在应用层解决。外键与级联更新适用于单机低并发，不适合分布式、高并发集群；级联更新是强阻塞，存在数据库更新风暴的风险；外键影响数据库的插入速度。

一、后端实现
前端到后端的流程一定要理解！?。?！
断点调试一定要使用?。?！

后端就是一个输入和输出的过程，
明确目标

1. 我需要输入什么
2. 我需要输出什么

1. 定义对象

1、定义搜索对象

CourseQueryVo.java
package com.atguigu.guli.service.edu.entity.vo;

@Data
public class CourseQueryVo implements Serializable {

    private static final long serialVersionUID = 1L;

    private String title;
    private String teacherId;
    private String subjectParentId;
    private String subjectId;
}

2、定义查询结果对象

package com.atguigu.guli.service.edu.entity.vo;

@Data
public class CourseVo implements Serializable {

    private static final long serialVersionUID = 1L;
    private String id;
    private String title;
    private String subjectParentTitle;
    private String subjectTitle;
    private String teacherName;
    private Integer lessonNum;
    private String price;
    private String cover;
    private Long buyCount;
    private Long viewCount;
    private String status;
    private String gmtCreate;
}

2、web层

CourseController.java
@ApiOperation("分页课程列表")
@GetMapping("list/{page}/{limit}")
public R index(
    @ApiParam(value = "当前页码", required = true)
    @PathVariable Long page,

    @ApiParam(value = "每页记录数", required = true)
    @PathVariable Long limit,

    @ApiParam(value = "查询对象")
    CourseQueryVo courseQueryVo){

    IPage<CourseVo> pageModel = courseService.selectPage(page, limit, courseQueryVo);
    List<CourseVo> records = pageModel.getRecords();
    long total = pageModel.getTotal();
    return  R.ok().data("total", total).data("rows", records);
}

3、service层

难点：使用MyBatis Plus的分页插件和QueryWrapper结合自定义mapper xml实现多表关联查询
接口：CourseService.java
IPage<CourseVo> selectPage(Long page, Long limit, CourseQueryVo courseQueryVo);
实现：CourseServiceImpl.java

@Override
public IPage<CourseVo> selectPage(Long page, Long limit, CourseQueryVo courseQueryVo) {

    QueryWrapper<CourseVo> queryWrapper = new QueryWrapper<>();
    queryWrapper.orderByDesc("c.gmt_create");

    String title = courseQueryVo.getTitle();
    String teacherId = courseQueryVo.getTeacherId();
    String subjectParentId = courseQueryVo.getSubjectParentId();
    String subjectId = courseQueryVo.getSubjectId();

    if (!StringUtils.isEmpty(title)) {
        queryWrapper.like("c.title", title);
    }

    if (!StringUtils.isEmpty(teacherId) ) {
        queryWrapper.eq("c.teacher_id", teacherId);
    }

    if (!StringUtils.isEmpty(subjectParentId)) {
        queryWrapper.eq("c.subject_parent_id", subjectParentId);
    }

    if (!StringUtils.isEmpty(subjectId)) {
        queryWrapper.eq("c.subject_id", subjectId);
    }

    Page<CourseVo> pageParam = new Page<>(page, limit);
    //放入分页参数和查询条件参数，mp会自动组装  分页组件必须为第一个参数??！
    List<CourseVo> records = baseMapper.selectPageByCourseQueryVo(pageParam, queryWrapper);
    pageParam.setRecords(records);
    return pageParam;
}

4、mapper层

接口：CourseMapper.java

List<CourseVo> selectPageByCourseQueryVo(
    //mp会自动组装分页参数
    Page<CourseVo> pageParam,
    //mp会自动组装queryWrapper：
    //@Param(Constants.WRAPPER) 和 xml文件中的 ${ew.customSqlSegment} 对应
    @Param(Constants.WRAPPER) QueryWrapper<CourseVo> queryWrapper);

xml：CourseMapper.xml

注意：写Sql的时候千万不能加 ；(分号) 因为mybatisplus会在你原先的SQL后拼接语句但不会自动去除原先SQL中的分号导致最后语句执行错误

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.atguigu.guli.service.edu.mapper.CourseMapper">
    <sql id="columns">
     c.id,
     c.title,
     c.lesson_num AS lessonNum,
     CONVERT(c.price, DECIMAL(8,2)) AS price,
     c.cover,
     c.buy_count AS buyCount,
     c.view_count AS viewCount,
     c.status,
     c.gmt_create AS gmtCreate,
     t.name AS teacherName,
     s1.title AS subjectParentTitle,
     s2.title AS subjectTitle
    </sql>
    <sql id="tables">
        edu_course c
        LEFT JOIN edu_teacher t ON c.teacher_id = t.id
        LEFT JOIN edu_subject s1 ON c.subject_parent_id = s1.id
        LEFT JOIN edu_subject s2 ON c.subject_id = s2.id
    </sql>
    <select id="selectPageByCourseQueryVo" resultType="com.atguigu.guli.service.edu.entity.vo.CourseVo">
        SELECT
        <include refid="columns" />
        FROM
        <include refid="tables" />
        ${ew.customSqlSegment}
    </select>
</mapper>