MyBatis 是一款優秀的持久層框架，它支持自定義 SQL、存儲過程以及高級映射。MyBatis 免除了幾乎所有的 JDBC 代碼以及設置參數和獲取結果集的工作。MyBatis 可以通過簡單的 XML 或注解來配置和映射原始類型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 對象）為數據庫中的記錄。
越來越多的企業已經將 MyBatis 使用到了正式的生產環境，本文就使用 MyBatis 的幾種方式提供簡單的示例，以及如何對數據庫密碼進行加密，目前有以下章節：
- 單獨使用 MyBatis
- 集成 Spring 框架
- 集成 Spring Boot 框架
- Spring Boot 配置數據庫密碼加密
- 如何配置動態數據源
1.單獨使用
引入 MyBatis 依賴，單獨使用，版本是3.5.6
引入依賴
<dependencies>
<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
<!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.19</version>
</dependency>
</dependencies>
添加mybatis-config.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!-- plugins在配置文件中的位置必須符合要求，否則會報錯，順序如下: properties?, settings?, typeAliases?,
typeHandlers?, objectFactory?,objectWrapperFactory?, plugins?, environments?,
databaseIdProvider?, mappers? -->
<!-- 配置mybatis的緩存，延遲加載等等一系列屬性 -->
<settings>
<!-- 全局映射器啟用緩存 -->
<setting name="cacheEnabled" value="false" />
<!-- 對於未知的SQL查詢，允許返回不同的結果集以達到通用的效果 -->
<setting name="multipleResultSetsEnabled" value="true" />
<!-- 是否開啟自動駝峰命名規則映射，數據庫的A_COLUMN映射為Java中的aColumn -->
<setting name="mapUnderscoreToCamelCase" value="true" />
<!-- MyBatis利用本地緩存機制（Local Cache）防止循環引用（circular references）和加速重復嵌套查詢 -->
<setting name="localCacheScope" value="STATEMENT" />
</settings>
<!-- 指定路徑下的實體類支持別名(默認實體類的名稱,首字母小寫), @Alias注解可設置別名 -->
<typeAliases>
<package name="tk.mybatis.simple.model" />
</typeAliases>
<!-- 配置當前環境信息 -->
<environments default="development">
<environment id="development">
<transactionManager type="JDBC">
<property name="" value=""/>
</transactionManager>
<!-- 配置數據源 -->
<dataSource type="UNPOOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/gsfy_user?useUnicode=true&characterEncoding=UTF-8&useSSL=false"/>
<property name="username" value="user"/>
<property name="password" value="password"/>
</dataSource>
</environment>
</environments>
<!-- 指定Mapper接口的路徑 -->
<mappers>
<package name="tk.mybatis.simple.mapper"/>
</mappers>
</configuration>
開始使用
Model類
tk.mybatis.simple.model.DbTest.java
package tk.mybatis.simple.model;
public class DbTest {
public Integer id;
public String text;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getText() {
return text;
}
public void setText(String text) {
this.text = text;
}
@Override
public String toString() {
return "DbTest{" +
"id=" + id +
", text='" + text + '\'' +
'}';
}
}
Mapper接口
tk.mybatis.simple.mapper.DbTestMapper
package tk.mybatis.simple.mapper;
import tk.mybatis.simple.model.DbTest;
public interface DbTestMapper {
DbTest queryById(Integer id);
}
XML映射文件
XML映射文件請放於Mapper接口所在路徑下，保證名稱相同
tk/mybatis/simple/mapper/DbTestMapper.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="tk.mybatis.simple.mapper.DbTestMapper">
<select id="queryById" parameterType="int" resultType="DbTest">
SELECT db_test_id AS id, db_test_text AS text
FROM db_test
WHERE db_test_id = #{id, jdbcType=INTEGER}
</select>
</mapper>
執行示例
package tk.mybatis.simple;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import tk.mybatis.simple.mapper.DbTestMapper;
import java.io.IOException;
import java.io.Reader;
public class MyBatisHelper {
private static SqlSessionFactory sqlSessionFactory;
static {
try {
// MyBatis的配置文件
Reader reader = Resources.getResourceAsReader("mybatis-config.xml");
// 創建一個 sqlSessionFactory 工廠類
sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);
reader.close();
} catch (IOException e) {
e.printStackTrace();
}
}
public static SqlSession getSqlSession() {
return sqlSessionFactory.openSession();
}
public static void main(String[] args) {
// 創建一個 SqlSession 會話
SqlSession sqlSession = MyBatisHelper.getSqlSession();
// 獲取 DbTestMapper 接口的動態代理對象
DbTestMapper dbTestMapper = sqlSession.getMapper(DbTestMapper.class);
// 執行查詢
System.out.println(dbTestMapper.queryById(1).toString());
}
}
2.集成Spring
在 Spring 項目中，使用 MyBatis 的模板，請注意 Spring 的版本為5.2.10.RELEASE
日志框架使用Log4j2（推薦），版本為2.13.3，性能高於logback和log4j
工程結構圖
- 其中
jquery.min.js文件可以去官網下載
引入依賴
<?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>tk.mybatis.simple</groupId>
<artifactId>mybatis-spring</artifactId>
<packaging>war</packaging>
<properties>
<!-- MyBatis 版本號 -->
<mybatis.version>3.5.6</mybatis.version>
<!-- Jackson 版本號 -->
<jackson.version>2.11.3</jackson.version>
<java.version>1.8</java.version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-framework-bom</artifactId>
<version>5.2.10.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-bom</artifactId>
<version>2.13.3</version>
<scope>import</scope>
<type>pom</type>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<!-- MyBatis 相關 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>1.3.2</version>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>${mybatis.version}</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.19</version>
</dependency>
<!-- druid 數據源-->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.2.3</version>
</dependency>
<!-- pagehelper 分頁插件 -->
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper</artifactId>
<version>5.2.0</version>
</dependency>
<dependency>
<groupId>com.github.jsqlparser</groupId>
<artifactId>jsqlparser</artifactId>
<version>3.2</version>
</dependency>
<!--web-->
<!--支持 Servlet-->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>
<scope>provided</scope>
</dependency>
<!--支持 JSP-->
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>jsp-api</artifactId>
<version>2.1</version>
<scope>provided</scope>
</dependency>
<!--支持 JSTL-->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
<!--Spring 上下文，核心依賴-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
</dependency>
<!--Spring JDBC-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jdbc</artifactId>
</dependency>
<!--Spring 事務-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-tx</artifactId>
</dependency>
<!--Spring 面向切面編程-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-aop</artifactId>
</dependency>
<!--spring-aop 依賴-->
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjweaver</artifactId>
<version>1.8.2</version>
</dependency>
<!--JSR 250 公共注解-->
<dependency>
<groupId>javax.annotation</groupId>
<artifactId>javax.annotation-api</artifactId>
<version>1.2</version>
</dependency>
<!--Java 事務接口-->
<dependency>
<groupId>javax.transaction</groupId>
<artifactId>javax.transaction-api</artifactId>
<version>1.2</version>
</dependency>
<!--Spring Web 核心-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
</dependency>
<!--Spring MVC-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
</dependency>
<!--spring mvc-json依賴-->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>${jackson.version}</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>${jackson.version}</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-annotations</artifactId>
<version>${jackson.version}</version>
</dependency>
<!-- 日志文件管理包 -->
<!-- log4j2 start -->
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
</dependency>
<!-- 保證 web 應用正常清理 log 資源 -->
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-web</artifactId>
</dependency>
<dependency> <!-- 橋接：slf4j 到 log4j2 的橋梁 -->
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-slf4j-impl</artifactId>
</dependency>
<dependency> <!-- 后向兼容：log4j1.x 平滑升級到 log4j2 -->
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-1.2-api</artifactId>
</dependency>
<dependency> <!-- 橋接：commons-logging（jcl） 到 log4j2 的橋梁 -->
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-jcl</artifactId>
</dependency>
<!-- slf4j 日志切面，相當於一個適配器 -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.7</version>
</dependency>
<!-- 高性能並發編程框架 log4j2 使用 -->
<dependency>
<groupId>com.lmax</groupId>
<artifactId>disruptor</artifactId>
<version>3.4.2</version>
</dependency>
<!-- log4j2 end -->
<!-- 上傳組件包 -->
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.4</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.8.0</version>
</dependency>
<dependency>
<groupId>commons-codec</groupId>
<artifactId>commons-codec</artifactId>
<version>1.15</version>
</dependency>
</dependencies>
<build>
<finalName>study-ssm</finalName>
<plugins>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.8</source>
<target>1.8</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
</plugins>
<resources>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
<resource>
<directory>src/main/resources/META-INF/spring</directory>
<includes>
<include>spring-mybatis.xml</include>
<include>spring-mvc.xml</include>
</includes>
<filtering>false</filtering>
</resource>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
</resources>
</build>
</project>
添加spring-mvc.xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.1.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.1.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">
<!-- 自動掃描該包，將 Spring Bean 注冊到 Spring 的上下文中 -->
<context:component-scan base-package="tk.mybatis.simple" />
<!--避免 IE 執行 AJAX 時，返回 JSON 出現下載文件 -->
<bean id="mappingJacksonHttpMessageConverter"
class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
<property name="supportedMediaTypes">
<list>
<value>text/html;charset=UTF-8</value>
</list>
</property>
</bean>
<!-- 啟動 SpringMVC 的注解功能，完成請求和注解 POJO 的映射 -->
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter ">
<property name="messageConverters">
<list>
<ref bean="mappingJacksonHttpMessageConverter" /> <!-- JSON轉換器 -->
</list>
</property>
</bean>
<!-- 配置文件上傳，如果沒有使用文件上傳可以不用配置，pom 中也不必引入上傳組件包 -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!-- 默認編碼 -->
<property name="defaultEncoding" value="utf-8" />
<!-- 文件大小最大值 100M -->
<property name="maxUploadSize" value="104857600" />
<!-- 內存中的最大值 4M-->
<property name="maxInMemorySize" value="40960" />
<!-- 啟用是為了推遲文件解析，以便捕獲文件大小異常 -->
<property name="resolveLazily" value="true"/>
</bean>
<!-- 定義 ViewResolver（視圖解析器），配置多個需要使用 order 屬性排序，InternalResourceViewResolver 放在最后-->
<bean class="org.springframework.web.accept.ContentNegotiationManagerFactoryBean">
<property name="favorParameter" value="true" />
<property name="parameterName" value="format"/>
<property name="ignoreAcceptHeader" value="true" />
<property name="mediaTypes">
<value>
<!-- 告訴視圖解析器，返回的類型為 json 格式 -->
json=application/json
xml=application/xml
html=text/html
</value>
</property>
<property name="defaultContentType" value="text/html" />
</bean>
<!-- 定義跳轉的文件的前后綴，視圖名稱解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<!-- 自動給后面 action 的方法 return 的字符串加上前綴和后綴，變成一個可用的地址 -->
<property name="prefix" value="/WEB-INF/jsp/" />
<property name="suffix" value=".jsp" />
</bean>
<!-- 擴充了注解驅動，可以將請求參數綁定到控制器參數 -->
<mvc:annotation-driven />
<!-- 讓一些靜態的不被 SpringMVC 的攔截器攔截 -->
<mvc:default-servlet-handler/>
<!-- 靜態資源 -->
<mvc:resources location="static/" mapping="/static/**"/>
</beans>
添加mybatis-config.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!-- plugins在配置文件中的位置必須符合要求，否則會報錯，順序如下: properties, settings, typeAliases, plugins,
objectFactory, objectWrapperFactory, reflectorFactory, environments, databaseIdProvider, typeHandlers, mappers -->
<!-- 配置mybatis的緩存，延遲加載等等一系列屬性 -->
<settings>
<!-- 全局的開啟或關閉配置文件中的所有映射器已經配置的任何緩存，關閉二級緩存，默認開啟 -->
<setting name="cacheEnabled" value="false" />
<!-- 開啟一級緩存，緩存級別為SESSION（默認），如果緩存級別為STATEMENT將不會再同一個SqlSession中緩存 -->
<setting name="localCacheScope" value="STATEMENT" />
<!-- 通過resultMap標簽內的association標簽可使用延遲加載 -->
<!-- 查詢時，關閉關聯對象即時加載以提高性能，開啟延遲加載，默認關閉，關閉表示直接加載，查詢時就進行關聯查詢 -->
<setting name="lazyLoadingEnabled" value="true" />
<!-- 設置關聯對象加載的形態，關閉侵入式延遲加載，在訪問主對象時不進行查詢關聯對象，而是在真正訪問關聯對象時才進行關聯查詢，以提高性能 -->
<!-- 3.4.1及之前的版本默認為開啟，表示查詢時不進行關聯查詢，訪問主對象時才進行關聯查詢 -->
<setting name="aggressiveLazyLoading" value="false" />
<!-- 允許使用列標簽代替列名 -->
<setting name="useColumnLabel" value="true" />
<!-- 不允許使用自定義的主鍵值(比如由程序生成的UUID 32位編碼作為鍵值)，數據表的PK生成策略將被覆蓋 -->
<setting name="useGeneratedKeys" value="false" />
<!-- 是否開啟自動駝峰命名規則（camel case）映射，即從經典數據庫列名A_COLUMN到經典Java屬性名aColumn的類似映射 -->
<setting name="mapUnderscoreToCamelCase" value="true" />
</settings>
<!-- 指定路徑下的實體類支持別名（默認實體類的名稱 全小寫）， @Alias 注解可設置別名 -->
<typeAliases>
<package name="tk.mybatis.simple.model" />
</typeAliases>
<plugins>
<!-- PageHelper 分頁插件，配置參考：https://github.com/pagehelper/Mybatis-PageHelper -->
<plugin interceptor="com.github.pagehelper.PageInterceptor">
<!-- 使用哪種方言的分頁方式，默認會檢測數據庫連接，自動選擇合適的分頁方式 -->
<property name="helperDialect" value="mysql"/>
<!-- 默認值為 false，該參數對使用 RowBounds 作為分頁參數時有效。
當該參數設置為 true 時，會將 RowBounds 中的 offset 參數當成 pageNum 使用，可以用頁碼和頁面大小兩個參數進行分頁 -->
<property name="offsetAsPageNum" value="true" />
<!-- 默認值為false，該參數對使用 RowBounds 作為分頁參數時有效。
當該參數設置為true時，使用 RowBounds 分頁會進行 count 查詢 -->
<property name="rowBoundsWithCount" value="true" />
<!-- 默認值為 false，當該參數設置為 true 時，
如果 pageSize=0 或者 RowBounds.limit = 0 就會查詢出全部的結果（相當於沒有執行分頁查詢，但是返回結果仍然是 Page 類型）-->
<property name="pageSizeZero" value="true" />
</plugin>
</plugins>
</configuration>
添加spring-mybatis.xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:tx="http://www.springframework.org/schema/tx" xmlns:aop="http://www.springframework.org/schema/aop"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.1.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx-3.0.xsd
http://www.springframework.org/schema/aop
https://www.springframework.org/schema/aop/spring-aop.xsd">
<!-- 定義一個數據源 -->
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource"
init-method="init" destroy-method="close">
<property name="url" value="jdbc:mysql://127.0.0.1:3306/test?useUnicode=true&characterEncoding=utf8"/>
<property name="driverClassName" value="com.mysql.cj.jdbc.Driver"/>
<property name="username" value="root"/>
<property name="password" value="password"/>
<property name="filters" value="stat,log4j,wall"/>
<!-- 最大連接池數量 -->
<property name="maxActive" value="20"/>
<property name="minIdle" value="20"/>
<!-- 初始化時建立物理連接的個數 -->
<property name="initialSize" value="5"/>
<!-- 獲取連接時最大等待時間 -->
<property name="maxWait" value="10000"/>
<!-- 在指定時間間隔內執行一次空閑連接回收器 -->
<property name="timeBetweenEvictionRunsMillis" value="3600000"/>
<!-- 池中的連接空閑指定時間后被回收 -->
<property name="minEvictableIdleTimeMillis" value="120000"/>
<property name="testWhileIdle" value="true"/>
<property name="testOnBorrow" value="false"/>
</bean>
<!-- Spring 和 MyBatis 整合 -->
<bean id="mySqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource"/>
<!-- 引入 MyBatis 配置文件 -->
<property name="configLocation" value="classpath:mybatis-config.xml"/>
<!-- 自動掃描 XML 映射文件 -->
<property name="mapperLocations" value="classpath:tk/mybatis/simple/mapper/*.xml"/>
</bean>
<!-- 通過 MapperScannerConfigurer 類自動掃描 Mapper 接口 -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<!-- Mapper 接口所在包路徑 -->
<property name="basePackage" value="tk.mybatis.simple.mapper"/>
<!--引用上面的 SqlSessionFactoryBean 對象 -->
<property name="sqlSessionFactoryBeanName" value="mySqlSessionFactory"/>
</bean>
<!-- 事務管理器 -->
<bean id="txManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<!-- 指定數據源 -->
<property name="dataSource" ref="dataSource"/>
</bean>
<!-- 設置為上面定義事務管理器，默認值為 transactionManager -->
<tx:annotation-driven transaction-manager="txManager"/>
<!-- 配置事務傳播特性 -->
<tx:advice id="transactionAdvice" transaction-manager="txManager">
<tx:attributes>
<tx:method name="insert*" rollback-for="java.lang.Exception"/>
<tx:method name="delete*" rollback-for="java.lang.Exception"/>
<tx:method name="update*" rollback-for="java.lang.Exception"/>
<tx:method name="*" read-only="true"/>
</tx:attributes>
</tx:advice>
<!-- 配置哪些類的哪些方法參與事務 -->
<aop:config>
<aop:advisor advice-ref="transactionAdvice" pointcut="execution(* tk.mybatis.*.service..*Service*.*(..))"/>
</aop:config>
<aop:aspectj-autoproxy/>
</beans>
添加log4j2.xml
<?xml version="1.0" encoding="UTF-8"?>
<configuration status="INFO" monitorInterval="30">
<appenders>
<!-- 參考官方地址：https://logging.apache.org/log4j/2.x/ -->
<!-- 這個輸出控制台的配置 -->
<Console name="Console" target="SYSTEM_OUT">
<!-- 設置輸出日志級別（高於 level），匹配才打印 -->
<ThresholdFilter level="INFO" onMatch="ACCEPT" onMismatch="DENY"/>
<!-- 打印日志的格式 -->
<PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss,SSS}:%4p %t (%F:%L) - %m%n"/>
</Console>
<!-- 定義一個日志輸入文件 RollingFile，按天或者超過 100M 分割會進行分割 -->
<RollingFile name="RollingFile" fileName="logs/trace.log"
append="true" filePattern="logs/$${date:yyyy-MM}/trace-%d{yyyy-MM-dd}-%i.log.gz">
<!-- 需要接收的日志的級別（高於 level） -->
<ThresholdFilter level="INFO" onMatch="ACCEPT" onMismatch="DENY"/>
<!-- 日志的格式 -->
<PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss,SSS}:%4p %t (%F:%L) - %m%n"/>
<Policies>
<TimeBasedTriggeringPolicy/>
<SizeBasedTriggeringPolicy size="100 MB"/>
</Policies>
</RollingFile>
<!-- 定義一個日志輸入文件 RollingErrorFile，按天或者超過 100M 分割會進行分割 -->
<RollingFile name="RollingErrorFile" fileName="logs/error.log"
append="true" filePattern="logs/$${date:yyyy-MM}/error-%d{yyyy-MM-dd}-%i.log.gz">
<!-- 需要接收的日志的級別（高於 level） -->
<ThresholdFilter level="WARN" onMatch="ACCEPT" onMismatch="DENY"/>
<!-- 日志的格式 -->
<PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss,SSS}:%4p %t (%F:%L) - %m%n"/>
<Policies>
<TimeBasedTriggeringPolicy/>
<SizeBasedTriggeringPolicy size="100 MB"/>
</Policies>
</RollingFile>
</appenders>
<loggers>
<!--過濾掉 Spring 和 Mybatis 的一些無用的 DEBUG 信息 -->
<logger name="org.springframework" level="INFO"/>
<logger name="org.mybatis" level="INFO"/>
<root level="INFO" includeLocation="true">
<appender-ref ref="Console"/>
<appender-ref ref="RollingFile"/>
<appender-ref ref="RollingErrorFile"/>
</root>
</loggers>
</configuration>
添加web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
version="3.0">
<display-name>Archetype Created Web Application</display-name>
<!-- Spring 和 MyBatis 的配置文件 -->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:spring-mybatis.xml</param-value>
</context-param>
<!-- 編碼過濾器，Spring 提供了 CharacterEncodingFilter 過濾器
這個過濾器就是針對於每次瀏覽器請求進行過濾的，然后再其之上添加了父類沒有的功能即處理字符編碼 -->
<filter>
<filter-name>encodingFilter</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
<async-supported>true</async-supported>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<init-param>
<param-name>forceEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<!-- 在容器（Tomcat、Jetty）啟動時會被 ContextLoaderListener 監聽到，從而調用其 contextInitialized() 方法，初始化 Root WebApplicationContext 容器 -->
<!-- 聲明 Spring Web 容器監聽器 -->
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<!-- 防止 Spring 內存溢出監聽器 -->
<listener>
<listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>
</listener>
<!-- 1.SpringMVC 配置 前置控制器（SpringMVC 的入口）
DispatcherServlet 是一個 Servlet，所以可以配置多個 DispatcherServlet -->
<servlet>
<!-- 在 DispatcherServlet 的初始化過程中，框架會在 web 應用 的 WEB-INF 文件夾下，
尋找名為 [servlet-name]-servlet.xml 的配置文件，生成文件中定義的 Bean. -->
<servlet-name>SpringMVC</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- 配置需要加載的配置文件 -->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:spring-mvc.xml</param-value>
</init-param>
<!-- 程序運行時從 web.xml 開始，加載順序為：context-param -> Listener -> Filter -> Structs -> Servlet
設置 web.xml 文件啟動時加載的順序(1 代表容器啟動時首先初始化該 Servlet，讓這個 Servlet 隨 Servlet 容器一起啟動)
load-on-startup 是指這個 Servlet 是在當前 web 應用被加載的時候就被創建，而不是第一次被請求的時候被創建 -->
<load-on-startup>1</load-on-startup>
<async-supported>true</async-supported>
</servlet>
<servlet-mapping>
<!-- 這個 Servlet 的名字是 SpringMVC，可以有多個 DispatcherServlet，是通過名字來區分的
每一個 DispatcherServlet 有自己的 WebApplicationContext 上下文對象，同時保存在 ServletContext 中和 Request 對象中
ApplicationContext（Spring 容器）是 Spring 的核心
Context 我們通常解釋為上下文環境，Spring 把 Bean 放在這個容器中，在需要的時候，可以 getBean 方法取出-->
<servlet-name>SpringMVC</servlet-name>
<!-- Servlet 攔截匹配規則，可選配置：*.do、*.action、*.html、/、/xxx/* ，不允許:/* -->
<url-pattern>/</url-pattern>
</servlet-mapping>
<welcome-file-list>
<!-- 瀏覽器輸入到項目名，默認打開如下配置頁面 -->
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
</web-app>
開始使用
Model類
tk.mybatis.simple.model.DbTest.java
package tk.mybatis.simple.model;
public class DbTest {
public Integer id;
public String text;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getText() {
return text;
}
public void setText(String text) {
this.text = text;
}
@Override
public String toString() {
return "DbTest{" +
"id=" + id +
", text='" + text + '\'' +
'}';
}
}
Mapper接口
tk.mybatis.simple.mapper.DbTestMapper
package tk.mybatis.simple.mapper;
import tk.mybatis.simple.model.DbTest;
public interface DbTestMapper {
DbTest queryById(Integer id);
}
XML映射文件
XML映射文件請放於Mapper接口所在路徑下，保證名稱相同
tk/mybatis/simple/mapper/DbTestMapper.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="tk.mybatis.simple.mapper.DbTestMapper">
<select id="queryById" parameterType="int" resultType="DbTest">
SELECT db_test_id AS id, db_test_text AS text
FROM db_test
WHERE db_test_id = #{id, jdbcType=INTEGER}
</select>
</mapper>
Controller類
package tk.mybatis.simple.controller;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.servlet.ModelAndView;
import tk.mybatis.simple.mapper.DbTestMapper;
import tk.mybatis.simple.model.DbTest;
@Controller
@RequestMapping(value = "/test")
public class DbTestController {
private static final Logger logger = LogManager.getLogger(DbTestController.class);
@Autowired
private DbTestMapper dbTestMapper;
@GetMapping("/")
public String index() {
return "welcome";
}
@GetMapping("/query")
public ModelAndView query(@RequestParam("id") Integer id) {
DbTest dbTest = dbTestMapper.queryById(id);
logger.info("入參：{}，查詢結果：{}", id, dbTest.toString());
ModelAndView mv = new ModelAndView();
mv.setViewName("result");
mv.addObject("test", dbTest);
return mv;
}
}
index.jsp
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>首頁</title>
</head>
<body>
<h3>Hello World!</h3>
<form method="get" action="<c:url value="/test/"/>">
<button class="btn btn-default" type="submit">
<span>開始測試</span>
</button>
</form>
</body>
</html>
welcome.jsp
<%--
Created by IntelliJ IDEA.
User: jingp
Date: 2019/6/5
Time: 15:17
To change this template use File | Settings | File Templates.
--%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>查詢</title>
</head>
<body>
<h3>查詢數據庫</h3>
<form method="get" action="<c:url value="/test/query"/>">
<div class="input-group">
<span class="input-group-addon">ID：</span>
<input type="number" name="id" class="form-control" required>
</div>
<button class="btn btn-default" type="submit">
<span>查詢</span>
</button>
</form>
<script src="../../static/jquery.min.js"></script>
</body>
</html>
result.jsp
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>結果</title>
</head>
<body>
<h4>查詢結果：${test.toString()}</h4>
<form method="post" action="<c:url value="/"/>">
<button class="btn btn-default" type="submit">
<span>退出</span>
</button>
</form>
<script src="../../static/jquery.min.js"></script>
</body>
</html>
運行程序
配置好Tomcat，然后啟動就可以了，進入頁面，點擊開始測試，然后查詢數據庫就可以通過MyBatis操作數據庫了
3.集成SpringBoot
引入依賴
<?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">
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.0.3.RELEASE</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<groupId>tk.mybatis.simple</groupId>
<artifactId>mybatis-spring-boot</artifactId>
<packaging>jar</packaging>
<properties>
<java.version>1.8</java.version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-bom</artifactId>
<version>2.13.3</version>
<scope>import</scope>
<type>pom</type>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<!-- Spring Boot 核心包，包括自動裝配，日志，以及YAML文件解析 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
<!-- 提供全棧的 WEB 開發特性，包括 Spring MVC 依賴和 Tomcat 容器 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 提供通用單元測試依賴，包括 JUnit, Hamcrest , Mockito -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<!-- lombok 工具 -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.16.22</version>
<scope>provided</scope>
</dependency>
<!-- MyBatis 相關 -->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.1.4</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.19</version>
</dependency>
<!-- druid 數據源-->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid-spring-boot-starter</artifactId>
<version>1.2.3</version>
</dependency>
<!-- pagehelper 分頁插件 -->
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper-spring-boot-starter</artifactId>
<version>1.3.0</version>
</dependency>
<!-- 日志文件管理包 -->
<!-- log4j2 start -->
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
</dependency>
<!-- 保證 web 應用正常清理 log 資源 -->
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-web</artifactId>
</dependency>
<dependency> <!-- 橋接：slf4j 到 log4j2 的橋梁 -->
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-slf4j-impl</artifactId>
</dependency>
<dependency> <!-- 后向兼容：log4j1.x 平滑升級到 log4j2 -->
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-1.2-api</artifactId>
</dependency>
<dependency> <!-- 橋接：commons-logging（jcl） 到 log4j2 的橋梁 -->
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-jcl</artifactId>
</dependency>
<!-- slf4j 日志切面，相當於一個適配器 -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.7</version>
</dependency>
<!-- 高性能並發編程框架 log4j2 使用 -->
<dependency>
<groupId>com.lmax</groupId>
<artifactId>disruptor</artifactId>
<version>3.4.2</version>
</dependency>
<!-- log4j2 end -->
<!-- JSON 工具 -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.54</version>
</dependency>
</dependencies>
<build>
<finalName>basic</finalName>
<!-- 配置相關插件 -->
<plugins>
<!-- appassembler-maven-plugin -->
<!-- mvn clean package appassembler:assemble -Dmaven.test.skip=true -Dmaven.javadoc.skip=true -->
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>appassembler-maven-plugin</artifactId>
<version>1.10</version>
<configuration>
<!-- 生成linux和windows兩種執行腳本 -->
<platforms>
<platform>unix</platform>
<platform>windows</platform>
</platforms>
<!-- jar存放的目錄 -->
<repositoryName>lib</repositoryName>
<!-- jar包存放在指定目錄的規則,默認是${groupId}/${artifactId}的目錄格式,flat表示直接把jar放到目錄下 -->
<repositoryLayout>flat</repositoryLayout>
<!-- 配置文件存放的目錄 -->
<configurationDirectory>conf</configurationDirectory>
<!-- copy配置文件到上面目錄 -->
<copyConfigurationDirectory>true</copyConfigurationDirectory>
<!-- 從哪里copy配置文件(默認src/main/config) -->
<configurationSourceDirectory>src/main/resources</configurationSourceDirectory>
<includeConfigurationDirectoryInClasspath>true</includeConfigurationDirectoryInClasspath>
<!-- ${project.build.directory}:target, 文件存放的根目錄 -->
<assembleDirectory>${project.build.directory}/basic-assemble</assembleDirectory>
<programs>
<program>
<!-- 啟動類 -->
<mainClass>com.fullmoon.study.Application</mainClass>
<!-- 生成的文件名稱：basic.sh -->
<id>basic</id>
<!-- 配置JVM參數 -->
<jvmSettings>
<extraArguments>
<!--<extraArgument>-server</extraArgument>-->
<extraArgument>-XX:+HeapDumpOnOutOfMemoryError</extraArgument>
<extraArgument>-XX:HeapDumpPath=/app/dump</extraArgument>
<extraArgument>-Xmx512m</extraArgument>
<extraArgument>-Xms512m</extraArgument>
</extraArguments>
</jvmSettings>
</program>
</programs>
</configuration>
</plugin>
<!-- 編譯插件 -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
</plugins>
<!-- 指定 resources -->
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>*.properties</include>
<include>*.xml</include>
<include>*.yml</include>
</includes>
<filtering>false</filtering>
</resource>
<resource>
<directory>src/main/resources/mapper</directory>
<targetPath>mapper/</targetPath>
<includes>
<include>*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
</resources>
</build>
</project>
添加mybatis-config.xml
MyBatis 的配置文件
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!-- plugins在配置文件中的位置必須符合要求，否則會報錯，順序如下: properties, settings, typeAliases, plugins,
objectFactory, objectWrapperFactory, reflectorFactory, environments, databaseIdProvider, typeHandlers, mappers -->
<!-- 配置mybatis的緩存，延遲加載等等一系列屬性 -->
<settings>
<!-- 全局的開啟或關閉配置文件中的所有映射器已經配置的任何緩存，關閉二級緩存，默認開啟 -->
<setting name="cacheEnabled" value="false" />
<!-- 開啟一級緩存，緩存級別為SESSION（默認），如果緩存級別為STATEMENT將不會再同一個SqlSession中緩存 -->
<setting name="localCacheScope" value="STATEMENT" />
<!-- 通過resultMap標簽內的association標簽可使用延遲加載 -->
<!-- 查詢時，關閉關聯對象即時加載以提高性能，開啟延遲加載，默認關閉，關閉表示直接加載，查詢時就進行關聯查詢 -->
<setting name="lazyLoadingEnabled" value="true" />
<!-- 設置關聯對象加載的形態，關閉侵入式延遲加載，在訪問主對象時不進行查詢關聯對象，而是在真正訪問關聯對象時才進行關聯查詢，以提高性能 -->
<!-- 3.4.1及之前的版本默認為開啟，表示查詢時不進行關聯查詢，訪問主對象時才進行關聯查詢 -->
<setting name="aggressiveLazyLoading" value="false" />
<!-- 允許使用列標簽代替列名 -->
<setting name="useColumnLabel" value="true" />
<!-- 不允許使用自定義的主鍵值(比如由程序生成的UUID 32位編碼作為鍵值)，數據表的PK生成策略將被覆蓋 -->
<setting name="useGeneratedKeys" value="false" />
<!-- 是否開啟自動駝峰命名規則（camel case）映射，即從經典數據庫列名A_COLUMN到經典Java屬性名aColumn的類似映射 -->
<setting name="mapUnderscoreToCamelCase" value="true" />
</settings>
</configuration>
添加application.yml
Spring Boot 的配置文件
server:
port: 9092
servlet:
context-path: /mybatis-spring-boot-demo
tomcat:
accept-count: 200
min-spare-threads: 200
spring:
application:
name: mybatis-spring-boot-demo
profiles:
active: test
servlet:
multipart:
max-file-size: 100MB
max-request-size: 100MB
datasource:
type: com.alibaba.druid.pool.DruidDataSource
druid:
driver-class-name: com.mysql.cj.jdbc.Driver # 不配置則會根據 url 自動識別
initial-size: 5 # 初始化時建立物理連接的個數
min-idle: 20 # 最小連接池數量
max-active: 20 # 最大連接池數量
max-wait: 10000 # 獲取連接時最大等待時間，單位毫秒
validation-query: SELECT 1 # 用來檢測連接是否有效的 sql
test-while-idle: true # 申請連接的時候檢測，如果空閑時間大於 timeBetweenEvictionRunsMillis，則執行 validationQuery 檢測連接是否有效
test-on-borrow: false # 申請連接時執行 validationQuery 檢測連接是否有效
min-evictable-idle-time-millis: 120000 # 連接保持空閑而不被驅逐的最小時間，單位是毫秒
time-between-eviction-runs-millis: 3600000 # 配置間隔多久才進行一次檢測，檢測需要關閉的空閑連接，單位是毫秒
filters: stat,log4j,wall # 配置過濾器，stat-監控統計，log4j-日志，wall-防御 SQL 注入
connection-properties: 'druid.stat.mergeSql=true;druid.stat.slowSqlMillis=5000' # StatFilter配置，打開合並 SQL 功能和慢 SQL 記錄
web-stat-filter: # WebStatFilter 配置
enabled: true
url-pattern: '/*'
exclusions: '*.js,*.gif,*.jpg,*.bmp,*.png,*.css,*.ico,/druid/*'
stat-view-servlet: # StatViewServlet 配置
enabled: true
url-pattern: '/druid/*'
reset-enable: false
login-username: druid
login-password: druid
aop-patterns: 'com.fullmoon.study.service.*' # Spring 監控配置
mybatis:
type-aliases-package: tk.mybatis.simple.model
mapper-locations: classpath:mapper/*.xml
config-location: classpath:mybatis-config.xml
pagehelper:
helper-dialect: mysql
reasonable: true # 分頁合理化參數
offset-as-page-num: true # 將 RowBounds 中的 offset 參數當成 pageNum 使用
supportMethodsArguments: true # 支持通過 Mapper 接口參數來傳遞分頁參數
# 測試環境
---
spring:
profiles: test
datasource:
druid:
url: jdbc:mysql://127.0.0.1:3306/test?useUnicode=true&characterEncoding=utf8
username: root
password: password
注意上面 mybatis 的相關配置，XML 映射文件是存放於 classpath 下的 mapper 文件夾下面的
添加log4j2.xml
<?xml version="1.0" encoding="UTF-8"?>
<configuration status="INFO" monitorInterval="30">
<appenders>
<!-- 參考官方地址：https://logging.apache.org/log4j/2.x/ -->
<!-- 這個輸出控制台的配置 -->
<Console name="Console" target="SYSTEM_OUT">
<!-- 設置輸出日志級別（高於 level），匹配才打印 -->
<ThresholdFilter level="INFO" onMatch="ACCEPT" onMismatch="DENY"/>
<!-- 打印日志的格式 -->
<PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss,SSS}:%4p %t (%F:%L) - %m%n"/>
</Console>
<!-- 定義一個日志輸入文件 RollingFile，按天或者超過 100M 分割會進行分割 -->
<RollingFile name="RollingFile" fileName="logs/trace.log"
append="true" filePattern="logs/$${date:yyyy-MM}/trace-%d{yyyy-MM-dd}-%i.log.gz">
<!-- 需要接收的日志的級別（高於 level） -->
<ThresholdFilter level="INFO" onMatch="ACCEPT" onMismatch="DENY"/>
<!-- 日志的格式 -->
<PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss,SSS}:%4p %t (%F:%L) - %m%n"/>
<Policies>
<TimeBasedTriggeringPolicy/>
<SizeBasedTriggeringPolicy size="100 MB"/>
</Policies>
</RollingFile>
<!-- 定義一個日志輸入文件 RollingErrorFile，按天或者超過 100M 分割會進行分割 -->
<RollingFile name="RollingErrorFile" fileName="logs/error.log"
append="true" filePattern="logs/$${date:yyyy-MM}/error-%d{yyyy-MM-dd}-%i.log.gz">
<!-- 需要接收的日志的級別（高於 level） -->
<ThresholdFilter level="WARN" onMatch="ACCEPT" onMismatch="DENY"/>
<!-- 日志的格式 -->
<PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss,SSS}:%4p %t (%F:%L) - %m%n"/>
<Policies>
<TimeBasedTriggeringPolicy/>
<SizeBasedTriggeringPolicy size="100 MB"/>
</Policies>
</RollingFile>
</appenders>
<loggers>
<!--過濾掉 Spring 和 Mybatis 的一些無用的 DEBUG 信息 -->
<logger name="org.springframework" level="INFO"/>
<logger name="org.mybatis" level="INFO"/>
<root level="INFO" includeLocation="true">
<appender-ref ref="Console"/>
<appender-ref ref="RollingFile"/>
<appender-ref ref="RollingErrorFile"/>
</root>
</loggers>
</configuration>
開始使用
在 Spring Boot 項目的啟動類上面添加 @MapperScan("tk.mybatis.simple.mapper") 注解，指定 Mapper 接口所在的包路徑，啟動類如下：
@SpringBootApplication
@EnableTransactionManagement
@MapperScan("tk.mybatis.simple.mapper")
public class Application {
public static void main(String[] args){
SpringApplication.run(Application.class, args);
}
}
然后在 classpath 下的 mapper 文件夾（根據 application.yml 配置文件中的定義）添加 XML 映射文件，即可開始使用 MyBatis了
其中 @EnableTransactionManagement 注解表示開啟事務的支持（@SpringBootApplication 注解在加載容器的時候已經開啟事務管理的功能了，也可不需要添加該注解）
在需要事務的方法或者類上面添加 @Transactional 注解即可，引入spring-boot-starter-jdbc依賴，注入的是 DataSourceTransactionManager 事務管理器，事務的使用示例如下：
@Transactional(propagation = Propagation.REQUIRED, rollbackFor = Exception.class)
public int insertFeedback(UserFeedbackInfo requestAddParam) {
try {
// ... 業務邏輯
} catch (Exception e) {
// 事務回滾
TransactionAspectSupport.currentTransactionStatus().setRollbackOnly();
return 0;
}
}
4.SpringBoot配置數據庫密碼加密？
4.1 借助Druid數據源
Druid 數據源支持數據庫密碼進行加密，在 Spring Boot 中配置方式如下：
加密數據庫密碼，通過 Druid 的 com.alibaba.druid.filter.config.ConfigTools 工具類對數據庫密碼進行加密（RSA 算法），如下：
public static void main(String[] args) throws Exception {
ConfigTools.main(new String[]{"you_password"});
}
或者執行以下命令：
java -cp druid-1.0.16.jar com.alibaba.druid.filter.config.ConfigTools you_password
輸出：
privateKey:MIIBVgIBADANBgkqhkiG9w0BAQEFAASCAUAwggE8AgEAAkEA6+4avFnQKP+O7bu5YnxWoOZjv3no4aFV558HTPDoXs6EGD0HP7RzzhGPOKmpLQ1BbA5viSht+aDdaxXp6SvtMQIDAQABAkAeQt4fBo4SlCTrDUcMANLDtIlax/I87oqsONOg5M2JS0jNSbZuAXDv7/YEGEtMKuIESBZh7pvVG8FV531/fyOZAiEA+POkE+QwVbUfGyeugR6IGvnt4yeOwkC3bUoATScsN98CIQDynBXC8YngDNwZ62QPX+ONpqCel6g8NO9VKC+ETaS87wIhAKRouxZL38PqfqV/WlZ5ZGd0YS9gA360IK8zbOmHEkO/AiEAsES3iuvzQNYXFL3x9Tm2GzT1fkSx9wx+12BbJcVD7AECIQCD3Tv9S+AgRhQoNcuaSDNluVrL/B/wOmJRLqaOVJLQGg==
publicKey:MFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBAOvuGrxZ0Cj/ju27uWJ8VqDmY7956OGhVeefB0zw6F7OhBg9Bz+0c84RjzipqS0NQWwOb4kobfmg3WsV6ekr7TECAwEAAQ==
password:PNak4Yui0+2Ft6JSoKBsgNPl+A033rdLhFw+L0np1o+HDRrCo9VkCuiiXviEMYwUgpHZUFxb2FpE0YmSguuRww==
然后在 application.yml 中添加以下配置：
spring:
datasource:
druid:
password: ${password} # 加密后的數據庫密碼
filters: config # 配置 ConfigFilter ，通過它進行解密
# 提示需要對數據庫密碼進行解密
connection-properties: 'config.decrypt=true;config.decrypt.key=${publickey}'
publicKey: MFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBAJvQUB7pExzbzTpaQCCY5qS+86MgYWvRpqPUCzjFwdMgrBjERE5X5oojSe48IGZ6UtCCeaI0PdhkFoNaJednaqMCAwEAAQ==
這樣就OK了，主要是在 ConfigFilter 過濾器中，會先對密碼進行解密，然后再設置到 DataSource 數據源
4.2 借助Jasypt加密包
Jasypt是一個 Java 庫，可以讓開發人員將基本的加密功能添加到項目中，而無需對加密的工作原理有深入的了解
接下來講述的在 Spring Boot 項目中如何使用Jasypt，其他使用方法請參考Jasypt Github地址
引入依賴
<!-- jasypt 加密工具，https://github.com/ulisesbocchio/jasypt-spring-boot -->
<dependency>
<groupId>com.github.ulisesbocchio</groupId>
<artifactId>jasypt-spring-boot-starter</artifactId>
<version>3.0.3</version>
</dependency>
添加注解
在啟動類上面添加@EnableEncryptableProperties注解，使整個 Spring 環境啟用 Jasypt 加密功能，如下：
@SpringBootApplication
@EnableEncryptableProperties
public class Application {
public static void main(String[] args){
SpringApplication.run(Application.class, args);
}
}
獲取密文
需要通過 Jasypt 官方提供的 jar 包進行加密，如下：
import com.ulisesbocchio.jasyptspringboot.properties.JasyptEncryptorConfigurationProperties;
import org.jasypt.encryption.pbe.PooledPBEStringEncryptor;
import org.jasypt.encryption.pbe.config.PBEConfig;
import org.jasypt.encryption.pbe.config.SimpleStringPBEConfig;
/**
* @author jingping.liu
* @date 2020-11-20
* @description Jasypt 安全框架加密類工具包
*/
public class JasyptUtils {
/**
* 生成一個 {@link PBEConfig} 配置對象
* <p>
* 注意！！！
* 可查看 Jasypt 全局配置對象 {@link JasyptEncryptorConfigurationProperties} 中的默認值
* 這里的配置建議與默認值保持一致，否則需要在 application.yml 中定義這里的配置（也可以通過 JVM 參數的方法）
* 注意 password 和 algorithm 配置項，如果不一致在啟動時可能會解密失敗而報錯
*
* @param salt 鹽值
* @return SimpleStringPBEConfig 加密配置
*/
private static SimpleStringPBEConfig generatePBEConfig(String salt) {
SimpleStringPBEConfig config = new SimpleStringPBEConfig();
// 設置 salt 鹽值
config.setPassword(salt);
// 設置要創建的加密程序池的大小，這里僅臨時創建一個，設置 1 即可
config.setPoolSize("1");
// 設置加密算法， 此算法必須由 JCE 提供程序支持，默認值 PBEWITHHMACSHA512ANDAES_256
config.setAlgorithm("PBEWithMD5AndDES");
// 設置應用於獲取加密密鑰的哈希迭代次數
config.setKeyObtentionIterations("1000");
// 設置要請求加密算法的安全提供程序的名稱
config.setProviderName("SunJCE");
// 設置 salt 鹽的生成器
config.setSaltGeneratorClassName("org.jasypt.salt.RandomSaltGenerator");
// 設置 IV 生成器
config.setIvGeneratorClassName("org.jasypt.iv.RandomIvGenerator");
// 設置字符串輸出的編碼形式，支持 base64 和 hexadecimal
config.setStringOutputType("base64");
return config;
}
/**
* 通過 {@link PooledPBEStringEncryptor} 進行加密密
*
* @param salt 鹽值
* @param message 需要加密的內容
* @return 加密后的內容
*/
public static String encrypt(String salt, String message) {
PooledPBEStringEncryptor encryptor = new PooledPBEStringEncryptor();
SimpleStringPBEConfig pbeConfig = generatePBEConfig(salt);
// 生成加密配置
encryptor.setConfig(pbeConfig);
System.out.println("----ARGUMENTS-------------------");
System.out.println("message: " + message);
System.out.println("salt: " + pbeConfig.getPassword());
System.out.println("algorithm: " + pbeConfig.getAlgorithm());
System.out.println("stringOutputType: " + pbeConfig.getStringOutputType());
// 進行加密
String cipherText = encryptor.encrypt(message);
System.out.println("----OUTPUT-------------------");
System.out.println(cipherText);
return cipherText;
}
public static String decrypt(String salt, String message) {
PooledPBEStringEncryptor encryptor = new PooledPBEStringEncryptor();
// 設置解密配置
encryptor.setConfig(generatePBEConfig(salt));
// 進行解密
return encryptor.decrypt(message);
}
public static void main(String[] args) {
// 隨機生成一個 salt 鹽值
String salt = UUID.randomUUID().toString().replace("-", "");
// 進行加密
encrypt(salt, "message");
}
}
如何使用
直接在 application.yml 配置文件中添加 Jasypt 配置和生成的密文
jasypt:
encryptor:
password: salt # salt 鹽值，需要和加密時使用的 salt 一致
algorithm: PBEWithMD5AndDES # 加密算法，需要和加密時使用的算法一致
string-output-type: hexadecimal # 密文格式，，需要和加密時使用的輸出格式一致
spring:
datasource:
druid:
username: root
password: ENC(cipherText) # Jasypt 密文格式：ENC(密文)
salt 鹽值也可以通過 JVM 參數進行設置，例如：-Djasypt.encryptor.password=salt
啟動后，Jasypt 會先根據配置將 ENC(密文) 進行解密，然后設置到 Spring 環境中
5.如何配置動態數據源？
你在使用 MyBatis 的過程中，是否有想過多個數據源應該如何配置，如何去實現？出於這個好奇心，我在 Druid Wiki 的數據庫多數據源中知曉 Spring 提供了對多數據源的支持，基於 Spring 提供的 AbstractRoutingDataSource，自己實現數據源的切換，下面就如何配置動態數據源提供一個簡單的實現
org.springframework.jdbc.datasource.lookup.AbstractRoutingDataSource，代碼如下：
public abstract class AbstractRoutingDataSource extends AbstractDataSource implements InitializingBean {
@Nullable
private Object defaultTargetDataSource;
@Nullable
private Map<Object, DataSource> resolvedDataSources;
@Nullable
private DataSource resolvedDefaultDataSource;
@Override
public Connection getConnection() throws SQLException {
return determineTargetDataSource().getConnection();
}
@Override
public Connection getConnection(String username, String password) throws SQLException {
return determineTargetDataSource().getConnection(username, password);
}
protected DataSource determineTargetDataSource() {
Assert.notNull(this.resolvedDataSources, "DataSource router not initialized");
// 確定當前要使用的數據源
Object lookupKey = determineCurrentLookupKey();
DataSource dataSource = this.resolvedDataSources.get(lookupKey);
if (dataSource == null && (this.lenientFallback || lookupKey == null)) {
dataSource = this.resolvedDefaultDataSource;
}
if (dataSource == null) {
throw new IllegalStateException("Cannot determine target DataSource for lookup key [" + lookupKey + "]");
}
return dataSource;
}
/**
* Determine the current lookup key. This will typically be implemented to check a thread-bound transaction context.
* <p>
* Allows for arbitrary keys. The returned key needs to match the stored lookup key type, as resolved by the
* {@link #resolveSpecifiedLookupKey} method.
*/
@Nullable
protected abstract Object determineCurrentLookupKey();
// 省略相關代碼...
}
重寫 AbstractRoutingDataSource 的 determineCurrentLookupKey() 方法，可以實現對多數據源的支持
思路：
- 重寫其 determineCurrentLookupKey() 方法，支持選擇不同的數據源
- 初始化多個 DataSource 數據源到 AbstractRoutingDataSource 的 resolvedDataSources 屬性中
- 然后通過 Spring AOP， 以自定義注解作為切點，根據不同的數據源的 Key 值，設置當前線程使用的數據源
接下來的實現方式是 Spring Boot 結合 Druid 配置動態數據源
引入依賴
基於 3.繼承SpringBoot 中已添加的依賴再添加對AOP支持的依賴，如下：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-aop</artifactId>
</dependency>
開始實現
DataSourceContextHolder
使用 ThreadLocal 存儲當前線程指定的數據源的 Key 值，代碼如下：
@Log4j2
public class DataSourceContextHolder {
/**
* 線程本地變量
*/
private static final ThreadLocal<String> DATASOURCE_KEY = new ThreadLocal<>();
/**
* 配置的所有數據源的 Key 值
*/
public static Set<Object> ALL_DATASOURCE_KEY = new HashSet<>();
/**
* 設置當前線程的數據源的 Key
*
* @param dataSourceKey 數據源的 Key 值
*/
public static void setDataSourceKey(String dataSourceKey) {
if (ALL_DATASOURCE_KEY.contains(dataSourceKey)) {
DATASOURCE_KEY.set(dataSourceKey);
} else {
log.warn("the datasource [{}] does not exist", dataSourceKey);
}
}
/**
* 獲取當前線程的數據源的 Key 值
*
* @return 數據源的 Key 值
*/
public static String getDataSourceKey() {
return DATASOURCE_KEY.get();
}
/**
* 移除當前線程持有的數據源的 Key 值
*/
public static void clear() {
DATASOURCE_KEY.remove();
}
}
MultipleDataSource
重寫其 AbstractRoutingDataSource 的 determineCurrentLookupKey() 方法，代碼如下：
public class MultipleDataSource extends AbstractRoutingDataSource {
/**
* 返回當前線程是有的數據源的 Key
*
* @return dataSourceKey
*/
@Override
protected Object determineCurrentLookupKey() {
return DataSourceContextHolder.getDataSourceKey();
}
}
@TargetDataSource注解
自定義注解，用於 Spring AOP 通過其設置當前需要使用的數據源，代碼如下：
/**
* @description 數據源注解，可以用於 Method, Class, interface (including annotation type), or enum declaration
*/
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.TYPE})
public @interface TargetDataSource {
/**
* 指定數據源 {@link DataSourceContextHolder}
*
* @return 數據源的 Key 值
*/
String value() default "master";
}
DataSourceAspect切面
使用 Spring AOP 功能，定義一個切面，用於設置當前需要使用的數據源，代碼如下：
@Aspect
@Component
@Log4j2
public class DataSourceAspect {
@Before("@annotation(com.fullmoon.study.datasource.annotation.TargetDataSource)")
public void before(JoinPoint joinPoint) {
MethodSignature methodSignature = (MethodSignature) joinPoint.getSignature();
Method method = methodSignature.getMethod();
if (method.isAnnotationPresent(TargetDataSource.class)) {
TargetDataSource targetDataSource = method.getAnnotation(TargetDataSource.class);
DataSourceContextHolder.setDataSourceKey(targetDataSource.value());
log.info("set the datasource of the current thread to [{}]", targetDataSource.value());
} else if (joinPoint.getTarget().getClass().isAnnotationPresent(TargetDataSource.class)) {
TargetDataSource targetDataSource = joinPoint.getTarget().getClass().getAnnotation(TargetDataSource.class);
DataSourceContextHolder.setDataSourceKey(targetDataSource.value());
log.info("set the datasource of the current thread to [{}]", targetDataSource.value());
}
}
@After("@annotation(com.fullmoon.study.datasource.annotation.TargetDataSource)")
public void after() {
DataSourceContextHolder.clear();
log.info("clear the datasource of the current thread");
}
}
DruidConfig
Druid 配置類，代碼如下：
@Configuration
public class DruidConfig {
@Bean
public ServletRegistrationBean<StatViewServlet> statViewServlet() {
ServletRegistrationBean<StatViewServlet> servletRegistrationBean = new ServletRegistrationBean<>();
servletRegistrationBean.setServlet(new StatViewServlet());
servletRegistrationBean.addUrlMappings("/druid/*");
Map<String, String> initParameters = new HashMap<>(16);
// 禁用HTML頁面上的Reset All功能
initParameters.put("resetEnable", "false");
// IP白名單 (沒有配置或者為空，則允許所有訪問，同一IP共存於deny時，deny優先於allow處理)
initParameters.put("allow", "");
// druid監控頁面登錄用戶名
initParameters.put("loginUsername", "druid");
// druid監控頁面登錄密碼
initParameters.put("loginPassword", "druid");
servletRegistrationBean.setInitParameters(initParameters);
return servletRegistrationBean;
}
@Bean
public FilterRegistrationBean<WebStatFilter> webStatFilter() {
FilterRegistrationBean<WebStatFilter> filterRegistrationBean = new FilterRegistrationBean<>();
filterRegistrationBean.setFilter(new WebStatFilter());
filterRegistrationBean.addUrlPatterns("/*");
filterRegistrationBean.addInitParameter("exclusions", "*.js,*.gif,*.jpg,*.bmp,*.png,*.css,*.ico,/druid/*");
return filterRegistrationBean;
}
@Bean(value = "druid-stat-interceptor")
public DruidStatInterceptor druidStatInterceptor() {
return new DruidStatInterceptor();
}
@Bean
public BeanNameAutoProxyCreator beanNameAutoProxyCreator() {
BeanNameAutoProxyCreator beanNameAutoProxyCreator = new BeanNameAutoProxyCreator();
beanNameAutoProxyCreator.setProxyTargetClass(true);
// 設置要監控的bean的id
beanNameAutoProxyCreator.setInterceptorNames("druid-stat-interceptor");
return beanNameAutoProxyCreator;
}
}
MultipleDataSourceConfig
MyBatis 的配置類，配置了 2 個數據源，代碼如下：
@Configuration
@EnableConfigurationProperties({MybatisProperties.class})
public class MultipleDataSourceConfig {
private final MybatisProperties properties;
private final Interceptor[] interceptors;
private final TypeHandler[] typeHandlers;
private final LanguageDriver[] languageDrivers;
private final ResourceLoader resourceLoader;
private final DatabaseIdProvider databaseIdProvider;
private final List<ConfigurationCustomizer> configurationCustomizers;
public MultipleDataSourceConfig(MybatisProperties properties, ObjectProvider<Interceptor[]> interceptorsProvider, ObjectProvider<TypeHandler[]> typeHandlersProvider, ObjectProvider<LanguageDriver[]> languageDriversProvider, ResourceLoader resourceLoader, ObjectProvider<DatabaseIdProvider> databaseIdProvider, ObjectProvider<List<ConfigurationCustomizer>> configurationCustomizersProvider) {
this.properties = properties;
this.interceptors = (Interceptor[]) interceptorsProvider.getIfAvailable();
this.typeHandlers = (TypeHandler[]) typeHandlersProvider.getIfAvailable();
this.languageDrivers = (LanguageDriver[]) languageDriversProvider.getIfAvailable();
this.resourceLoader = resourceLoader;
this.databaseIdProvider = (DatabaseIdProvider) databaseIdProvider.getIfAvailable();
this.configurationCustomizers = (List) configurationCustomizersProvider.getIfAvailable();
}
@Bean(name = "master", initMethod = "init", destroyMethod = "close")
@ConfigurationProperties(prefix = "spring.datasource.druid.master")
public DruidDataSource master() {
return DruidDataSourceBuilder.create().build();
}
@Bean(name = "slave", initMethod = "init", destroyMethod = "close")
@ConfigurationProperties(prefix = "spring.datasource.druid.slave")
public DruidDataSource slave() {
return DruidDataSourceBuilder.create().build();
}
@Bean(name = "dynamicDataSource")
public DataSource dynamicDataSource() {
MultipleDataSource dynamicRoutingDataSource = new MultipleDataSource();
Map<Object, Object> dataSources = new HashMap<>();
dataSources.put("master", master());
dataSources.put("slave", slave());
dynamicRoutingDataSource.setDefaultTargetDataSource(master());
dynamicRoutingDataSource.setTargetDataSources(dataSources);
DataSourceContextHolder.ALL_DATASOURCE_KEY.addAll(dataSources.keySet());
return dynamicRoutingDataSource;
}
@Bean
public SqlSessionFactory sqlSessionFactory() throws Exception {
SqlSessionFactoryBean factory = new SqlSessionFactoryBean();
factory.setDataSource(dynamicDataSource());
factory.setVfs(SpringBootVFS.class);
if (StringUtils.hasText(this.properties.getConfigLocation())) {
factory.setConfigLocation(this.resourceLoader.getResource(this.properties.getConfigLocation()));
}
this.applyConfiguration(factory);
if (this.properties.getConfigurationProperties() != null) {
factory.setConfigurationProperties(this.properties.getConfigurationProperties());
}
if (!ObjectUtils.isEmpty(this.interceptors)) {
factory.setPlugins(this.interceptors);
}
if (this.databaseIdProvider != null) {
factory.setDatabaseIdProvider(this.databaseIdProvider);
}
if (StringUtils.hasLength(this.properties.getTypeAliasesPackage())) {
factory.setTypeAliasesPackage(this.properties.getTypeAliasesPackage());
}
if (this.properties.getTypeAliasesSuperType() != null) {
factory.setTypeAliasesSuperType(this.properties.getTypeAliasesSuperType());
}
if (StringUtils.hasLength(this.properties.getTypeHandlersPackage())) {
factory.setTypeHandlersPackage(this.properties.getTypeHandlersPackage());
}
if (!ObjectUtils.isEmpty(this.typeHandlers)) {
factory.setTypeHandlers(this.typeHandlers);
}
if (!ObjectUtils.isEmpty(this.properties.resolveMapperLocations())) {
factory.setMapperLocations(this.properties.resolveMapperLocations());
}
Set<String> factoryPropertyNames = (Set) Stream.of((new BeanWrapperImpl(SqlSessionFactoryBean.class)).getPropertyDescriptors()).map(FeatureDescriptor::getName).collect(Collectors.toSet());
Class<? extends LanguageDriver> defaultLanguageDriver = this.properties.getDefaultScriptingLanguageDriver();
if (factoryPropertyNames.contains("scriptingLanguageDrivers") && !ObjectUtils.isEmpty(this.languageDrivers)) {
factory.setScriptingLanguageDrivers(this.languageDrivers);
if (defaultLanguageDriver == null && this.languageDrivers.length == 1) {
defaultLanguageDriver = this.languageDrivers[0].getClass();
}
}
if (factoryPropertyNames.contains("defaultScriptingLanguageDriver")) {
factory.setDefaultScriptingLanguageDriver(defaultLanguageDriver);
}
return factory.getObject();
}
private void applyConfiguration(SqlSessionFactoryBean factory) {
org.apache.ibatis.session.Configuration configuration = this.properties.getConfiguration();
if (configuration == null && !StringUtils.hasText(this.properties.getConfigLocation())) {
configuration = new org.apache.ibatis.session.Configuration();
}
if (configuration != null && !CollectionUtils.isEmpty(this.configurationCustomizers)) {
Iterator var3 = this.configurationCustomizers.iterator();
while (var3.hasNext()) {
ConfigurationCustomizer customizer = (ConfigurationCustomizer) var3.next();
customizer.customize(configuration);
}
}
factory.setConfiguration(configuration);
}
@Bean
public SqlSessionTemplate sqlSessionTemplate(SqlSessionFactory sqlSessionFactory) {
ExecutorType executorType = this.properties.getExecutorType();
return executorType != null ? new SqlSessionTemplate(sqlSessionFactory, executorType) : new SqlSessionTemplate(sqlSessionFactory);
}
@Bean
public PlatformTransactionManager masterTransactionManager() {
// 配置事務管理器
return new DataSourceTransactionManager(dynamicDataSource());
}
}
-
定義了兩個數據源，配置的前綴分別為
spring.datasource.druid.master和spring.datasource.druid.slave，對應master和slave兩個 DruidDataSource 數據源 -
還有一個自定義的
MultipleDataSource動態數據源，添加上面兩個數據源到其中，並設置默認數據源為master -
其中 SqlSessionFactory 和 SqlSessionTemplate 的創建，借鑒了
mybatis-spring-boot-starter的org.mybatis.spring.boot.autoconfigure.MybatisAutoConfiguration自動配置類（直接抄過來的😄），在初始化 SqlSessionFactory 時，設置的數據源就是上面定義的 MultipleDataSource 動態數據源 -
另外還為 MultipleDataSource 動態數據源定義了一個事務管理器
DataSourceTransactionManager
添加配置
server:
port: 8099
servlet:
context-path: /dynamic-datasource
spring:
application:
name: dynamic-datasource
datasource:
type: com.alibaba.druid.pool.DruidDataSource
druid:
master:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://192.250.110.158:3306/gsfy_user?useUnicode=true&characterEncoding=utf8
username: root
password: admin@951753
initial-size: 5 # 初始化時建立物理連接的個數
min-idle: 20 # 最小連接池數量
max-active: 20 # 最大連接池數量
slave:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://192.250.110.157:3306/level2?useUnicode=true&characterEncoding=utf8
username: dev
password: nfeb?4rfv
initial-size: 5 # 初始化時建立物理連接的個數
min-idle: 20 # 最小連接池數量
max-active: 20 # 最大連接池數量
mybatis:
type-aliases-package: com.fullmoon.study.model
mapper-locations: classpath:mapper/*.xml
config-location: classpath:mybatis-config.xml
pagehelper:
helper-dialect: mysql
reasonable: true # 分頁合理化參數
offset-as-page-num: true # 將 RowBounds 中的 offset 參數當成 pageNum 使用
supportMethodsArguments: true # 支持通過 Mapper 接口參數來傳遞分頁參數
其中分別定義了 master 和 slave 數據源的相關配置
這樣一來，在 DataSourceAspect 切面中根據自定義注解，設置 DataSourceContextHolder 當前線程所使用的數據源的 Key 值，MultipleDataSource 動態數據源則會根據該值設置需要使用的數據源，完成了動態數據源的切換
使用示例
在 Mapper 接口上面添加自定義注解 @TargetDataSource，如下：
@Repository
public interface UserMapper {
User queryUser(Integer id);
int insertUser(User user);
@TargetDataSource("slave")
Addr queryAddr(Integer id);
@TargetDataSource("slave")
int insertAddr(Addr addr);
}
上面兩個方法使用 master 數據源，下面兩個方法使用 slave 數據源
總結
上面就如何配置動態數據源的實現方式僅提供一種思路，其中關於多事務方面並沒有實現，采用 Spring 提供的事務管理器，如果同一個方法中使用了多個數據源，並不支持多事務的，需要自己去實現（筆者能力有限），可以整合JAT組件，參考：SpringBoot2 整合JTA組件多數據源事務管理
分布式事務解決方案推薦使用 Seata 分布式服務框架
動態多數據源推薦使用： 一個基於SpringBoot的動態多數據源組件