SpringBoot2.x系列教程21--SpringBoot中整合Mybatis框架实现数据库CRUD操作

imodouAbout 7 minSpringBoot

SpringBoot2.x系列教程21--SpringBoot中整合Mybatis框架实现数据库CRUD操作

前言

在上一章节中，我带大家在Spring Boot中整合了JdbcTemplate，利用JdbcTemplate感觉会比较麻烦，所以我让各位思考有没有更简单易用的实现方式。那么接下来在这一章节中，我会继续带领大家学习在Spring Boot中整合Mybatis框架，利用Mybatis来实现数据库的操作。

一. Mybatis简介

1. MyBatis概述

MyBatis是一款优秀的持久层框架，它本来是Apache的一个开源项目iBatis。在2010年的时候，这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis，在2013年11月的时候又迁移到了Github。

iBATIS一词来源于“internet”和“abatis”的组合，后来改名为了Mybatis。

2. Mybatis特点

支持定制化 SQL、存储过程以及高级映射。
MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。
简单易学：本身就很小且简单。没有任何第三方依赖，最简单安装只要两个jar文件+配置几个sql映射文件易于学习，易于使用，通过文档和源代码，可以比较完全的掌握它的设计思路和实现。
灵活：mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里，便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
解除sql与程序代码的耦合：通过提供DAO层，将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，更易维护，更易单元测试。sql和代码的分离，提高了可维护性。
提供映射标签，支持对象与数据库的orm字段关系映射。
提供对象关系映射标签，支持对象关系组建维护。
提供xml标签，支持编写动态SQL。

3. Mybatis的发展历程

Mybatis 初期使用比较麻烦，需要各种配置文件、实体类、Dao 层映射关联、还有一大推其它配置。

然后 Mybatis 就发现了这种弊端，为了解决这种弊端，就开发了generator逆向工程，可以根据表结构自动生成实体类、配置文件和 Dao 层代码，可以减轻一部分开发量。

后期也进行了大量的优化，可以使用注解进一步简化开发，自动管理 Dao 层和配置文件等。到了今天Mybatis进一步简化到极致，那就是mybatis-spring-boot-starter 的出现。我们可以利用 Spring Boot 整合 Mybatis，即使完全不用配置文件，也可以简单配置轻松实现数据库操作。

spring.datasource.url: 数据库连接字符串; spring.datasource.username: 数据库用户名; spring.datasource.password: 数据库密码; spring.datasource.driver-class-name: 驱动类型(注意MySQL 8.0的值是com.mysql.cj.jdbc.Driver和之前不同); mybatis.type-aliases-package 配置mapper包名。

4. 创建DataSource配置类(可以省略)

这里我使用用Druid提供的DataSource作为数据源，来替换默认的DataSource。

package com.yyg.boot.config;

import com.alibaba.druid.pool.DruidDataSource;
import lombok.Data;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;

import javax.sql.DataSource;

/**
 * @Author 一一哥Sun
 * @Date Created in 2020/3/30
 * @Description 第二种配置数据源的方式
 */
@Data
@ComponentScan
@Configuration
@ConfigurationProperties(prefix="spring.datasource")
@MapperScan("com.yyg.boot.mapper")
public class DbConfig {

    private String url;
    private String username;
    private String password;

    @Bean
    public DataSource getDataSource() {
        DruidDataSource dataSource = new DruidDataSource();
        dataSource.setUrl(url);
        dataSource.setUsername(username);
        dataSource.setPassword(password);
        return dataSource;
    }

}

我们可以在这个类上添加@MapperScan("com.yyg.boot.mapper")，指定Mapper接口所在包位置。

5. 创建实体类

然后封装一个实体类，对应我们的数据库用户表。

package com.yyg.boot.domain;

import lombok.Data;
import lombok.ToString;

/**
 * @Author 一一哥Sun
 * @Date Created in 2020/3/30
 * @Description Description
 */
@Data
@ToString
public class User {

    private Long id;

    private String username;

    private String birthday;

    private String sex;

    private String address;

}

6. 创建UserMapper接口

这里我创建一个Mapper接口类，封装几个数据库操作方法，方法上面使用注解来实现数据库增删改查操作。

package com.yyg.boot.mapper;

import com.yyg.boot.domain.User;
import org.apache.ibatis.annotations.*;

/**
 * @Author 一一哥Sun
 * @Date Created in 2020/3/31
 * @Description 在Mybatis的Mapper接口中,增删改查都有对应的注解.@Insert,@Select,@Delete,@Update
 */
public interface UserMapper {

    @Select("select * from user where id = #{id}")
    User queryUserById(@Param(value = "id") int id);

    @Insert("insert into user(username,birthday,sex,address) values(#{username},#{birthday},#{sex},#{address})")
    void insertUser(User user);

    @Update("UPDATE user SET sex=#{sex} WHERE username=#{username}")
    void updateUser(User user);

    @Delete("DELETE FROM user WHERE id =#{id}")
    void deleteById(@Param("id") int id);
}

Mapper中常用注解含义：

@Select 是查询类的注解，所有的查询均使用这个；
@Result 修饰返回的结果集，关联实体类属性和数据库字段一一对应，如果实体类属性和数据库属性名保持一致，就不需要这个属性来修饰；
@Insert 插入数据库使用，直接传入实体类会自动解析属性到对应的值；
@Update 负责修改，也可以直接传入对象；
@delete 负责删除。

7. 创建Controller控制器

我们再创建一个Controller，里面定义几个RESTful风格的接口。

package com.yyg.boot.web;

import com.yyg.boot.domain.User;
import com.yyg.boot.mapper.UserMapper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

/**
 * @Author 一一哥Sun
 * @Date Created in 2020/3/31
 * @Description Description
 */
@RestController
@RequestMapping("/user")
public class UserController {

    @Autowired
    private UserMapper userMapper;

    @GetMapping("/{id}")
    public User findUserById(@PathVariable("id") Integer id) {
        return userMapper.queryUserById(id);
    }

    @PostMapping("")
    public String addUser(@RequestBody User user) {
        userMapper.insertUser(user);
        return "success";
    }

    @PostMapping("/update")
    public String updateUser(@RequestBody User user) {
        userMapper.updateUser(user);
        return "success";
    }

    @DeleteMapping("/{id}")
    public String delUserById(@PathVariable("id") Integer id) {
        userMapper.deleteById(id);
        return "success";
    }

}

8. 创建Application入口类

最后创建一个项目入口类，另外我们也可以在入口类上添加@MapperScan("com.yyg.boot.mapper")注解，指定Mapper接口所在包位置。

package com.yyg.boot;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**
 * @Author 一一哥Sun
 * @Date Created in 2020/3/31
 * @Description Description
 */
@SpringBootApplication
//@MapperScan("com.yyg.boot.mapper")
public class MybatisApplication {

    public static void main(String[] args) {
        SpringApplication.run(MybatisApplication.class, args);
    }

}