SpringBoot系列之集成Mybatis教程
环境准备:IDEA + maven
本博客通过例子的方式,介绍Springboot集成Mybatis的两种方法,一种是通过注解实现,一种是通过xml的方式
进行实验,要先创建一个Initializer工程,如图:
![在这里插入图片描述](https://img-blog.csdnimg.cn/20191215124237188.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9zbWlsZW5pY2t5LmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
打包方式选择jar即可,因为Springboot使用了嵌入式的Servlet容器,直接运行jar即可,即使是web工程也支持
![在这里插入图片描述](https://img-blog.csdnimg.cn/201912151241362.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9zbWlsZW5pY2t5LmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
选择必要的jar,Mybatis、数据库驱动是必要的
![在这里插入图片描述](https://img-blog.csdnimg.cn/20191215124213629.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9zbWlsZW5pY2t5LmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
新建项目后,会自动加上如下配置,,如果你的mysql服务器是5.7版本的,建议指定mysql-connector-java版本,Druid也需要自己加上,pom配置参考:
```xml
<properties>
<java.version>1.8</java.version>
<druid.version>1.1.2</druid.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.1.1</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.27</version>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>${druid.version}</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
<exclusions>
<exclusion>
<groupId>org.junit.vintage</groupId>
<artifactId>junit-vintage-engine</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>
```
mybatis-spring-boot-starter是Springboot的场景启动器,默认集成了如下jar
![在这里插入图片描述](https://img-blog.csdnimg.cn/20191215131143394.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9zbWlsZW5pY2t5LmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
新建数据库和数据表:
```sql
CREATE DATABASE /*!32312 IF NOT EXISTS*/`springboot` /*!40100 DEFAULT CHARACTER SET utf8 */;
USE `springboot`;
/*Table structure for table `sys_user` */
DROP TABLE IF EXISTS `sys_user`;
CREATE TABLE `sys_user` (
`userId` int(10) NOT NULL,
`username` varchar(20) NOT NULL,
`sex` char(10) DEFAULT NULL,
`password` varchar(10) DEFAULT NULL,
PRIMARY KEY (`userId`),
UNIQUE KEY `idx_username` (`username`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
/*Data for the table `sys_user` */
insert into `sys_user`(`userId`,`username`,`sex`,`password`) values (1,'admin','man','11');
```
新建一个bean类,代码:
```java
import java.io.Serializable;
public class User implements Serializable{
private String userId;
private String username;
private String sex;
private String password;
public String getUserId() {
return userId;
}
public void setUserId(String userId) {
this.userId = userId;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getSex() {
return sex;
}
public void setSex(String sex) {
this.sex = sex;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
}
```
当然还要配置数据库JDBC和连接池,具体参考我的博客:[SpringBoot系列之集成Druid配置数据源监控](https://smilenicky.blog.csdn.net/article/details/103547228)
* 注解方式
对于mybatis注解方式,使用很容易,新建一个Mapper接口即可:
```java
import com.example.springboot.mybatis.bean.User;
import org.apache.ibatis.annotations.*;
public interface UserMapper {
@Select("select * from sys_user where userId=#{userId}")
public User getUserById(Integer userId);
@Delete("delete from sys_user where userId=#{userId}")
public int deleteUserById(Integer userId);
@Options(useGeneratedKeys = true,keyProperty = "userId")
@Insert("insert into sys_user(username,sex,password) values(#{username},#{sex},#{password})")
public int insertUser(User user);
@Update("update sys_user set username=#{username} where userId=#{userId}")
public int updateUser(User user);
}
```
@Mapper注解,可以不用加在每一个Mapper上,所以,我们再新建一个Mybatis的配置类,对于是否支持事务,是否支持驼峰命名和大小写自动转换都可以加上
```java
import org.mybatis.spring.annotation.MapperScan;
import org.mybatis.spring.boot.autoconfigure.ConfigurationCustomizer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.transaction.annotation.EnableTransactionManagement;
/**
* <pre>
* Mybatis配置类
* </pre>
*
* @author nicky
* <pre>
* 修改记录
* 修改后版本: 修改人: 修改日期: 2019年12月15日 修改内容:
* </pre>
*/
@Configuration
//开启支持事务管理
@EnableTransactionManagement
// Mapper接口扫描,加上这个就不需要每一个Mapper接口都加@Mapper注解
@MapperScan(basePackages = {"com.example.springboot.mybatis.mapper"})
public class MybatisConfig {
//配置支持驼峰命名和大小写自动转换
@Bean
public ConfigurationCustomizer configurationCustomizer(){
return new ConfigurationCustomizer(){
@Override
public void customize(org.apache.ibatis.session.Configuration configuration) {
configuration.setMapUnderscoreToCamelCase(true);
}
};
}
}
```
为了方便,就不写Service类了,直接写个Controller类进行测试,接口符合RestFul规范
```java
import com.example.springboot.mybatis.bean.User;
import com.example.springboot.mybatis.mapper.UserMapper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
/**
* <pre>
* 接口测试类
* </pre>
*
* @author nicky
* <pre>
* 修改记录
* 修改后版本: 修改人: 修改日期: 2019年12月15日 修改内容:
* </pre>
*/
@RestController
public class UserController {
@Autowired
UserMapper userMapper;
@GetMapping("/user/{userId}")
public User getUser(@PathVariable("userId") Integer userId){
return userMapper.getUserById(userId);
}
@PostMapping("/user")
public User insertDept(User user){
userMapper.insertUser(user);
return user;
}
}
```
有Post请求,所以只能使用Postman测试,浏览器不能测试Post接口
![在这里插入图片描述](https://img-blog.csdnimg.cn/20191215183532754.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9zbWlsZW5pY2t5LmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
* xml配置方式
在application.yml加上如下配置,注意mybatis配置不属于spring的,所以不要使用缩进,yaml不熟悉的,可以参考我的博客:[SpringBoot系列之YAML配置用法学习笔记](https://smilenicky.blog.csdn.net/article/details/102877780)
```yaml
mybatis:
# 指定全局配置文件位置
config-location: classpath:mybatis/mybatis-config.xml
# 指定sql映射文件位置
mapper-locations: classpath:mybatis/mapper/*.xml
```
mybatis-config.xml:
```xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<settings>
<setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>
</configuration>
```
mybatis/mapper/UserMapper.xml:
```xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.springboot.mybatis.mapper.SysUserMapper">
<select id="getApiUserById" resultType="com.example.springboot.mybatis.bean.User">
SELECT * FROM sys_user WHERE userId=#{id}
</select>
<insert id="insertApiUser">
INSERT INTO sys_user(username,sex,password) VALUES(#{username},#{sex},#{password})
</insert>
</mapper>
```
SysUserMapper.java接口代码:
```java
package com.example.springboot.mybatis.mapper;
import com.example.springboot.mybatis.bean.User;
import org.apache.ibatis.annotations.Param;
//@Mapper
public interface SysUserMapper {
User getApiUserById(@Param("id") Integer id);
void insertApiUser(User user);
}
```
简单测试一下接口:
```java
import com.example.springboot.mybatis.bean.User;
import com.example.springboot.mybatis.mapper.SysUserMapper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;
/**
* <pre>
* 测试接口,就不写Service类
* </pre>
*
* @author nicky
* <pre>
* 修改记录
* 修改后版本: 修改人: 修改日期: 2019年12月15日 修改内容:
* </pre>
*/
@RestController
public class UserController {
@Autowired
SysUserMapper userDao;
/**
* xml方式获取用户信息
* @param id
* @return
*/
@GetMapping("/api/user/{id}")
public User getUserById(@PathVariable("id") Integer id){
return userDao.getApiUserById(id);
}
}
```
Postman工具测试:
![在这里插入图片描述](https://img-blog.csdnimg.cn/20191215184133729.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9zbWlsZW5pY2t5LmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
代码例子下载:[github下载链接](https://github.com/u014427391/springbootexamples/tree/master/springboot-mybatis)
- 第一章 SpringBoot简介和基础入门
- 1.1、SpringBoot简单介绍与入门例子
- 1.2、学会创建Spring Initializer项目
- 第二章 Springboot配置文件的使用
- 2.1、SpringBoot配置文件加载位置探究
- 2.2、SpringBoot配置文件占位符的使用
- 2.3、SpringBoot外部配置优先级探究
- 2.4、SpringBoot系列之@PropertySource用法简介
- 2.5、SpringBoot系列之@Value和@ConfigurationProperties
- 2.6、SpringBoot系列之YAML配置用法学习笔记
- 2.6、SpringBoot系列之@PropertySource读取yaml文件
- 2.7、SpringBoot系列之profiles配置多环境用法介绍
- 第三章 SpringBoot数据库访问操作
- 3.1、使用SpringBoot进行JDBC数据访问
- 3.2、SpringBoot集成Mybatis入门指南
- 3.3、SpringBoot系列之Spring Data Jpa集成教程
- 3.4、SpringBoot系列之集成Druid配置数据源监控
- 第四章 SpringBoot Web项目实践
- 4.1、SpringBoot系列之集成jsp模板引擎
- 4.2、SpringBoot系列之集成Thymeleaf用法手册
- 4.3、SpringBoot系列之i18n国际化多语言支持教程
- 4.4、SpringBoot系列之HATEOAS用法简介
- 4.5、SpringBoot系列之集成Swagger2
- 第五章 SpringBoot日志框架集成实践
- 5.1、SpringBoot系列之日志框架介绍及其原理简介
- 5.2、SpringBoot系列之日志框架使用教程
- 5.3、SpringBoot系列之集成logback实现日志打印
- 5.4、SpringBoot系列之切换log4j日志框架
- 第六章 Springboot集成缓存框架实践
- 6.1、SpringBoot系列之项目中缓存使用入门教程
- 6.2、SpringBoot系列之集成Redis实现缓存处理
- 第七章 SpringBoot集成消息队列实践
- 7.1、RabbitMQ极速入门与实战教程
- 第八章 单点登录框架CAS集成实践
- 81.、CAS单点登录系列之原理简单介绍
- 8.2、CAS 5.3.1之使用cas overlay搭建服务端
- 第九章 SpringBoot集成OAuth2.0实践
- OAuth2.0系列之基本概念和运作流程(一)