当Spring Boot遇见Mybatis（连接Mysql）

前言

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

准备工作

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

2. 我们需要在本地安装上你需要连接的数据库，我这里使用的是Mysql数据库，这里给大家贴出mysql官网下载地址mysql 下载地址
3. 对于新手来说，有可能通过命令行去使用数据库，太强人所难，我自己是使用 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中,,,标签中的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","[email protected]","15566416991");
          return userDao.addUser(user);
      }
      
      @GetMapping("/updateUser")
      public Integer updateUser() {
          User user =new User("luckyharry",22,"luckyharry","[email protected]","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 getHobby();
      
  }
  

  在这里使用@Mapper注解。
  然后我们在xml中定义属于这个接口的xml文件。

  
  
      
      
        
        
        
        
      
          
              insert into hobby (name,user_id,create_date) values (#{name},#{userId},now());
          
          
          
              update hobby set name=#{name},user_id=#{userId},create_date=now(); 
              where id={id}
          
          
          
              delete from hobby where id=#{id}
          
          
          

  select * from hobby;

  在这里我们可以看到我们有一个父标签为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
  

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