今天主要完成了：

新增棋子分类

棋子分类列表

获取棋子分类详情

更新棋子分类

更新棋子分类和添加棋子分类_分组校验

新增棋子

新增棋子参数校验

棋子分类列表查询(条件分页)

先给出分类实体类

@Data
public class Category {private Integer id;//主键ID@NotEmptyprivate String categoryName;//分类名称(赛季全名)@NotEmptyprivate String categoryAlias;//分类别名(赛季版本号)private Integer createUser;//创建人IDprivate LocalDateTime createTime;//创建时间private LocalDateTime updateTime;//更新时间
}

新增棋子分类

接口文档

 

读接口文档，需求就是一个@Insert，但是发现接口文档没有考虑到可能会有重复分类的创建，我认为重复分类的创建是不合适的，所以我做了一个分类存在检测以防止重复分类的出现

基本属于User新建的小修小改，直接上代码

Controller层

    @PostMappingpublic Result add(@RequestBody @Validated Category category){String init_name = category.getCategoryName();Category incategory = categoryService.getCategoryByNAME(init_name);if (incategory == null){        categoryService.add(category);return Result.success();} else {return Result.error("棋子分类已存在！");}}

写了一个条件判断来防止重复分类的出现，用json里给的分类名查分类是否存在

Service层

    @Overridepublic void add(Category category) {Map<String,Object> map = ThreadLocalUtil.get();Integer id  = (Integer) map.get("id");category.setCreateTime(LocalDateTime.now());category.setUpdateTime(LocalDateTime.now());category.setCreateUser(id);categoryMapper.add(category);}@Overridepublic Category getCategoryByNAME(String init_name) {Category c = categoryMapper.getCategoryByNAME(init_name);return c;}

一个新增一个查询，为了达成给分类写入创建人相关信息，还是老方法，从ThreadLocal里面取

Mapper层

    @Insert("insert into category(category_name,category_alias,create_user,create_time,update_time) " +"values(#{categoryName},#{categoryAlias},#{createUser},#{createTime},#{updateTime}) ")void add(Category category);@Select("Select * from category where category_name = #{init_name}")Category getCategoryByNAME(String init_name);

 搞定

棋子分类列表

接口文档

 可以看到，这次不需要接入任何参数，返回的是一个棋子分类列表，区别不大，开搞！

ps:突然发现接口文档要求的时间格式跟直接捞出来的localdatatime格式不一样，这是个问题

Controller层

    @GetMappingpublic Result<List<Category>> list(){List<Category> categoryList = categoryService.list();return Result.success(categoryList);}

Service层

    @Overridepublic List<Category> list() {Map<String,Object> map = ThreadLocalUtil.get();Integer id  = (Integer) map.get("id");return categoryMapper.list(id);}

老规矩，ThreadLocal拿用户信息 

Mapper层

    @Select("select * from category where create_user = #{id}")List<Category> list(Integer id);

解决给出时间格式需修改问题 

在实体类中用 @JsonFormat接口

    private LocalDateTime createTime;//创建时间@JsonFormat(pattern = TIME_REGEXP)private LocalDateTime updateTime;//更新时间

RT，相应的也更新了我的正则文件

    public static final String TIME_REGEXP = "^yyyy-MM-dd HH:mm:ss";

搞定收工 

 

获取棋子分类详情

接口文档

 

阅读接口文档，通过分类ID获取分类全部信息，再多考虑下非法ID输入就行

Controller层

    @GetMapping("detail")public Result<Category> getDetail(Integer id){Category category = categoryService.getCategoryByID(id);if (category == null){return Result.error("查询分类不存在！");}else {return Result.success(category);}}

做了个简单逻辑判断来确保查询的分类是存在的 

Service层

    @Overridepublic Category getCategoryByID(Integer init_ID) {return categoryMapper.getCategoryByID(init_ID);}

Mapper层

    @Select("Select * from category where id = #{init_ID}")Category getCategoryByID(Integer init_ID);

 顺手修改下新增棋子接口

由于这个按ID查询棋子和新增棋子接口用的按分类名查询实际上效果一样，为了提高代码复用率，把新增棋子接口的查询直接改成按ID查询，如下：

    @PostMappingpublic Result add(@RequestBody @Validated Category category){Integer init_ID = category.getId();Category incategory = categoryService.getCategoryByID(init_ID);if (incategory == null){        categoryService.add(category);return Result.success();} else {return Result.error("棋子分类已存在！");}}

（别忘了删除其他基层的按分类名查询） 

 

 

更新棋子分类

接口文档

 

 读接口文档，注意下参数校验和身份验证就行

先看Controller层

    @PutMappingpublic Result update(@RequestBody @Validated Category incategory){Category category = categoryService.getCategoryByID(incategory.getId());if (category == null){return Result.error("要修改的分类不存在！");}else {Integer userID = category.getCreateUser();Map<String,Object> map = ThreadLocalUtil.get();Integer id_user  = (Integer) map.get("id");if (userID.equals(id_user)){categoryService.update(incategory);return Result.success();}else {return Result.error("您所要更改的分类不属于您！");}}}

先对要更改的分类存不存在进行验证，如果存在在进行身份验证，都验证通过了就可以进行修改操作了

Service层

    @Overridepublic void update(Category category) {category.setUpdateTime(LocalDateTime.now());categoryMapper.update(category);}

Mapper层

    @Update("update category set category_name = #{categoryName} , category_alias = #{categoryAlias} , update_time = #{updateTime} where id = #{id}")void update(Category category);

对了，要在实体类中给id加一个@NotNull注解来验证

    @NotNullprivate Integer id;//主键ID

搞定收工 

 

更新棋子分类和添加棋子分类_分组校验

由于我们在刚刚写修改棋子分类的时候给ID加上了notnull的注解，导致了在每次检验CateGory对象的时候都会检验id是否为null，而我们在写新增分类的时候由于id是会自增的所以我们并没有传入棋子id。这时，刚刚的更改会导致新增分类接口无法正常使用，为了解决这个问题，我们就要用到分组校验

分组校验

把校验项进行归类分组，在完成不同功能的时候，校验指定组中的校验项

步骤

1.定义分组

使用接口来定义分组

例如我们要给category加add和update两个分组，我们就可以在其实体类中定义如下两个分组

    public interface Add{}public interface Update{}

2.定义校验项时指定归属的分组

如下例：

    @NotNull(groups = Update.class)private Integer id;//主键ID@NotEmpty(groups = {Update.class,Add.class})private String categoryName;//分类名称@NotEmpty(groups = {Update.class,Add.class})private String categoryAlias;//分类别名

可以看到，分组可以同时指定多个，用{}来承接 

3.校验时指定要校验的分组

 public Result add(@RequestBody @Validated(Category.Add.class) Category category){public Result update(@RequestBody @Validated(Category.Update.class) Category incategory){

小优化

校验分组存在如下两条规则

1.如果某个校验项没有指定分组，则默认属于Defult分组

2.分组之间可以继承，A extends B，则A中继承B中所有的校验项目

那么我们可以对上例进行如下优化：

我们可以看到add和update的唯一区别就是对于ID非空的检验，所以我们可以让其他所有校验直接进入Defult组，并让我们自定义的两个分组都继承Defult组，add独立的划入对于ID的飞控检查

@Data
public class Category {@NotNull(groups = Update.class)private Integer id;//主键ID@NotEmptyprivate String categoryName;//分类名称@NotEmptyprivate String categoryAlias;//分类别名private Integer createUser;//创建人ID@JsonFormat(pattern = TIME_REGEXP)private LocalDateTime createTime;//创建时间@JsonFormat(pattern = TIME_REGEXP)private LocalDateTime updateTime;//更新时间public interface Add extends Default {}public interface Update extends Default {}