今天主要完成了：
新增棋子分类
棋子分类列表
获取棋子分类详情
更新棋子分类
更新棋子分类和添加棋子分类_分组校验
新增棋子
新增棋子参数校验
棋子分类列表查询(条件分页)
先给出分类实体类
@Data
public class Category {
private Integer id;//主键ID
@NotEmpty
private String categoryName;//分类名称(赛季全名)
@NotEmpty
private String categoryAlias;//分类别名(赛季版本号)
private Integer createUser;//创建人ID
private LocalDateTime createTime;//创建时间
private LocalDateTime updateTime;//更新时间
}
新增棋子分类
接口文档
读接口文档，需求就是一个@Insert，但是发现接口文档没有考虑到可能会有重复分类的创建，我认为重复分类的创建是不合适的，所以我做了一个分类存在检测以防止重复分类的出现
基本属于User新建的小修小改，直接上代码
Controller层
@PostMapping
public 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层
@Override
public 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);
}
@Override
public 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层
@GetMapping
public Result<List<Category>> list(){
List<Category> categoryList = categoryService.list();
return Result.success(categoryList);
}Service层
@Override
public 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层
@Override
public 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查询，如下：
@PostMapping
public 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层
@PutMapping
public 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层
@Override
public 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注解来验证
@NotNull
private 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
@NotEmpty
private String categoryName;//分类名称
@NotEmpty
private 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 {}
