springboot+mybatis+mybatis-plus对crud项目进行改进

springboot+mybatis实现简单的增、删、查、改https://blog.csdn.net/heyl163_/article/details/132197201上一篇文章，已经详细地介绍了怎么通过springboot项目整合mybatis实现简单的数据库表的增删改查功能，是最简单的springboot项目的结构。所以有很多问题，包括简单sql语句需要重复编写、数据校验、异常处理、操作类方法没有返回响应等等。这篇文章我们通过使用springmvc的全局异常处理机制以及引入mybatis-plus和validation来解决这几个问题。

基于上一篇文章的项目，新建一个分支springboot1.0，保存最新的代码。

一、简单sql语句重复编写问题

通过引入mybatis-plus来解决重复编写简单sql语句的问题。

在pom.xml中引入mybatis-plus的依赖

    3.5.1




    com.baomidou
    mybatis-plus-boot-starter
    ${mybatis-plus.version}

然后SongMapper继承BaseMapper接口，然后就能调用BaseMapper里预先定义的crud方法了。

package com.example.springboot.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.example.springboot.entity.Song;
import org.springframework.stereotype.Repository;

/**
 * @author heyunlin
 * @version 1.0
 */
@Repository
public interface SongMapper extends BaseMapper {

}

BaseMapper的参数类型为对应实体类的类型；

 

因为BaseMapper里有几个方法selectById()、deleteById()、updateById()需要用到表的主键，因此，在实体类上需要通过注解@TableId来标注哪个字段是表的主键；

 

如果数据库表名和实体类的类名不一致，需要通过@TableName注解指明对应的数据库表；

 

如果数据库表名的字段名和实体类的属性名不一致，需要通过@TableField注解指明对应的数据库表的字段；

package com.example.springboot.entity;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;

import java.io.Serializable;
import java.time.LocalDateTime;

/**
 * 歌曲
 * @author heyunlin
 * @version 1.0
 */
@Data
@TableName("song")
public class Song implements Serializable {
    private static final long serialVersionUID = 18L;

    @TableId(type = IdType.INPUT)
    private String id;

    /**
     * 歌曲名
     */
    @TableField("name")
    private String name;

    /**
     * 歌手
     */
    @TableField("singer")
    private String singer;

    /**
     * 描述信息
     */
    @TableField("note")
    private String note;

    /**
     * 最后一次修改时间
     */
    @TableField("last_update_time")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    private LocalDateTime lastUpdateTime;
}

然后，删除SongMapper.java中编写的方法和对应SongMapper.xml中的statement

删除之后惊奇地发现service中调用mapperde的方法并没有报错，因为这些方法已经预定义在BaseMapper中了。

mybatis-plus使用简单，归根于BaseMapper中预先帮我们实现的方法，接下来详细介绍这些方法的作用。

package com.baomidou.mybatisplus.core.mapper;

import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.core.toolkit.CollectionUtils;
import com.baomidou.mybatisplus.core.toolkit.ExceptionUtils;
import java.io.Serializable;
import java.util.Collection;
import java.util.List;
import java.util.Map;
import org.apache.ibatis.annotations.Param;

public interface BaseMapper extends Mapper {
    // 添加，如果字段值为null，则不会设置到insert语句中
    int insert(T entity);

    // 通过id删除，id字段的类型需要实现Serializable接口
    int deleteById(Serializable id);

    int deleteById(T entity);

    // 条件删除，把条件放到Map中，map的key是数据库表的字段名，map的value是字段的值
    int deleteByMap(@Param("cm") Map columnMap);

    // 条件删除，通过条件构造器来设置条件
    int delete(@Param("ew") Wrapper queryWrapper);

    // 通过ID批量删除，相当于delete from xxx where id in idList
    int deleteBatchIds(@Param("coll") Collection idList);

    // 通过id修改，如果字段值为null，则不会设置到update语句中
    int updateById(@Param("et") T entity);

    // 条件修改，通过条件构造器来设置条件，entity中的数据为Wrapper的set()方法设置的字段值
    int update(@Param("et") T entity, @Param("ew") Wrapper updateWrapper);

    // 通过id查询，id字段的类型需要实现Serializable接口
    T selectById(Serializable id);

    // 通过ID批量查询，相当于select * from xxx where id in idList
    List selectBatchIds(@Param("coll") Collection idList);

    // 条件查询，通过条件构造器来设置查询条件
    List selectByMap(@Param("cm") Map columnMap);

    // 条件查询，通过条件构造器来设置查询条件
    // 如果确定查询最多只有一行结果，可以使用该方法，否则将报错
    default T selectOne(@Param("ew") Wrapper queryWrapper) {
        List ts = this.selectList(queryWrapper);
        if (CollectionUtils.isNotEmpty(ts)) {
            if (ts.size() != 1) {
                throw ExceptionUtils.mpe("One record is expected, but the query result is multiple records", new Object[0]);
            } else {
                return ts.get(0);
            }
        } else {
            return null;
        }
    }

    // existes语句
    default boolean exists(Wrapper queryWrapper) {
        Long count = this.selectCount(queryWrapper);
        return null != count && count > 0L;
    }

    // 条件查询记录数，通过条件构造器来设置查询条件
    Long selectCount(@Param("ew") Wrapper queryWrapper);

    // 条件查询，通过条件构造器来设置查询条件
    // 当查询结果有多条时，不能使用selectOne，需要使用该方法
    List selectList(@Param("ew") Wrapper queryWrapper);

    List> selectMaps(@Param("ew") Wrapper queryWrapper);

    List