谷粒学院-day2

主要任务
image.png

前后端分离开发概念

image.png
开发接口指的不是开发interface,而是开发controller,mapper,service的过程

数据库设计规约

以下规约只针对本模块,更全面的文档参考《阿里巴巴Java开发手册》:五、MySQL数据库
1、库名与应用名称尽量一致

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

3、表名不使用复数名词

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

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

说明:
其中 id 必为主键,类型为 bigint unsigned、单表时自增、步长为 1。
(如果使用分库分表集群部署,则id类型为verchar,非自增,业务中使用分布式id生成器)
gmt_create, gmt_modified 的类型均为 datetime 类型,前者现在时表示主动创建,后者过去分词表示被 动更新。

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_字段名;普通索引名则为 idx_字段名。
说明:uk_ 即 unique key;idx_ 即 index 的简称

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

创建项目结构

  • 创建父工程
    • pom类型 管理版本依赖和放公共依赖
    • 在父工程中创建子模块
    • 在子模块中还可以创建子模块

image.png

项目结构

image.png

模块说明

guli-parent:在线教学根目录(父工程),管理四个子模块:
** canal-client:canal数据库表同步模块(统计同步数据)**
** common:公共模块父节点**
common-util:工具类模块,所有模块都可以依赖于它
service-base:service服务的base包,包含service服务的公共配置类,所有service模块依赖于它
spring-security:认证与授权模块,需要认证授权的service服务依赖于它
** infrastructure:基础服务模块父节点**
api-gateway:api网关服务
** service:api接口服务父节点**
service-acl:用户权限管理api接口服务(用户管理、角色管理和权限管理等)
service-cms:cms api接口服务
service-edu:教学相关api接口服务
service-msm:短信api接口服务
service-order:订单相关api接口服务
service-oss:阿里云oss api接口服务
service-statistics:统计报表api接口服务
service-ucenter:会员api接口服务
service-vod:视频点播api接口服务

开发讲师管理模块(后端)

准备工作

  1. 创建数据库,创建讲师数据表

image.png

  1. 搭建项目结构,配置pom.xml文件

image.png

  1. 创建application配置文件,使用CodeGenerator代码生成器自动生成代码

image.png
image.png
常设为绝对路径
image.png
主键策略写成你主键的类型,此处主键类型为char类型,用ID_WORKER_STR,如果为long类型,用ID_WORKER
image.png
日期类型,数据库中的日期类型为datetime,而实体类中的日期类型为date
image.png
生成的结果如下
image.png

  1. finall

image.png
日期格式问题
image.png
application.properties中添加

#返回json的全局时间格式
spring.jackson.date-format=yyyy-MM-dd HH:mm:ss
spring.jackson.time-zone=GMT+8

image.png

  1. 逻辑删除

image.png

  1. 配置swagger
    1. 创建公共模块common,整合swagger,使所有模块都能访问到,
      1. 需要导入的模块的pom文件引入公共模块
      2. 在启动类上添加注解,配置包扫描规则 @ComponentScan(basePackages = { “com.xuan”})
    2. 编写配置类
    3. 访问 http://localhost:8001/swagger-ui.html
  2. 统一返回数据格式
  3. 项目中我们会将相应封装成json,一般我们会将所有接口的数据格式统一,使前端对数据的操作更一致,轻松。我们的系统要求返回的基本格式如下

列表:
image.png
分页:
image.png
没有返回数据:
image.png
失败:
image.png
因此,我们定义统一结果
image.png

  1. 创建接口定义返回码,创建结果类,在service模块中添加依赖,最后修改controller中的返回结果

  1. 分页查询
    1. MyBatisPlusConfig中配置分页插件

image.png

  1. 分页Controller方法

image.png

  1. Swagger中测试
  2. 分页条件查询
    1. 配置mp分页插件
    2. 编写讲师分页查询接口的方法
    3. 封装好条件值到vo类里
    4. RequestBody:必须使用post提交,使用json传数据,把json数据封装到对应对象里面
    5. ResponseBody:返回数据为json数据image.png
  3. 新增和修改讲师
  4. 在service-base模块中添加包handler,创建自动填充类image.png
  5. 实体类添加自动填充注解 image.png
  6. 编写controllerimage.png
  7. image.png
  8. 统一异常处理
  9. 注解ControllerAdvice与ExceptionHandler搭配使用
  10. image.png
  11. base模块中引入common模块

猜你喜欢

转载自blog.csdn.net/weixin_45660485/article/details/122414124