SpringBoot：Mybatis + Druid 資料訪問

1、簡介

? 對于資料訪問層，無論是SQL(關系型資料庫) 還是NOSQL(非關系型資料庫)，SpringBoot 底層都是采用 SpringData 的方式進行統一處理，

? Spring Boot 底層都是采用 SpringData 的方式進行統一處理各種資料庫，SpringData也是Spring中與SpringBoot、SpringCloud 等齊名的知名專案，

SpingData 官網：https://spring.io/projects

資料庫相關的啟動器 ： 可以參考官方檔案：https://docs.spring.io/springboot/docs/2.1.7.RELEASE/reference/htmlsingle/#using-boot-starter

2、JDBC

新建一個專案測驗：springboot-data; 引入相應的模塊！基礎模塊

專案建好之后，發現自動幫我們匯入了如下的啟動器：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>

實作資料庫的訪問

1. 先連接上資料庫 ， 直接使用IDEA連接即可【操作】

2. SpringBoot中，我們只需要簡單的配置就可以實作資料庫的連接了；

我們使用yaml的組態檔進行操作！

spring:
  datasource:
    username: root
    password: 123456
    #?serverTimezone=UTC解決時區的報錯
    url: jdbc:mysql://localhost:3306/mybatis?serverTimezone=UTC&useUnicode=true&characterEncoding=utf-8

配置完這一些東西后，就可以直接去使用了，因為SpringBoot已經默認幫我們進行了自動配置；我們去測驗類測驗一下

package com.kk;

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

import javax.sql.DataSource;
import java.sql.Connection;
import java.sql.SQLException;

@SpringBootTest
class Springboot04DataApplicationTests {

    @Autowired
    DataSource dataSource;
    @Test
    void contextLoads() throws SQLException {
        //查看默認的資料源 class com.zaxxer.hikari.HikariDataSource   dbcp
        System.out.println(dataSource.getClass());
        //獲得資料庫連接
        Connection connection = dataSource.getConnection();
        System.out.println(connection);
        connection.close();


    }

}

在運行的時候可能會遇到的Bug

SpringBoot 中 Invalid character found in the request target 例外

在啟動類中添加

@Bean
public ConfigurableServletWebServerFactory webServerFactory() {
    TomcatServletWebServerFactory factory = new TomcatServletWebServerFactory();
    factory.addConnectorCustomizers(new TomcatConnectorCustomizer() {
        @Override
        public void customize(Connector connector) {
            connector.setProperty("relaxedQueryChars", "|{}[]");
        }
    });
    return factory;
}

? 輸出結果：可以看到它默認給我們配置的資料源為 : class com.zaxxer.hikari.HikariDataSource ， 我們并沒有手動配置

? 全域搜索一下，找到資料源的所有自動配置都在 ：DataSourceProperties 檔案下；這里自動配置的原理以及能配置哪些屬性？

• Spring Boot 2.1.7 默認使用 com.zaxxer.hikari.HikariDataSource 資料源，
• 而以前版本，如 Spring Boot 1.5 默認使用 org.apache.tomcat.jdbc.pool.DataSource 作為資料源；

HikariDataSource 號稱 Java WEB 當前速度最快的資料源，相比于傳統的 C3P0 、DBCP、Tomcat jdbc 等連接池更加優秀；

有了資料庫連接，顯然就可以 CRUD 操作資料庫了，

3、CRUD操作

? 1、有了資料源(com.zaxxer.hikari.HikariDataSource)，可以拿到資料庫連接(java.sql.Connection)，有了連接，就可以使用連接和原生的 JDBC 陳述句來操作資料庫

? 2、即使不使用第三方第資料庫操作框架，如 MyBatis等，Spring 本身也對原生的JDBC 做了輕量級的封裝，即 org.springframework.jdbc.core.JdbcTemplate，

? 3、資料庫操作的所有 CRUD 方法都在 JdbcTemplate 中，

? 4、Spring Boot 不僅提供了默認的資料源，同時默認已經配置好了 JdbcTemplate 放在了容器中，程式員只需自己注入即可使用

? 5、JdbcTemplate 的自動配置原理是依賴 org.springframework.boot.autoconfigure.jdbc 包下的 org.springframework.boot.autoconfigure.jdbc.JdbcTemplateAutoConfiguration 類

JdbcTemplate主要提供以下幾類方法：

1. execute方法：可以用于執行任何SQL陳述句，一般用于執行DDL陳述句；
2. update方法及batchUpdate方法：update方法用于執行新增、修改、洗掉等陳述句；batchUpdate方法用于執行批處理相關陳述句；
3. query方法及queryForxxx方法：用于執行查詢相關陳述句；
4. call方法：用于執行存盤程序、函式相關陳述句，

測驗：

package com.kk.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;
import java.util.Map;

@RestController
public class JDBCController {
    
    //JdbcTemplate 是 core 包的核心類，用于簡化 JDBC操作，還能避免一些常見的錯誤，如忘記關閉資料庫連接
    //Spring Boot 默認提供了資料源，默認提供了 org.springframework.jdbc.core.JdbcTemplate
    //JdbcTemplate 中會自己注入資料源，使用起來也不用再自己來關閉資料庫連接
    @Autowired
    JdbcTemplate jdbcTemplate;
    
   	//查詢資料庫的所有資訊
    //沒有物體類，資料庫中的東西怎么獲取? Map
   	//List 中的1個 Map 對應資料庫的 1行資料
    //Map 中的 key 對應資料庫的欄位名，value 對應資料庫的欄位值
    @GetMapping("/userList")
    public List<Map<String ,Object>> userList(){
        String sql="select * from user";
        List<Map<String, Object>> list_maps = jdbcTemplate.queryForList(sql);
        return list_maps;
    }

    @GetMapping("/addUser")
    public String addUser(){
        String sql="insert into mybatis.user(id,name,pwd) values(2,'dabai','123456')";
       jdbcTemplate.update(sql);
        return "update-ok";
    }

    @GetMapping("/updateUser/{id}")
    public String updateUser(@PathVariable("id") int id){
        String sql="update mybatis.user set name=?,pwd=? where id="+id;
        //封裝
        Object[] objects = new Object[2];
        objects[0]="xiaobai";
        objects[1]="9999999";
        jdbcTemplate.update(sql,objects);
        return "updateUser-ok";
    }

    @GetMapping("/deleteUser/{id}")
    public String deleteUser(@PathVariable("id") int id){
        String sql="delete from mybatis.user where id=?";
        jdbcTemplate.update(sql,id);
        return "deleteUser-ok";
    }
}

測驗成功！

原理探究 ：

org.springframework.boot.autoconfigure.jdbc.DataSourceConfiguration 資料源配置類作用 ：根據邏輯判斷之后，添加資料源；

SpringBoot默認支持以下資料源：

1. com.zaxxer.hikari.HikariDataSource （Spring Boot 2.0 以上，默認使用此資料源）

2. org.apache.tomcat.jdbc.pool.DataSource

3. org.apache.commons.dbcp2.BasicDataSource

   可以使用 spring.datasource.type 指定自定義的資料源型別，值為要使用的連接池實作的完全限定名，默認情況下，它是從類路徑自動檢測的，

	 @Configuration
    @ConditionalOnMissingBean({DataSource.class})
    @ConditionalOnProperty(
        name = {"spring.datasource.type"}
    )
    static class Generic {
        Generic() {
        }

        @Bean
        public DataSource dataSource(DataSourceProperties properties) {
            return properties.initializeDataSourceBuilder().build();
        }
    }

4、自定義資料源 DruidDataSource

DRUID 簡介

1. ? Druid 是阿里巴巴開源平臺上一個資料庫連接池實作，結合了 C3P0、DBCP、PROXOOL 等 DB 池的優點，同時 加入了日志監控，
2. ? Druid 可以很好的監控 DB 池連接和 SQL 的執行情況，天生就是針對監控而生的 DB 連接池，
3. ? Spring Boot 2.0 以上默認使用 Hikari 資料源，可以說 Hikari 與 Driud 都是當前 Java Web 上最優秀的資料源，我們 來重點介紹 Spring Boot 如何集成 Druid 資料源，如何實作資料庫監控，

*com.alibaba.druid.pool.DruidDataSource 基本配置引數如下：*

引入資料源

<!-- https://mvnrepository.com/artifact/com.alibaba/druid -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid</artifactId>
    <version>1.2.6</version>
</dependency>

查看專案依賴，匯入成功！

切換資料源；

? 之前已經說過 Spring Boot 2.0 以上默認使用 com.zaxxer.hikari.HikariDataSource 資料源，可以通過 spring.datasource.type 指定資料源，

type: com.alibaba.druid.pool.DruidDataSource

設定資料源連接初始化大小、最大連接數、等待時間、最小連接數 等設定項；

#Spring Boot 默認是不注入這些屬性值的，需要自己系結
#druid 資料源專有配置
initialSize: 5
minIdle: 5
maxActive: 20
maxWait: 60000
timeBetweenEvictionRunsMillis: 60000
minEvictableIdleTimeMillis: 300000
validationQuery: SELECT 1 FROM DUAL
testWhileIdle: true
testOnBorrow: false
testOnReturn: false
poolPreparedStatements: true
#配置監控統計攔截的filters，stat:監控統計、log4j：日志記錄、wall：防御sql注入
#如果允許時報錯  java.lang.ClassNotFoundException: org.apache.log4j.Priority
#則匯入 log4j 依賴即可，Maven 地址： https://mvnrepository.com/artifact/log4j/log4j
filters: stat,wall,log4j
maxPoolPreparedStatementPerConnectionSize: 20
useGlobalDataSourceStat: true
connectionProperties: druid.stat.mergeSql=true;druid.stat.slowSqlMillis=500

log4****日志依賴

<!-- https://mvnrepository.com/artifact/log4j/log4j -->
<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>

測驗

public class SpringbootDemoDataApplicationTests {

    //注入資料源
    @Autowired
    DataSource dataSource;

    @Test
    public void contextLoads() throws SQLException {
        //看一下默認資料源
        System.out.println(dataSource.getClass());
        //獲得連接
        Connection connection =   dataSource.getConnection();
        System.out.println(connection);

        DruidDataSource druidDataSource = (DruidDataSource) dataSource;
        System.out.println("druidDataSource 資料源最大連接數：" + druidDataSource.getMaxActive());
        System.out.println("druidDataSource 資料源初始化連接數：" + druidDataSource.getInitialSize());

        //關閉連接
        connection.close();
    }

}

測驗成功！

1、配置 Druid 資料源監控

? Druid 資料源具有監控的功能，并提供了一個web界面方便用戶查看，類似安裝路由器 時，它也提供了一個默認的 web 頁面，

? 所以第一步需要設定 Druid 的后臺管理頁面，比如登錄賬號、密碼等配置后臺管理；

package com.kk.config;

import com.alibaba.druid.pool.DruidDataSource;
import com.alibaba.druid.support.http.StatViewServlet;
import com.alibaba.druid.support.http.WebStatFilter;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.boot.web.servlet.FilterRegistrationBean;
import org.springframework.boot.web.servlet.ServletRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import javax.servlet.Filter;
import javax.sql.DataSource;
import java.util.HashMap;
import java.util.Map;

@Configuration
public class DruidConfig {

    @ConfigurationProperties(prefix = "spring.datasource")  //關聯application.yaml中的spring.datasource
    @Bean
    public DataSource druidDataSource(){
        return new DruidDataSource();
    }

    //配置 Druid 監控管理后臺的Servlet；
    //內置 Servler 容器時沒有web.xml檔案，所以使用 Spring Boot 的注冊 Servlet 方式
    @Bean
    public ServletRegistrationBean statViewServlet() {
        ServletRegistrationBean bean = new ServletRegistrationBean(new StatViewServlet(), "/druid/*");

        Map<String, String> initParams = new HashMap<>();
        initParams.put("loginUsername", "admin"); //后臺管理界面的登錄賬號
        initParams.put("loginPassword", "123456"); //后臺管理界面的登錄密碼

        //后臺允許誰可以訪問
        //initParams.put("allow", "localhost")：表示只有本機可以訪問
        //initParams.put("allow", "")：為慷訓者為null時，表示允許所有訪問
        initParams.put("allow", "");
        //deny：Druid 后臺拒絕誰訪問
        //initParams.put("kuangshen", "192.168.1.20");表示禁止此ip訪問

        //設定初始化引數
        bean.setInitParameters(initParams);
        return bean;
        //這些引數可以在 com.alibaba.druid.support.http.StatViewServlet 的父類 com.alibaba.druid.support.http.ResourceServlet 中找到
    }



    //filter
    @Bean
    public FilterRegistrationBean webStatFilter(){
        FilterRegistrationBean<Filter> bean = new FilterRegistrationBean<>();
        bean.setFilter(new WebStatFilter());

        //可以過濾哪些請求？
        HashMap<String, String> initParameters = new HashMap<>();
        //這些東西不進行統計
        initParameters.put("exclusions","*.js,*.css,/druid/*");


        bean.setInitParameters(initParameters);
        return bean;
    }
}

測驗訪問！ http://localhost:8080/druid/login.html

2、配置 Druid web 監控 filter

? 這個過濾器的作用就是統計 web 應用請求中所有的資料庫資訊，比如 發出的 sql 陳述句，sql 執行的時間、請求次數、請求的 url 地址、以及seesion 監控、資料庫表的訪問次數 等等，

//filter
@Bean
public FilterRegistrationBean webStatFilter(){
    FilterRegistrationBean<Filter> bean = new FilterRegistrationBean<>();
    bean.setFilter(new WebStatFilter());

    //可以過濾哪些請求？
    HashMap<String, String> initParameters = new HashMap<>();
    //這些東西不進行統計
    initParameters.put("exclusions","*.js,*.css,/druid/*");


    bean.setInitParameters(initParameters);
    return bean;
}

執行sql

執行sql之后會有記錄

5、SpringBoot 整合mybatis

1. 匯入mybatis所需要的依賴

<!-- https://mvnrepository.com/artifact/org.mybatis.spring.boot/mybatis-spring-boot-starter -->
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>2.2.0</version>
</dependency>

2.配置資料庫連接資訊

# 資料庫驅動：
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
# 資料源名稱
spring.datasource.name=defaultDataSource
# 資料庫連接地址
spring.datasource.url=jdbc:mysql://localhost:3306/mybatis?useUnicode=true&characterEncoding=utf-8&serverTimezone=UTC
# 資料庫用戶名&密碼：
spring.datasource.username=root
spring.datasource.password=123456

測驗一下連接是否成功！

package com.kk;

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

import javax.sql.DataSource;
import java.sql.SQLException;

@SpringBootTest
class Springboot05MybatisApplicationTests {

    @Autowired
    DataSource dataSource;
    @Test
    void contextLoads() throws SQLException {
        System.out.println(dataSource.getClass());
        System.out.println(dataSource.getConnection());
    }

}

測驗成功！

3，創建物體類

package com.kk.pojo;

public class User {
    private int id;
    private String name;
    private String pwd;

    public User() {
    }

    public User(int id, String name, String pwd) {
        this.id = id;
        this.name = name;
        this.pwd = pwd;
    }

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getPwd() {
        return pwd;
    }

    public void setPwd(String pwd) {
        this.pwd = pwd;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", pwd='" + pwd + '\'' +
                '}';
    }
}

4.配置Mapper介面類

package com.kk.mapper;

import com.kk.pojo.User;
import org.apache.ibatis.annotations.Mapper;
import org.springframework.stereotype.Repository;

import java.util.List;

//這個注解表示 這是一個mybatis 的mapper類
@Mapper  //controller層
@Repository  //spring
public interface UserMapper {



    List<User> queryUserList();

    User queryUserById(int id);

    int addUser(User user);

    int updateUser(User user);

    int deleteUser(int id);




}

5.撰寫controller

package com.kk.controller;

import com.kk.mapper.UserMapper;
import com.kk.pojo.User;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;

@RestController
public class UserController {

    @Autowired
    private UserMapper userMapper;

    @GetMapping("/queryUserList")
    public List<User> queryUserList(){
        List<User> userList = userMapper.queryUserList();
        for (User user : userList) {
            System.out.println(user);
        }
        return userList;
    }

    //根據id選擇用戶
    @GetMapping("/queryUserById")
    public String selectUserById(){
        User user = userMapper.queryUserById(1);
        System.out.println(user);
        return "ok";
    }
    //添加一個用戶
    @GetMapping("/addUser")
    public String addUser(){
        userMapper.addUser(new User(1,"大黃","9999999"));
        userMapper.addUser(new User(3,"大黃","9999999"));
        userMapper.addUser(new User(4,"大黃","9999999"));

        return "ok";
    }
    //修改一個用戶
    @GetMapping("/updateUser")
    public String updateUser(){
        userMapper.updateUser(new User(5,"黃毛","999999"));
        return "ok";
    }
    //根據id刪除用戶
    @GetMapping("/deleteUser")
    public String deleteUser(){
        userMapper.deleteUser(5);
        return "ok";
    }
}

6.SpringBoot 整合

? 以前 MyBatis 未與 spring 整合時，配置資料源、事務、連接資料庫的賬號、密碼等都是在 myBatis 核心組態檔中進行的
? myBatis 與 springboot 整合后，配置資料源、事務、連接資料庫的賬號、密碼等就交由 spring 管理，因此，在這里我們即使不使用mybatis組態檔也完全ok！
既然已經提供了 myBatis 的映射組態檔，就需要告訴 spring boot 這些檔案的位置

# 整合mybatis
# 設定別名以及設定能讓spring識別
#指定myBatis的核心組態檔與Mapper映射檔案
# 注意：對應物體類的路徑
mybatis.type-aliases-package=com.kk.pojo
mybatis.mapper-locations=classpath:mybatis/mapper/*.xml

? springboot 官方并沒有提供 myBaits 的啟動器，是 myBatis 官方提供的開發包來適配的 spring boot，從 pom.xml 檔案中的依賴包名也能看出來，并非是以 spring-boot 開頭的；

? 同理上面全域組態檔中的這兩行配置也是以 mybatis 開頭 而非 spring 開頭也充分說明這些都是 myBatis 官方提供的

從 org.mybatis.spring.boot.autoconfigure.MybatisProperties 中查看所有配置項

@ConfigurationProperties(
    prefix = "mybatis"
)
public class MybatisProperties {
    public static final String MYBATIS_PREFIX = "mybatis";
    private static final ResourcePatternResolver resourceResolver = new PathMatchingResourcePatternResolver();
    private String configLocation;
    private String[] mapperLocations;
    private String typeAliasesPackage;
    private Class<?> typeAliasesSuperType;
    private String typeHandlersPackage;
    private boolean checkConfigLocation = false;
    private ExecutorType executorType;
    private Class<? extends LanguageDriver> defaultScriptingLanguageDriver;
    private Properties configurationProperties;
    @NestedConfigurationProperty
    private Configuration configuration;

ybatis"
)
public class MybatisProperties {
public static final String MYBATIS_PREFIX = “mybatis”;
private static final ResourcePatternResolver resourceResolver = new PathMatchingResourcePatternResolver();
private String configLocation;
private String[] mapperLocations;
private String typeAliasesPackage;
private Class<?> typeAliasesSuperType;
private String typeHandlersPackage;
private boolean checkConfigLocation = false;
private ExecutorType executorType;
private Class<? extends LanguageDriver> defaultScriptingLanguageDriver;
private Properties configurationProperties;
@NestedConfigurationProperty
private Configuration configuration;

 [官方檔案](