当Spring Boot遇见Mybatis（连接Mysql）

作者: luckyHarry4 | 来源:发表于2018-07-23 21:16 被阅读38次

前言

在本文中讲述了Spring Boot 如何整合Mybatis ，然后如何通过Mybaits连接到Mysql，项目是由gradle构建的，本文还讲述了controller层相关的知识。
Spring Boot 在Spring 家族现在混的风生水起，如果不是开发之前的老项目，那么几乎大多数人都在使用Spring Boot。使用的原因虽然有很多，但是归根结底的根本原因只有一个，那就是因为它太易用了，如果你想要创建一个最小的Spring Boot 项目可以看我的前面一篇文章与Spring Boot 初次见面，那么废话不多说，我们开始吧。
在这里首先附上这个项目的百度云地址链接密码：5050

准备工作

1.首先我们得需要先准备一个Spring Boot 工程

我们需要在本地安装上你需要连接的数据库，我这里使用的是Mysql数据库，这里给大家贴出mysql官网下载地址mysql 下载地址
对于新手来说，有可能通过命令行去使用数据库，太强人所难，我自己是使用 navicat这个工具进行连接的，下面给出navicat地址大家可以自行下载navicat 下载地址

正文

首先我们需要引入我们需要的mybatis相关的依赖。

这里多说一点,给大家推荐 maven repository 这个网站,无论你是使用maven或者是gradle进行构建的，你都可以在上面找到你要依赖的具体地址。

在build.gradle 中我们添加上需要的依赖：

//数据库连接驱动
compile('mysql:mysql-connector-java:6.0.5') 
//配置mybatis 数据源
compile("org.mybatis.spring.boot:mybatis-spring-boot-starter:1.3.1")

然后需要在application.properties中添加上需要配置的一些信息：

#设置数据库连接相关的参数
spring.datasource.url=jdbc:mysql://localhost/test?useSSL=false&serverTimezone=UTC&characterEncoding=utf-8
spring.datasource.username=root
spring.datasource.password=
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

#配置mybatis 相关的参数
mybatis.type-aliases-package: com.harry.first.entity

url中如果我们想使用自己的数据库，可以替换掉test就行，其他的参数分别代表的是时区以及编码格式（这个地方还是需要多加小心的，我之前就因为时区的问题，往数据库里用now()函数，结果发生了一直快一个小时的缘故，所以这里一定要注意。）
username是你数据库在安装时候设定的用户名，默认情况下会有一个root用户。
password是安装时候设定的密码，我当时是直接用yum进行下载的mysql，然后安装的时候，忘记设置了名字，后来又比较懒。所以你懂的。
接下来是设置好驱动的名字。
我在上一篇博客的时候，将java后端，进行了分层，分别是Controller，Service，Dao，以及entity。我们需要写的与数据库相关联的代码，就是放在了Dao层中。
使用Mybatis进行数据库的操作，我知道的一共有三种方式：

通过java代码直接去调用SqlSession。在我看来，这种方式更像是我们曾经使用的JDBC，只不过mybatis已经给JDBC封装的很好了，我们已经不需要在进行connection，prepareStatement，resultSet等一系列繁琐的操作了。大致的过程是这样的：我们首先需要准备好一个mybatis-config.xml的文件名，里面写好了对mybatis的配置，紧接着通过流把文件的信息读进来，然后我们通过这些配置实例化出一个SqlSessionFactory（核心对象），再通过SqlSessionFactory.openSession()方法制造出SqlSession对象，再通过SqlSession对象对对应的数据库进行增删改查操作。我们对这种方式暂时不演示。详细的内容可以看下面的链接。Mybatis 核心对象
我们也可以通过在resource包下创建一个mapper包，然后在mapper包下创建一个xml。这个xml与java包下=>dao包下的java文件是对应上的。xml中mapper标签里的namespace可以与dao接口中的接口名对应。xml中<select>,<update>,<insert>,<delete>标签中的id对应的是类中的方法名。（这种方法会在后面详细说，在这里有个概念就行。）
封装的最好的应该就是这第三种方式了，我们只需要在dao包中的接口方法上面加上这个方法进行具体操作的注解即可。动动脑子就会知道，注解一共有@select，@update，@delete，@insert。虽然真是方便到了极致，但是封装的层次越高，对于开发人员，可以下手的范围也就越小，例如像动态sql，if，for这种在xml中可以进行的操作，就无法在这上面实现了。
下面我们就进行实战演示。

真实项目演示

为了测试，我们首先创建一个user表然后创建表的sql如下：

SET NAMES utf8mb4;
SET FOREIGN_KEY_CHECKS = 0;

-- ----------------------------
-- Table structure for user
-- ----------------------------
DROP TABLE IF EXISTS `user`;
CREATE TABLE `user` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `name` varchar(255) DEFAULT NULL,
  `age` int(3) DEFAULT NULL,
  `password` varchar(255) DEFAULT NULL,
  `email` varchar(255) DEFAULT NULL,
  `phone` varchar(255) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=5 DEFAULT CHARSET=latin1;

注解形式

然后我首先演示的是上文说的第三种方式，在dao包下创建UserDao接口，然后代码如下：

package com.harry.first.dao;

import org.apache.ibatis.annotations.Delete;
import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Options;
import org.apache.ibatis.annotations.Select;
import org.apache.ibatis.annotations.Update;

import com.harry.first.entity.User;

public interface UserDao {
    
    //返回的Integer值是受影响的行数
    @Insert("insert into user(name, age, password, email, phone) values(#{name}, #{age}, #{password}, #{email}, #{phone})")
    //这是为了说明主键自增
    @Options(useGeneratedKeys = true, keyProperty = "id")
    Integer addUser(User user);
    
    @Update("update user set name=#{name},age=#{age},password=#{password},email=#{email},phone=#{phone}")
    Integer updateUser(User user);
    
    @Delete("delete from user where id = #{id}")
    Integer deleteUser(Integer id);
    
    @Select("select * from user ")
    User getUser();

}

我在这里没有使用junit单元测试，而是直接使用了controller层定义api接口的方式，然后通过浏览器，进行访问，看是否插入成功。
创建一个UserController,下面的是controller层的代码：

package com.harry.first.controller;

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.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import com.harry.first.dao.UserDao;
import com.harry.first.entity.User;

@RestController
@RequestMapping("/user")
public class UserController {
    
    @Autowired
    private UserDao userDao;
    
    @GetMapping(value="/addUser")
    public Integer addUser() {
        User user =new User("harry",22,"harry","912043310@qq.com","15566416991");
        return userDao.addUser(user);
    }
    
    @GetMapping("/updateUser")
    public Integer updateUser() {
        User user =new User("luckyharry",22,"luckyharry","912043310@qq.com","15566416991");
        return userDao.updateUser(user);
    }
    
    @GetMapping("/deleteUser/{id}")
    public Integer deleteUser(@PathVariable String id) {
        return userDao.deleteUser(Integer.valueOf(id));
    }

    @GetMapping("/getUser")
    public User getUser() {
        return userDao.getUser();
    }
}

依次来说以下

@RestController注解是spring boot 的一个新注解，他是一个结合的注解：@Controller+@ResponseBody。controller代表了这是一个controller层的类，目的是给它注入到spring 容器中，对应的service层需要使用的是@Service注解，dao层中如果使用了刚刚说的第二种方式需要@Mapper注解，但是用了第三种方式就不需要了。无论是@Controller，还是@Service都是对于@Component的一种拓展。
@RequestMapping可以通过value去设置对应的哪个url会对应这个类，通过method去设置访问的方法（get，post，put，delete，head）如果把这个注解定义在方法上，那么就决定了哪个url会进入这个方法。在这里需要说一下，一般情况下是通过类上的requestMapping+方法上的requestMapping唯一指定进入哪个方法逻辑。
@Autowired，这个注解可以说是spring家族中的灵魂注解，我们通过@Component将需要的类，注入到了spring这个大的容器中，那么我们怎么才能将它取出来呢？就是通过这个注解，我们只需要定义一个类的变量，不需要用new来进行实例化，然后在上头添加上这个这个注解即可，是不是特别方便。你在不经意间掌握了依赖注入的一个简单的实现过程，是不是感觉特别惊喜，特别意外，其实这个依赖注入，和控制反转是一个极其复杂的过程，正是因为spring对其极致的封装，才能让我们现在用的极其爽快。
@GetMapping这个注解也是一个二次封装的注解，他是在@RequestMapping的基础上创造的，顾名思义它的前缀就是他使用的哪个method。分别有@GetMapping，@PostMapping，@PutMapping，@DeleteMapping，（上面我是因为想直接通过页面进行测试，所以一律使用了get方法，其实这样是科学的，一定不要效仿）好处就是省去了多余对于method的代码，另外也秉承了Rest Api的思想，下面有个地址可以学习以下Rest apiRest api 学习
@PathVariable 说起Rest Api 另外一个特点就是放弃了，之前的/***?key=value 这样传输数据的形式，现在取而代之的是把需要传递的参数直接放在url地址中形如上面的删除方法一样。
这里有比较需要注意的一个地方，那就是我们在那个启动类中，需要加上一个注解。

@MapperScan("com.harry.first.dao")

否则它是不会将dao中我们的接口注入进来的，新手在这里很容易入坑！！！

xml形式

注释的形式固然简单，但是往往越简单的东西，也就意味着更高级的封装，所以有的时候也会在我们想要定制化的时候，制造出很多条条框框，让我们不能够大展身手。所以这就是为什么注解方式的出现，没有导致把xml形式拍在沙滩上的原因。
为了大家看的方便，我把对user表进行的操作，使用注解方式。然后重新创建了一个hobby表，对于hobby表的操作，我使用xml的形式。
首先我们先要创建一个hobby表。

-- ----------------------------
-- Table structure for `hobby`
-- ----------------------------
DROP TABLE IF EXISTS `hobby`;
CREATE TABLE `hobby` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `name` varchar(255) DEFAULT NULL,
  `user_id` int(11) DEFAULT NULL,
  `create_date` datetime DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8;

然后我们在src/main/resources下面创建一个mapper包，为了放我们的xml文件。

为什么要放在resources这个路径下面呢？其实刚开始我也随心所欲的想放哪就放哪。直到有一次做项目的时候，我把这些xml文件依旧放在了src/main/java下面。但是临时通知需要使用idea，然后我就自信满满的把原来用eclipse的项目迁移到了idea中去，刚开始启动都没有问题，但是一要访问数据库的时候就开始说“invalid statement.....”。后来不断排查才发现idea默认情况下，只会去读resources下面的xml。这次之后终于长记性了。

为了让spring boot 知道我们使用了xml文件，我们在 application.properties中需要配置上

mybatis.mapper-locations: classpath:mapper/*.xml

我们依旧要在dao中定义一个接口。

package com.harry.first.dao;

import java.util.List;

import org.apache.ibatis.annotations.Mapper;

import com.harry.first.entity.Hobby;
@Mapper
public interface HobbyMapper {
    
    public int insertHobby(Hobby hobby);
    
    public int updateHobby(Hobby hobby);
    
    public int deleteHobby(int id);
    
    public List<Hobby> getHobby();
    
}

在这里使用@Mapper注解。
然后我们在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.harry.first.dao.HobbyMapper">
    <resultMap id="BaseMap" type="com.harry.first.entity.Hobby">
      <id column="id" property="id" jdbcType="INTEGER" javaType="java.lang.Integer"/>
      <result column="name" property="name" jdbcType="VARCHAR" javaType="java.lang.String"/>
      <result column="user_id" property="userId" jdbcType="INTEGER" javaType="java.lang.Integer"/>
      <result column="create_date" property="createDate" jdbcType="DATE" javaType="java.sql.Date"/>
    </resultMap>
        <insert id="insertHobby"  parameterType="Hobby" useGeneratedKeys="true" keyProperty="id">
            insert into hobby (name,user_id,create_date) values (#{name},#{userId},now());
        </insert>
        
        <update id="updateHobby" parameterType="Hobby">
            update hobby set name=#{name},user_id=#{userId},create_date=now(); 
            where id={id}
        </update>
        
        <delete id="deleteHobby" parameterType="Integer">
            delete from hobby where id=#{id}
        </delete>
        
        <select id="getHobby" resultMap="BaseMap">
            select * from hobby;
        </select>
    </mapper>

在这里我们可以看到我们有一个父标签为mapper，mapper的有一个属性叫做namespace 这里namespace的名字应该与刚刚定义的那个接口名称相互对应上，而且这里要带上，自己的包名。（这里友情提示一下，做这个演示项目的时候，我不小心把自己的接口名称写错了，结果导致了那个接口一直找不到对应的xml，浪费了我整整两个小时，现在感觉当时自己真的特别的蠢）
resultMap 子标签是一个实体类到表字段的一个映射关系，id属性是为了在注入的时候用的，我们暂且理解为给这个resultMap起了个名字，那它是和哪一个实体类对应上的那，这就是type属性的职责了。这个标签中的子标签就是交代一下字段名称和类型。
再下面的四个标签我们可以见名知意了，分别是增改删查。
其他的很多mybatis的用法我会在接下来的博客中进行详细说明，这篇文章主要就是将spring boot 与 Mybatis进行结合的。

最后再追加一下我们使用Mybatis 如果看不到相应的日志的话，调试起来相当麻烦。所以我们需要做一步操作：
在application.properties中加入

logging.level.com.harry.first.dao=debug

logging.level 后面追加上自己dao包的路径即可。
效果就如下面所示：

2018-07-24 22:20:42.001 DEBUG 22420 --- [nio-8080-exec-1] c.h.first.dao.HobbyMapper.insertHobby    : ==>  Preparing: insert into hobby (name,user_id,create_date) values (?,?,now()); 
2018-07-24 22:20:42.012 DEBUG 22420 --- [nio-8080-exec-1] c.h.first.dao.HobbyMapper.insertHobby    : ==> Parameters: java(String), 1(Integer)
2018-07-24 22:20:42.029 DEBUG 22420 --- [nio-8080-exec-1] c.h.first.dao.HobbyMapper.insertHobby    : <==    Updates: 1

谢谢大家，你们的阅读与喜欢就是我前行最大的动力，在这里表示由衷的感谢。我也希望可以帮助大家，尤其是小白们用大白话解决一些更实质性的问题（毕竟自己也是从那个时候一步一步过来的）

当Spring Boot遇见Mybatis（连接Mysql）

前言

准备工作

正文

真实项目演示

注解形式

xml形式

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读

SpringBoot极简教程 · Spring Boot

Spring-Boot