SpringBoot实战第三天

今天主要完成了：

新增棋子分类

棋子分类列表

获取棋子分类详情

更新棋子分类

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

新增棋子

新增棋子参数校验

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

先给出分类实体类

@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 {}