当前位置:   article > 正文

springboot配置MybatisPlus

springboot配置mybatisplus

前言:

mybatis在持久层框架中还是比较火的,一般项目都是基于ssm。虽然mybatis可以直接在xml中通过SQL语句操作数据库,很是灵活。但正其操作都要通过SQL语句进行,就必须写大量的xml文件,很是麻烦。mybatis-plus就很好的解决了这个问题。

一、mybatis-plus简介:

Mybatis-Plus(简称MP)是一个 Mybatis 的增强工具,在 Mybatis 的基础上只做增强不做改变,为简化开发、提高效率而生。这是官方给的定义,关于mybatis-plus的更多介绍及特性,可以参考mybatis-plus官网。那么它是怎么增强的呢?其实就是它已经封装好了一些crud方法,我们不需要再写xml了,直接调用这些方法就行,就类似于JPA。

二、spring整合mybatis-plus:

正如官方所说,mybatis-plus在mybatis的基础上只做增强不做改变,因此其与spring的整合亦非常简单。只需把mybatis的依赖换成mybatis-plus的依赖,再把sqlSessionFactory换成mybatis-plus的即可。接下来看具体操作:
1、pom.xml:
核心依赖如下:

  1. <!-- spring -->
  2. <dependency>
  3. <groupId>org.springframework</groupId>
  4. <artifactId>spring-context</artifactId>
  5. <version>4.3.14.RELEASE</version>
  6. </dependency>
  7. <dependency>
  8. <groupId>org.springframework</groupId>
  9. <artifactId>spring-orm</artifactId>
  10. <version>4.3.14.RELEASE</version>
  11. </dependency>
  12. <dependency>
  13. <groupId>org.springframework</groupId>
  14. <artifactId>spring-test</artifactId>
  15. <version>4.3.14.RELEASE</version>
  16. <scope>test</scope>
  17. </dependency>
  18. <!-- mp 依赖 -->
  19. <dependency>
  20. <groupId>com.baomidou</groupId>
  21. <artifactId>mybatis-plus</artifactId>
  22. <version>2.3</version>
  23. </dependency>

注意:这些是核心依赖,本项目还用到了mysql驱动、c3p0、日志(slf4j-api,slf4j-log4j2)、lombok。集成mybatis-plus要把mybatis、mybatis-spring去掉,避免冲突;lombok是一个工具,添加了这个依赖,开发工具再安装Lombok插件,就可以使用它了,最常用的用法就是在实体类中使用它的@Data注解,这样实体类就不用写set、get、toString等方法了。关于Lombok的更多用法,请自行百度。

2、log4j.xml:

  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
  3. <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
  4. <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
  5. <param name="Encoding" value="UTF-8" />
  6. <layout class="org.apache.log4j.PatternLayout">
  7. <param name="ConversionPattern" value="%-5p %d{MM-dd
  8. HH:mm:ss,SSS} %m (%F:%L) \n" />
  9. </layout>
  10. </appender>
  11. <logger name="java.sql">
  12. <level value="debug" />
  13. </logger>
  14. <logger name="org.apache.ibatis">
  15. <level value="info" />
  16. </logger>
  17. <root>
  18. <level value="debug" />
  19. <appender-ref ref="STDOUT" />
  20. </root>
  21. </log4j:configuration>

3、jdbc.properties:

  1. jdbc.driver=com.mysql.jdbc.Driver
  2. jdbc.url=jdbc:mysql:///数据库名?useUnicode=true&characterEncoding=utf8
  3. jdbc.username=#
  4. jdbc.password=#

4、mybatis-config.xml:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE configuration
  3. PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  4. "http://mybatis.org/dtd/mybatis-3-config.dtd">
  5. <configuration>
  6. </configuration>

注:因为是与spring整合,所有mybatis-plus的大部分都写在spring的配置文件中,这里定义一个空的mybatis-config.xml即可。

5、spring-dao.xml:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <beans xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4. xmlns:p="http://www.springframework.org/schema/p"
  5. xmlns:aop="http://www.springframework.org/schema/aop"
  6. xmlns:context="http://www.springframework.org/schema/context"
  7. xmlns:jee="http://www.springframework.org/schema/jee"
  8. xmlns:tx="http://www.springframework.org/schema/tx"
  9. xsi:schemaLocation="
  10. http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.0.xsd
  11. http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
  12. http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd
  13. http://www.springframework.org/schema/jee http://www.springframework.org/schema/jee/spring-jee-4.0.xsd
  14. http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.0.xsd">
  15. <!-- 配置整合mybatis-plus过程 -->
  16. <!-- 1、配置数据库相关参数properties的属性:${url} -->
  17. <context:property-placeholder location="classpath:jdbc.properties" />
  18. <!-- 2、配置数据库连接池 -->
  19. <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
  20. <property name="driverClass" value="${jdbc.driver}"/>
  21. <property name="jdbcUrl" value="${jdbc.url}"/>
  22. <property name="user" value="${jdbc.username}"/>
  23. <property name="password" value="${jdbc.password}"/>
  24. </bean>
  25. <!-- mybatis的sqlsessionFactorybean:org.mybatis.spring.SqlSessionFactoryBean-->
  26. <!-- 3、配置mybatis-plus的sqlSessionFactory -->
  27. <bean id="sqlSessionFactory" class="com.baomidou.mybatisplus.spring.MybatisSqlSessionFactoryBean">
  28. <property name="dataSource" ref="dataSource" />
  29. <property name="configLocation" value="classpath:mybatis-config.xml"/>
  30. <property name="typeAliasesPackage" value="com.zhu.mybatisplus.entity"/>
  31. </bean>
  32. <!-- 4、DAO接口所在包名,Spring会自动查找其下的类 -->
  33. <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
  34. <property name="basePackage" value="com.zhu.mybatisplus.dao" />
  35. <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
  36. </bean>
  37. </beans>

6、entity:

  1. @Data
  2. @TableName(value = "tb_employee")//指定表名
  3. public class Employee {
  4. //value与数据库主键列名一致,若实体类属性名与表主键列名一致可省略value
  5. @TableId(value = "id",type = IdType.AUTO)//指定自增策略
  6. private Integer id;
  7. //若没有开启驼峰命名,或者表中列名不符合驼峰规则,可通过该注解指定数据库表中的列名,exist标明数据表中有没有对应列
  8. @TableField(value = "last_name",exist = true)
  9. private String lastName;
  10. private String email;
  11. private Integer gender;
  12. private Integer age;
  13. }

7、mapper:

  1. public interface EmplopyeeDao extends BaseMapper<Employee> {
  2. }

这样就完成了mybatis-plus与spring的整合。首先是把mybatis和mybatis-spring依赖换成mybatis-plus的依赖,然后把sqlsessionfactory换成mybatis-plus的,然后实体类中添加@TableName@TableId等注解,最后mapper继承BaseMapper即可。

8、测试:

  1. @RunWith(SpringJUnit4ClassRunner.class)
  2. @ContextConfiguration({"classpath:spring/spring-dao.xml"})
  3. public class test {
  4. @Autowired
  5. private DataSource dataSource;
  6. @Test
  7. public void testDataSource() throws SQLException {
  8. System.out.println(dataSource.getConnection());
  9. }
  10. }

运行该junit,可输出获取到的连接,说明整合没问题:


本文所有代码本人均亲自测试过,本文涉及代码又较多,为了不影响篇幅,故非必要处不再截图。接下来的所有操作都是基于此整合好的项目。
 

三、mp的通用crud:

需求:
存在一张 tb_employee 表,且已有对应的实体类 Employee,实现tb_employee 表的 CRUD 操作我们需要做什么呢?
基于 Mybatis:
需要编写 EmployeeMapper 接口,并在 EmployeeMapper.xml 映射文件中手动编写 CRUD 方法对应的sql语句
基于 MP:
只需要创建 EmployeeMapper 接口, 并继承 BaseMapper 接口。
我们已经有了Employee、tb_employee了,并且EmployeeDao也继承了BaseMapper了,接下来就使用crud方法。

1、insert操作:

  1. @RunWith(SpringJUnit4ClassRunner.class)
  2. @ContextConfiguration({"classpath:spring/spring-dao.xml"})
  3. public class test {
  4. @Autowired
  5. private EmplopyeeDao emplopyeeDao;
  6. @Test
  7. public void testInsert(){
  8. Employee employee = new Employee();
  9. employee.setLastName("东方不败");
  10. employee.setEmail("dfbb@163.com");
  11. employee.setGender(1);
  12. employee.setAge(20);
  13. emplopyeeDao.insert(employee);
  14. //mybatisplus会自动把当前插入对象在数据库中的id写回到该实体中
  15. System.out.println(employee.getId());
  16. }
  17. }

执行添加操作,直接调用insert方法传入实体即可。

2、update操作:

  1. @Test
  2. public void testUpdate(){
  3. Employee employee = new Employee();
  4. employee.setId(1);
  5. employee.setLastName("更新测试");
  6. //emplopyeeDao.updateById(employee);//根据id进行更新,没有传值的属性就不会更新
  7. emplopyeeDao.updateAllColumnById(employee);//根据id进行更新,没传值的属性就更新为null
  8. }

注:注意这两个update操作的区别,updateById方法,没有传值的字段不会进行更新,比如只传入了lastName,那么age、gender等属性就会保留原来的值;updateAllColumnById方法,顾名思义,会更新所有的列,没有传值的列会更新为null。

3、select操作:

(1)、根据id查询:

Employee employee = emplopyeeDao.selectById(1);

(2)、根据条件查询一条数据:

  1. Employee employeeCondition = new Employee();
  2. employeeCondition.setId(1);
  3. employeeCondition.setLastName("更新测试");
  4. //若是数据库中符合传入的条件的记录有多条,那就不能用这个方法,会报错
  5. Employee employee = emplopyeeDao.selectOne(employeeCondition);

注:这个方法的sql语句就是where id = 1 and last_name = 更新测试,若是符合这个条件的记录不止一条,那么就会报错。

(3)、根据查询条件返回多条数据:
当符合指定条件的记录数有多条时,上面那个方法就会报错,就应该用这个方法。

  1. Map<String,Object> columnMap = new HashMap<>();
  2. columnMap.put("last_name","东方不败");//写表中的列名
  3. columnMap.put("gender","1");
  4. List<Employee> employees = emplopyeeDao.selectByMap(columnMap);
  5. System.out.println(employees.size());

注:查询条件用map集合封装,columnMap,写的是数据表中的列名,而非实体类的属性名。比如属性名为lastName,数据表中字段为last_name,这里应该写的是last_name。selectByMap方法返回值用list集合接收。

(4)、通过id批量查询:

  1. List<Integer> idList = new ArrayList<>();
  2. idList.add(1);
  3. idList.add(2);
  4. idList.add(3);
  5. List<Employee> employees = emplopyeeDao.selectBatchIds(idList);
  6. System.out.println(employees);

注:把需要查询的id都add到list集合中,然后调用selectBatchIds方法,传入该list集合即可,该方法返回的是对应id的所有记录,所有返回值也是用list接收。

(5)、分页查询:

  1. List<Employee> employees = emplopyeeDao.selectPage(new Page<>(1,2),null);
  2. System.out.println(employees);

注:selectPage方法就是分页查询,在page中传入分页信息,后者为null的分页条件,这里先让其为null,讲了条件构造器再说其用法。这个分页其实并不是物理分页,而是内存分页。也就是说,查询的时候并没有limit语句。等配置了分页插件后才可以实现真正的分页。

4、delete操作:

(1)、根据id删除:

emplopyeeDao.deleteById(1);

(2)、根据条件删除:

  1. Map<String,Object> columnMap = new HashMap<>();
  2. columnMap.put("gender",0);
  3. columnMap.put("age",18);
  4. emplopyeeDao.deleteByMap(columnMap);

注:该方法与selectByMap类似,将条件封装在columnMap中,然后调用deleteByMap方法,传入columnMap即可,返回值是Integer类型,表示影响的行数。

(3)、根据id批量删除:

  1. List<Integer> idList = new ArrayList<>();
  2. idList.add(1);
  3. idList.add(2);
  4. emplopyeeDao.deleteBatchIds(idList);

注:该方法和selectBatchIds类似,把需要删除的记录的id装进idList,然后调用deleteBatchIds,传入idList即可。

四、全局策略配置:

通过上面的小案例我们可以发现,实体类需要加@TableName注解指定数据库表名,通过@TableId注解指定id的增长策略。实体类少倒也无所谓,实体类一多的话也麻烦。所以可以在spring-dao.xml的文件中进行全局策略配置。

  1. <!-- 5、mybatisplus的全局策略配置 -->
  2. <bean id="globalConfiguration" class="com.baomidou.mybatisplus.entity.GlobalConfiguration">
  3. <!-- 2.3版本后,驼峰命名默认值就是true,所以可不配置 -->
  4. <!--<property name="dbColumnUnderline" value="true"/>-->
  5. <!-- 全局主键自增策略,0表示auto -->
  6. <property name="idType" value="0"/>
  7. <!-- 全局表前缀配置 -->
  8. <property name="tablePrefix" value="tb_"/>
  9. </bean>

这里配置了还没用,还需要在sqlSessionFactory中注入配置才会生效。如下:

  1. <!-- 3、配置mybatisplus的sqlSessionFactory -->
  2. <bean id="sqlSessionFactory" class="com.baomidou.mybatisplus.spring.MybatisSqlSessionFactoryBean">
  3. <property name="dataSource" ref="dataSource" />
  4. <property name="configLocation" value="classpath:mybatis-config.xml"/>
  5. <property name="typeAliasesPackage" value="com.zhu.mybatisplus.entity"/>
  6. <!-- 注入全局配置 -->
  7. <property name="globalConfig" ref="globalConfiguration"/>
  8. </bean>

如此一来,实体类中的@TableName注解和@TableId注解就可以去掉了。
 

五、条件构造器(EntityWrapper):

以上基本的 CRUD 操作,我们仅仅需要继承一个 BaseMapper 即可实现大部分单表 CRUD 操作。BaseMapper 提供了多达 17 个方法供使用, 可以极其方便的实现单一、批量、分页等操作,极大的减少开发负担。但是mybatis-plus的强大不限于此,请看如下需求该如何处理:
需求:
我们需要分页查询 tb_employee 表中,年龄在 18~50 之间性别为男且姓名为 xx 的所有用户,这时候我们该如何实现上述需求呢?
使用MyBatis : 需要在 SQL 映射文件中编写带条件查询的 SQL,并用PageHelper 插件完成分页. 实现以上一个简单的需求,往往需要我们做很多重复单调的工作。
使用MP: 依旧不用编写 SQL 语句,MP 提供了功能强大的条件构造器 ------ EntityWrapper。

接下来就直接看几个案例体会EntityWrapper的使用。

1、分页查询年龄在18 - 50且gender为0、姓名为tom的用户:

  1. List<Employee> employees = emplopyeeDao.selectPage(new Page<Employee>(1,3),
  2. new EntityWrapper<Employee>()
  3. .between("age",18,50)
  4. .eq("gender",0)
  5. .eq("last_name","tom")
  6. );

注:由此案例可知,分页查询和之前一样,new 一个page对象传入分页信息即可。至于分页条件,new 一个EntityWrapper对象,调用该对象的相关方法即可。between方法三个参数,分别是column、value1、value2,该方法表示column的值要在value1和value2之间;eq是equals的简写,该方法两个参数,column和value,表示column的值和value要相等。注意column是数据表对应的字段,而非实体类属性字段。

2、查询gender为0且名字中带有老师、或者邮箱中带有a的用户:

  1. List<Employee> employees = emplopyeeDao.selectList(
  2. new EntityWrapper<Employee>()
  3. .eq("gender",0)
  4. .like("last_name","老师")
  5. //.or()//or new 区别不大
  6. .orNew()
  7. .like("email","a")
  8. );

注:未说分页查询,所以用selectList即可,用EntityWrapper的like方法进行模糊查询,like方法就是指column的值包含value值,此处like方法就是查询last_name中包含“老师”字样的记录;“或者”用or或者orNew方法表示,这两个方法区别不大,用哪个都可以,可以通过控制台的sql语句自行感受其区别。

3、查询gender为0,根据age排序,简单分页:

  1. List<Employee> employees = emplopyeeDao.selectList(
  2. new EntityWrapper<Employee>()
  3. .eq("gender",0)
  4. .orderBy("age")//直接orderby 是升序,asc
  5. .last("desc limit 1,3")//在sql语句后面追加last里面的内容(改为降序,同时分页)
  6. );

注:简单分页是指不用page对象进行分页。orderBy方法就是根据传入的column进行升序排序,若要降序,可以使用orderByDesc方法,也可以如案例中所示用last方法;last方法就是将last方法里面的value值追加到sql语句的后面,在该案例中,最后的sql语句就变为select ······ order by desc limit 1, 3,追加了desc limit 1,3所以可以进行降序排序和分页。

4、分页查询年龄在18 - 50且gender为0、姓名为tom的用户:
条件构造器除了EntityWrapper,还有Condition。用Condition来处理一下这个需求:

  1. List<Employee> employees = emplopyeeDao.selectPage(
  2. new Page<Employee>(1,2),
  3. Condition.create()
  4. .between("age",18,50)
  5. .eq("gender","0")
  6. );

注:Condition和EntityWrapper的区别就是,创建条件构造器时,EntityWrapper是new出来的,而Condition是调create方法创建出来。

5、根据条件更新:

  1. @Test
  2. public void testEntityWrapperUpdate(){
  3. Employee employee = new Employee();
  4. employee.setLastName("苍老师");
  5. employee.setEmail("cjk@sina.com");
  6. employee.setGender(0);
  7. emplopyeeDao.update(employee,
  8. new EntityWrapper<Employee>()
  9. .eq("last_name","tom")
  10. .eq("age",25)
  11. );
  12. }

注:该案例表示把last_name为tom,age为25的所有用户的信息更新为employee中设置的信息。

6、根据条件删除:

  1. emplopyeeDao.delete(
  2. new EntityWrapper<Employee>()
  3. .eq("last_name","tom")
  4. .eq("age",16)
  5. );

注:该案例表示把last_name为tom、age为16的所有用户删除。

#@lehao#

帮助到您请点赞关注收藏谢谢!!

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/Gausst松鼠会/article/detail/665627
推荐阅读