SpringBoot系列之JDBC数据访问

SpringBoot系列之JDBC数据访问

SpringBoot jdbc是比较常用的内容，本博客通过实验并简单跟源码的方式进行介绍，希望可以帮助学习者更好地理解

环境准备：

• IDEA
• Maven

先新建一个项目：

New->Project or Module->Spring Initializer



选择JDBC和mysql驱动，为了方便测试web等等也可以选上

项目创建成功之后，会自动配上如下的配置：

<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>

新建一个application.yml配置文件：

spring:
  datasource:
    username: root
    password: root
    url: jdbc:mysql://127.0.0.1:3306/springboot
    driver-class-name: com.mysql.jdbc.Driver

新建一个junit测试类进行测试：

package com.example.springboot.jdbc;

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 SppringbootJdbcApplicationTests {

	@Autowired
	DataSource dataSource;

	@Test
	public void contextLoads() throws SQLException {
		System.out.println(dataSource.getClass());
		Connection connection = dataSource.getConnection();
		System.out.println(connection);
		connection.close();
	}

}

启动调试，发现控制台抛出异常信息：

Caused by: com.mysql.cj.exceptions.UnableToConnectException: CLIENT_PLUGIN_AUTH is required

at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)

at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:62)

at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45)

at java.lang.reflect.Constructor.newInstance(Constructor.java:408)

at com.mysql.cj.exceptions.ExceptionFactory.createException(ExceptionFactory.java:61)

at com.mysql.cj.exceptions.ExceptionFactory.createException(ExceptionFactory.java:85)

at com.mysql.cj.protocol.a.NativeAuthenticationProvider.connect(NativeAuthenticationProvider.java:205)

at com.mysql.cj.protocol.a.NativeProtocol.connect(NativeProtocol.java:1340)

at com.mysql.cj.NativeSession.connect(NativeSession.java:157)

at com.mysql.cj.jdbc.ConnectionImpl.connectOneTryOnly(ConnectionImpl.java:956)

at com.mysql.cj.jdbc.ConnectionImpl.createNewIO(ConnectionImpl.java:826)

... 90 more

原因是我的mysql服务器是5.+版本，而最新版2.2.1默认配置的mysql驱动版本是8.+的，8.+的驱动类是com.mysql.cj.jdbc.Driver，而非com.mysql.jdbc.Driver，所以解决方法还是手动加一下mysql驱动版本

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

ok，现在正常测试，测试通过：

class com.zaxxer.hikari.HikariDataSource

2019-12-14 15:47:25.241 INFO 6772 --- [ main] com.zaxxer.hikari.HikariDataSource : HikariPool-1 - Starting...

2019-12-14 15:47:27.403 INFO 6772 --- [ main] com.zaxxer.hikari.HikariDataSource : HikariPool-1 - Start completed.

HikariProxyConnection@23906266 wrapping com.mysql.jdbc.JDBC4Connection@717ed

可以看出2.2.1版本的Springboot默认数据源类是com.zaxxer.hikari.HikariDataSource，而1.+版本很多都是以org.apache.tomcat.jdbc.pool.DataSource为默认数据源类的，具体哪个版本开始改变的不清楚

既然Springboot默认使用hikari数据源，那就可以加上hikari的一些自定义配置

spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/springboot?characterEncoding=utf8&useSSL=true
    username: root
    password: root
    driver-class-name: com.mysql.jdbc.Driver
    initialization-mode: always
    type: com.zaxxer.hikari.HikariDataSource

    hikari:
      jdbc-url: jdbc:mysql://127.0.0.1:3306/springboot?characterEncoding=utf8&useSSL=true
      minimum-idle: 5
      maximum-pool-size: 15
      auto-commit: true
      idle-timeout: 30000
      pool-name: DatebookHikariCP
      max-lifetime: 1800000
      connection-timeout: 30000
      connection-test-query: select 1

经过调试，属性配置是有起效的



ok，掌握简单应用之后，还是要跟一下源码，依照经验，找到对应的自动配置类DataSourceAutoConfiguration.java

不需要全部看懂源码，只要找到关键的信息即可，如图在这个自动配置类路其实就可以看出Springboot2.2.1支持的数据源种类有如下：



点一下DataSourceConfiguration类，里面都是各种DataSource的配置，用了很多@Conditional注解，条件符合才会起效



然后为什么说2.2.1版本默认是Hikari作为Datasource的？可以看一下项目的依赖图，可以看出默认引入了Hikari的jar



而且条件都符合，所以HikariDataSource就会进行自动配置



源码里用import引入了一个DataSourceInitializationConfiguration类，看其命名，应该是个初始化配置类



挑重点，如图，很明显要用了Spring框架很重要的后置处理器，还有一个DataSourceInitializerInvoker类



DataSourceInitializerInvoker类是做什么的？看其源码应该是一个初始化操作的监听器类，主要操作由DataSourceInitializer执行



DataSourceInitializer源码，里面有很多操作都是进行schema脚本的操作，只要非isEnabled就可以执行



只要两个条件符合就执行，DataSourceInitializationMode属性，看起来是通过配置文件获取的



getScripts，获取对应的脚本



读取schema脚本，所以可以看出只要将一些sql文件放在resources即可，默认文件命名为schema.sql，schema‐all.sql；



再通过资料，确认了这个类确实是执行一些初始化schema脚本的，根据application提示，发现有个属性，将其改为always即可

改为embedded是不能执行的，虽然源码里代码是这样的



还有这个关键代码，从配置spring.datasource.schema获取信息，

List<Resource> scripts = getScripts("spring.datasource.schema", this.properties.getSchema(), "schema");

private List<Resource> getResources(String propertyName, List<String> locations, boolean validate) {
		List<Resource> resources = new ArrayList<>();
		for (String location : locations) {
			for (Resource resource : doGetResources(location)) {
				if (resource.exists()) {
					resources.add(resource);
				}
				else if (validate) {
					throw new InvalidConfigurationPropertyValueException(propertyName, resource,
							"The specified resource does not exist.");
				}
			}
		}
		return resources;
	}

location就是一个字符类型的位置信息，所以可以使用如下配置，显然就可以自定义schema脚本，不需要固定为schema.sql或者schema-all.sql

代码例子下载：github下载链接