SpringBoot 整合 Mybatis + Mysql——XML配置方式

1、介紹

　　SpringBoot有兩種方法與數據庫創建鏈接，一種是集成Mybatis，另外一種用JdbcTemplate，本文主要討論集成Mybatis方式。

　　SpringBoot整合Mybatis也有兩種方式，分別爲XML配置方式和註解方式，主要優點點以下：

• XML配置方式：隔離sql和業務代碼，清晰表達sql，尤爲對於較長的sql。
• 註解方式：代碼更加精簡，方便。

本文主要討論XML配置方式，後續文章討論註解方式。

 

2、SpringBoot整合Mybatis鏈接Mysql數據庫

一、添加MySQL 鏈接驅動依賴、SpringBoot Mybatis 依賴，完整pom文件以下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>

    <name>hello</name>
    <description>Demo project for Spring Boot</description>

    <!--版本信息-->
    <properties>
        <mybatis-spring-boot>1.3.0</mybatis-spring-boot>
        <mysql-connector>5.1.39</mysql-connector>
    </properties>
    
   <!-- SpringBoot啓動父依賴 -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.1.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <dependencies>
        <!-- Spring Boot Web 依賴 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!-- MySQL 鏈接驅動依賴 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>${mysql-connector}</version>
        </dependency>

        <!-- SpringBoot Mybatis 依賴 -->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>${mybatis-spring-boot}</version>
        </dependency>

        <!-- lombok依賴-->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>

        <!-- logback 依賴-->
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
        </dependency>

         <!--Slf4j 依賴-->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>jcl-over-slf4j</artifactId>
        </dependency>
    </dependencies>

</project>

注：

整合MyBatis的核心依賴MyBatis-Spring-Boot-Starter提供：

• 自動檢測現有的DataSource
• 將建立並註冊SqlSessionFactory的實例，該實例使用SqlSessionFactoryBean將該DataSource做爲輸入進行傳遞
• 將建立並註冊從SqlSessionFactory中獲取的SqlSessionTemplate的實例。
• 自動掃描您的mappers，將它們連接到SqlSessionTemplate並將其註冊到Spring上下文，以便將它們注入到您的bean中。

所以，引入該Starter以後，只須要定義一個DataSource便可（application.properties中可配置），它會自動建立使用該DataSource的SqlSessionFactoryBean以及SqlSessionTemplate。會自動掃描你的Mappers，鏈接到SqlSessionTemplate，並註冊到Spring上下文中。

 

二、配置application.yml文件

• 配置數據庫鏈接信息（數據源）

spring:
    #數據源
  datasource:
    url: jdbc:mysql://localhost:3306/springbootdb??useUnicode=true&characterEncoding=UTF-8
    username: root
    password: 123
    driver-class-name: com.mysql.jdbc.Driver

• 配置mybatis

#mybatis配置
mybatis:
  typeAliasesPackage: com.example.mybaitsxml.dao.entity
  mapperLocations: classpath:mapper/*.xml
  #configLocation: classpath:/mybatis-config.xml

注：一般，若mybatis配置信息較少，只是針對基本配置無需複雜配置，則只需在application.yml文件中配置便可，不然最好配置在 mybatis-config.xml中。

 

三、代碼實現

demo工程文件結構：

• controller層

@Slf4j
@RestController
@RequestMapping("/web")
public class UserController {
    @Autowired
    private UserService userService;

    @GetMapping("/queryAllUsers")
    public List<User> queryAllUsers(){
        return userService.queryAllUsers();
    }
}

• service層（實現）

@Slf4j
@Service
public class UserServiceImpl implements UserService {
    @Autowired
    private UserMapper userMapper;

    @Override
    public List<User> queryAllUsers() {
        log.info("/queryAllUsers start...");
        return userMapper.queryAllUsers();
    }
}

• dao層

dao層分爲數據庫實體類（entity）和數據庫操做mapper接口（mapper）

entity：

@Data
public class User {
    private String name ;
    private String sex;
    private Integer age;
    private Integer classNo;

}

mapper：

public interface UserMapper {
    List<User> queryAllUsers();
}

• mapper.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.mybaitsxml.dao.mapper.UserMapper" >
    <resultMap id ="UserInfoMap" type="com.example.mybaitsxml.dao.entity.User">
        <result column="name_" property="name"/>
        <result column="sex" property="sex"/>
        <result column="age" property="age"/>
        <result column="class_no" property="classNo"/>
    </resultMap>

    <select id = "queryAllUsers" resultMap="UserInfoMap">
        select
          name_,
          sex,
          age,
          class_no
        from
          tbl_user
    </select>
</mapper>

 

四、執行效果

 

五、Demo源碼

　　本文示例源碼已託管到本人Github倉庫，有須要的朋友請自行拉取。

地址：https://github.com/gavincoder/SpringBoot--Learning