SpringBoot快速整合通用Mapper

前言

后端业务开发，每个表都要用到单表的增删改查等通用方法，而配置了通用Mapper可以极大的方便使用Mybatis单表的增删改查操作。

通用mapper配置

1、添加maven:

<dependency>  <groupId>org.springframework.boot</groupId>  <artifactId>spring-boot-starter-web</artifactId></dependency><!--通用mapper--><dependency>  <groupId>tk.mybatis</groupId>  <artifactId>mapper-spring-boot-starter</artifactId>  <version>2.1.5</version></dependency><!-- pagehelp --><dependency>  <groupId>com.github.pagehelper</groupId>  <artifactId>pagehelper-spring-boot-starter</artifactId>  <version>1.2.3</version></dependency>

2、Application启动文件添加MapperScan注解

在springboot启动类添加 tk.mybatis包下MapperScan注解

import tk.mybatis.spring.annotation.MapperScan;@SpringBootApplication@MapperScan("com.springboot.dao")public class Application extends SpringBootServletInitializer {	public static void main(String[] args) {		SpringApplication.run(Application.class, args);	}}

其中com.springboot.dao是dao层的路径。

3、Model添加注解

添加 Table注解和Id注解，

• Table 填写数据表名
• id写在主键字段上

例如下方的User实体：

@Table(name = "t_user")public class User {    //主键    @Id    @GeneratedValue(strategy = GenerationType.IDENTITY)//自增    private Integer id;  }  

4、创建MyMapper

import tk.mybatis.mapper.common.IdsMapper;import tk.mybatis.mapper.common.Mapper;public interface MyMapper<T> extends Mapper<T>, IdsMapper<T> {}

需要实现的通用接口都写在MyMapper的继承类中，该类的包不能被MapperScan扫描到。

• Mapper<T> 包含了大量的单表操作。
• IdsMapper<T> 是通过多个id查询和删除的方法。

5、每个dao继承步骤4的MyMapper

例如UserDao继承MyMapper<User> :

public interface UserDao extends MyMapper<User> {}

通用service

上面配置只是调用dao层可以有默认的增删改查的方法，还是要在对应的service添加增删查改，所以需要写一个通用service，把公共的方法都抽象到一个基础方法中。

BaseService.java接口:

public interface BaseService<T> {    /**     * 查询所有     *     * @return 返回所有数据     */    List<T> selectAll();    /**     * 查询数据数量     * @return     */    int selectCount();    /**     * 添加     *     * @param t   实体     *     * @return     */    int save(T t);    /**     * 修改     *     * @param t     *            实体     * @return     */    int updateByPrimaryKey(T t);    /**     * 根据主键删除     *     * @param t   主键     *     * @return     */    int deleteByPrimaryKey(int t);}

BaseServiceImpl实现类:

public class BaseServiceImpl<T> implements BaseService<T> {    @Autowired    private MyMapper<T> mapper;    @Override    public List<T> selectAll() {        return mapper.selectAll();    }    @Override    public int selectCount() {        return mapper.selectCount(null);    }    @Override    public int save(T t) {        return mapper.insert(t);    }    @Override    public int updateByPrimaryKey(T t) {        return mapper.updateByPrimaryKey(t);    }    @Override    public int deleteByPrimaryKey(int t) {        return mapper.deleteByPrimaryKey(t);    }}

所有的service和serviceImpl都分别继承BaseService和BaseServiceImpl，例如UserService和UserServiceImpl分别继承BaseService和BaseServiceImpl:

public interface UserService extends BaseService<User>{}

@Servicepublic class UserServiceImpl extends BaseServiceImpl<User> implements UserService{}

配置完成之后，在对应的controller调用，比如UserController:

@RestController@RequestMapping("/user")public class UserController {    @Autowired    private UserService userService;    @PostMapping("/add")    public Object add(User user) {        userService.save(user);        return null;    }    @PostMapping("/delete")    public Object delete(@RequestParam Integer id) {        userService.deleteByPrimaryKey(id);        return null;    }    @PostMapping("/update")    public Object update(User user) {        userService.updateByPrimaryKey(user);        return null;    }    @GetMapping("/detail")    public User detail(@RequestParam Integer id) {        User user = userService.selectById(id);         return user;    }    @GetMapping("/list")    public List<User> list() {       List<User> list = userService.list();       return list;    }}

总结

通用mapper：

• 创建SpringBoot启动文件添加MapperScan，扫描dao层的包。
• 创建MyMapper<T> 接口，根据自己需求继承要用的接口，比如Mapper<T>。
• 每个dao接口继承MyMapper<T>接口。

通用service

• 创建BaseService接口。
• BaseServiceImpl实现类，调用MyMapper<T>实现增删改查方法。
• 每个service接口和service实现类分别继承BaseService接口和BaseServiceImpl实现类。
• 每个controller就能调用通用方法。

遇到的问题

1、启动报错

required a bean of type 'com.jeremy.data.utils.MyMapper' that could not be found.

没有找到MyMapper对应的bean，无法注入。

解决方案：
1、SpringBoot启动文件添加MapperScan注解。
2、每个dao接口都要继承MyMapper。

以上两个步骤缺一不可。

github源码

https://github.com/jeremylai7/springboot-bootstrap