SpringBoot中整合Mybatis

一、Mybatis快速入门

1.1、在相应的模块中添加依赖的坐标

首先创建一个maven项目

在对应的pom.xml文件中引入下面的依赖 

<dependencies><!--mybatis 依赖--><dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.5.6</version></dependency><!--mysql 驱动--><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>5.1.46</version></dependency>
</dependencies>

1.2、编写核心配置文件

在resources包中编写mybatis-config.xml配置文件，配置数据库的连接信息，在mybatis官网复制即可。

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration><environments default="development"><environment id="development"><transactionManager type="JDBC"/><!--配置连接数据库的连接参数--><dataSource type="POOLED"><property name="driver" value="com.mysql.jdbc.Driver"/><property name="url" value="jdbc:mysql://localhost:3306/mybatis"/><property name="username" value="root"/><property name="password" value="root"/></dataSource></environment></environments><!--2 加载Mapper接口和SQL语句，将给的例子注释掉。后面第三大步中配置--><!--<mappers><mapper resource="org/mybatis/example/BlogMapper.xml"/></mappers>-->
</configuration>

核心配置文件的作用:

1、配置连接数据库环境信息。

​ 2、通过扫包加载和mapper接口和SQL

1.3、总结

mybatis的使用步骤:

1、引入对应的依赖

2、设置核心配置文件mybatis-config.xml

二、SpringBoot项目中整合Mybatis

创建一个springboot的web项目:

2.1、 在相应的模块中添加依赖的坐标

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><parent><artifactId>cloud-demo</artifactId><groupId>cn.itcast.demo</groupId><version>1.0</version></parent><modelVersion>4.0.0</modelVersion><artifactId>user-service</artifactId><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId></dependency><!--mybatis--><dependency><groupId>org.mybatis.spring.boot</groupId><artifactId>mybatis-spring-boot-starter</artifactId></dependency>   </dependencies><build><finalName>app</finalName><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build>
</project>

其中:

1、mybatis-spring-boot-starter

2、mysql-connector-java

这两个依赖是使用mybatis所必须的

2.2、application.yml配置文件中设置数据库等信息

server:port: 8081
spring:datasource:url: jdbc:mysql://127.0.0.1:3306/cloud_user?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=Asia/Shanghaiusername: rootpassword: rootdriver-class-name: com.mysql.jdbc.Drivermybatis:type-aliases-package: cn.itcast.user.pojomapper-locations: classpath:/mapper/**/*.xmlconfiguration:map-underscore-to-camel-case: true

其中application.yml配置文件中设置的数据库连接信息,以及mapper.xml的位置设置都是之前在mybatis-config.xml配置文件中设置的。

所以使用springboot整合mybatis后可以删除mybatis-config.xml配置文件

2.3总结

SpringBoot中整合mybatis的使用步骤:

1、引入对应的依赖

2、设置核心配置文件application.yml

三、Mapper.xml文件的放置规则

        mapper中的每一个方法,都应该对应有一条sql语句。可以使用注解的形式,也可以写在对应的mapper.xml中。

下面采用的是注解的形式

如果采用的是mapper.xml的形式,那么要特别注意mapper.xml文件的放置位置

3.1、和mapper放在同级目录

可以看见UserMapper和UserMapper.xml都在cn/itcast/user/mapper/包下

 这种情况下,不需要在application.yml中设置任何的参数

3.2、在application.yml配置文件中指定Mapper.xml的位置

mybatis:type-aliases-package: cn.itcast.user.pojomapper-locations: classpath:/mapper/**/*.xml

 例如我现在就指定mapper.xml文件在resources包下的mapper包以及mapper包的子包中。

3.3、出现的报错

如果没有按照3.1、3.2中进行操作，就会出现下面的报错

四、通过 MybatisProperties.class定位mapper.xml的位置

我们通过单击application.yml中的mapper-locations可以定位到加载mapper.xml的位置

debug启动项目后,在下面的位置打上断点。可以看见在MybatisProperties.class类中的setMapperLocations方法里面可以获取到mapper.xml的位置 

 五、@param注解的注意点

我们在mapper中如果存在多个参数的时候,会使用到@param注解,使用这个注解要导入对应的mybatis的包,不然会报下面的错误。

导入这个注解

导错包出现的报错