Spring boot学习（三） Spring boot整合mybatis-白红宇

前言

前面我们介绍了如何创建一个Spring boot项目以及Spring boot项目的一些基本配置，在了解了这些知识的前提下本篇博客继续介绍在Spring boot中配置一个基于java的持久层框架---Mybatis。

文章首发于个人博客:【】

为什么使用Mybatis

在实际的开发过程中是离不开数据库的，这里指的是关系型数据库，例如MySql，Oracle,SqlServer等。大家应该都清楚如果不使用任何框架的情况下，我们项目要想连接数据库大致分为以下步骤：

加载驱动（使用不同的数据库加载不同的驱动）

获取连接

编写sql

创建statement

执行sql语句并处理结果

从下而上依次关闭连接

实际的开发过程中，我们对数据库的操作是很频繁的，如果都按照上边的方式去连接数据库的话，将会给我们带来很糟糕的体验，所以Mybatis应运而生，Mybatis内部封装了jdbc，使我们开发者只需要考虑sql语句的编写，其余的都帮我们搞定，极大的减轻了开发人员的工作量，而且还提供了动态sql等强大功能，能应对实际项目中的各种需求，这也是它受到大家青睐的原因。

在Spring boot中配置Mybatis

添加依赖

在整合Mybatis之前先,然后在pom.xml文件中添加mybatis-spring-boot-starter依赖，因为需要关联到数据库，所以还必须添加一个数据库的依赖，这里我使用的是Mysql数据库，所以需要在pom.xml文件中添加以下两个依赖：


    
        
     
      mysql
         
     
      mysql-connector-java
     
    
    
        
     
      org.mybatis.spring.boot
         
     
      mybatis-spring-boot-starter
         
     
      1.3.2
     
    复制代码

不同的Spring boot版本对应的Mybatis也不一样，详细情况可查阅官方文档【】。

看到网上很多教程都添加了jdbc的依赖，其实这里是不需要的，因为mybatis-spring-boot-starter已经包含了spring-boot-starter-jdbc依赖，查看项目中隐形依赖的方法为（使用eclipse）：右键项目-->Run As-->Maven build...在弹出框的Goals栏中输入dependency:tree,点击Run，在控制台就会打印出项目的所有依赖及关系，如图：

图示内容可以证明我上面的言论。

配置数据源

在application.properties配置文件中添加如下内容:

#mybatis配置#配置实体类的位置mybatis.type-aliases-package=com.web.springbootmybatis.entity#xml文件位置mybatis.mapper-locations=classpath:mapper/*.xml#mysql数据库连接信息配置#mysql驱动spring.datasource.driverClassName=com.mysql.jdbc.Driver#数据库连接信息spring.datasource.url=jdbc:mysql://localhost:3306/eran?useUnicode=true&characterEncoding=utf-8&serverTimezone=GMT%2B8#数据库用户名spring.datasource.username=root#数据库密码spring.datasource.password=root复制代码

配置的属性值根据自己的实际情况填写，这里是我的配置，特别要注意实体类的位置以及xml文件的位置。

构建MVC项目结构

创建出对应的包即可，这里我们就创建了几个需要的包就可以了，项目结构如下图：

数据库sql

CREATE TABLE `sys_user` (  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '主键',  `usercode` varchar(32) NOT NULL COMMENT '账号',  `username` varchar(64) NOT NULL COMMENT '姓名',  `password` varchar(32) NOT NULL COMMENT '密码',  `salt` varchar(64) DEFAULT NULL COMMENT '盐',  `locked` char(1) DEFAULT NULL COMMENT '账号是否锁定，1：锁定，0未锁定',  PRIMARY KEY (`id`)) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8;INSERT INTO `sys_user` VALUES ('1', 'Promise', 'eran', '123456', null, '0');复制代码

SysUser.java

实体类

package com.web.springbootmybatis.entity;import java.io.Serializable;import com.fasterxml.jackson.annotation.JsonProperty; public class SysUser implements Serializable{	private static final long serialVersionUID = 1L;	//主键 : id 		private Long id; 		//账号 : usercode 		private String usercode; 		//姓名 : username 		private String username; 		//密码 : password 		private String password; 		//盐 : salt 		private String salt; 		//账号是否锁定，1：锁定，0未锁定 : locked 		private String locked; 		//省略getter,setter方法}复制代码

SysUserMapper.java

dao层接口

package com.web.springbootmybatis.dao;/** * SysUserMapper */import java.util.List;import java.util.Map;import  com.web.springbootmybatis.entity.SysUser; public interface SysUserMapper{	public SysUser findById(Long id);}复制代码

SysUserMapper.xml

由于我使用的是xml版，所以需要添加xml文件，这里只是简单写一下，实际开发中，这些文件我们都是利用插件自动生成的，以后的博客会介绍。

ISysUserService.java

service接口

package com.web.springbootmybatis.service;/*** @author Promise* @createTime 2018年12月27日 下午11:11:00* @description */import com.web.springbootmybatis.entity.SysUser;public interface ISysUserService {	SysUser findById(Long id);}复制代码

SysUserServiceImpl.java

service接口实现

package com.web.springbootmybatis.service.impl;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.stereotype.Service;import com.web.springbootmybatis.dao.SysUserMapper;import com.web.springbootmybatis.entity.SysUser;import com.web.springbootmybatis.service.ISysUserService;/*** @author Promise* @createTime 2018年12月27日 下午11:11:48* @description */@Service("sysUserService")public class SysUserServiceImpl implements ISysUserService{	@Autowired	private SysUserMapper sysUserMapper;		@Override	public SysUser findById(Long id) {		// TODO Auto-generated method stub		return sysUserMapper.findById(id);	}}复制代码

TestController.java

控制器

package com.web.springbootmybatis.controller;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RestController;import com.web.springbootmybatis.entity.SysUser;import com.web.springbootmybatis.service.ISysUserService;/*** @author Promise* @createTime 2018年12月27日 下午11:13:22* @description */@RestControllerpublic class TestController {	@Autowired	private ISysUserService sysUserService;		@RequestMapping("/user")	public SysUser getUser() {		return sysUserService.findById(1L);	}}复制代码

添加注解扫描dao层

在启动类中添加注解@MapperScan()注解配置扫描dao层位置,里边的值根据实际情况填写。

package com.web.springbootmybatis;import org.mybatis.spring.annotation.MapperScan;import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication@MapperScan("com.web.springbootmybatis.dao")public class SpringbootMybatisApplication {	public static void main(String[] args) {		SpringApplication.run(SpringbootMybatisApplication.class, args);	}}复制代码

此时项目的结构为：

启动项目

启动项目，访问localhost:8080/user或者127.0.0.1:8080/user，得到如下信息：

拿到了数据库中存放的用户信息，至此Spring boot简单整合Mybatis就成功了，这里我们使用的是默认的tomcat-jdbc数据源，在实际开发过程中我们一般使用alibaba提供的功能更强大的druid数据源，后边的博客会详细介绍，这里就不概述了。

打印sql

细心的小伙伴会发现按照上边的配置，我们访问了数据库，但是控制台并没有打印出我们具体的sql语句，这在实际开过程中是非常不友好的，看不到sql语句非常不利于我们快速的定位bug,所以下面介绍以下在Spring boot中开启sql日志的功能，很简单，只需要在配置文件中添加一句配置即可：

logging.level.com.web.springbootmybatis.dao=debug复制代码

logging.level后面的路径指的是mybatis对应的方法接口所在的包(也就是dao层所在的包)，并不是mapper.xml所在的包。

重启项目，再次访问，观察控制台是不是已经打印出了sql语句了呢：

结语

关于Spring boot整合Mybatis的介绍就到这里了，下面的博客中会继续介绍Mybatis的自动化插件以及分页插件，使用druid数据源等,bye~