MyBatis配置檔案分析
配置檔案
MyBatis 的配置檔案包含了會深深影響 MyBatis 行為的設定和屬性資訊。 配置文件的頂層結構如下:
- configuration(配置)
- properties(屬性)
- settings(設定)
- typeAliases(類型別名)
- typeHandlers(型別處理器)
- objectFactory(物件工廠)
- plugins(外掛)
- environments(環境配置)
environment(環境變數) transactionManager(事務管理器) dataSource(資料來源) - databaseIdProvider(資料庫廠商標識)
- mappers(對映器)
這是來自mybatis官方的配置檔案結構
mybatis配置檔案會影響整個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>
<!-- 環境配置 default設定當前使用哪個環境配置 -->
<environments default="development">
<!-- 環境配置 id:環境的標識-->
<environment id="development">
<!-- 事務管理器 預設jdbc-->
<transactionManager type="JDBC"/>
<!-- 資料來源 預設是資料池連線方式-->
< dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis?serverTimezone=GMT%2B8&useUnicode=true&characterEncode=UTF-8"/>
<property name="username" value="root"/>
<property name="password" value="ssf123123"/>
</dataSource>
</environment>
</environments>
<!-- mapper對映器-->
<mappers>
<mapper resource="com/arctic/dao/UserMapper.xml"/>
</mappers>
</configuration>
環境配置(environments)
MyBatis 可以配置成適應多種環境
不過要記住:儘管可以配置多個環境,但每個 SqlSessionFactory 例項只能選擇一種環境。
學會使用配置多套執行環境!
Mybatis預設的事務管理器就是 JDBC , 連線池 : POOLED
屬性(properties)
這些屬性可以在外部進行配置,並可以進行動態替換。你既可以在典型的 Java 屬性檔案中配置這些屬性,也可以在 properties 元素的子元素中設定。例如:
<properties resource="org/mybatis/example/config.properties">
<property name="username" value="dev_user"/>
<property name="password" value="F2Fa3!33TYyg"/>
</properties>
設定好的屬性可以在整個配置檔案中用來替換需要動態配置的屬性值。比如:
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
這個例子中的 username 和 password 將會由 properties 元素中設定的相應值來替換。 driver 和 url 屬性將會由 config.properties 檔案中對應的值來替換。這樣就為配置提供了諸多靈活選擇。
這是來自官方文件中的例子這告訴我們屬性的值是可以動態替換的。
我們現在resources資料夾下新建db.properties
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?serverTimezone=GMT%2B8&useUnicode=true&characterEncode=UTF-8
username=root
password=ssf123123
然後修改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>
<properties resource="db.properties"/>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url"
value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/arctic/dao/UserMapper.xml"/>
</mappers>
</configuration>
這裡需要注意配置檔案標籤的順序
注意:
- 可以直接引入外部檔案
- 可以在其中增加一些屬性配置
- 如果兩個檔案有同一個欄位,優先使用外部配置檔案的!
類型別名(typeAliases)
- 類型別名是為 Java 型別設定一個短的名字。‘
- 存在的意義僅在於用來減少類完全限定名的冗餘。
<!--可以給實體類起別名-->
<typeAliases>
<typeAlias type="com.kuang.pojo.User" alias="User"/>
</typeAliases>
也可以指定一個包名,MyBatis 會在包名下面搜尋需要的 Java Bean,比如:
掃描實體類的包,它的預設別名就為這個類的 類名,首字母小寫!
<!--可以給實體類起別名-->
<typeAliases>
<package name="com.kuang.pojo"/>
</typeAliases>
在實體類比較少的時候,使用第一種方式。
如果實體類十分多,建議使用第二種。
第一種可以DIY別名,第二種則·不行·,如果非要改,需要在實體上增加註解
@Alias("user")
public class User {}
設定
這是 MyBatis 中極為重要的調整設定,它們會改變 MyBatis 的執行時行為。
其他配置
- typeHandlers(型別處理器)
- objectFactory(物件工廠)
- plugins外掛
- mybatis-generator-core
- mybatis-plus
- 通用mapper
對映器(mappers)
MapperRegistry:註冊繫結我們的Mapper檔案;
方式一: 【推薦使用】
<!--每一個Mapper.XML都需要在Mybatis核心配置檔案中註冊!-->
<mappers>
<mapper resource="com/kuang/dao/UserMapper.xml"/>
</mappers>
方式二:使用class檔案繫結註冊
<!--每一個Mapper.XML都需要在Mybatis核心配置檔案中註冊!-->
<mappers>
<mapper class="com.kuang.dao.UserMapper"/>
</mappers>
注意點:
- 介面和他的Mapper配置檔案必須同名!
- 介面和他的Mapper配置檔案必須在同一個包下!
方式三:使用掃描包進行注入繫結
<!--每一個Mapper.XML都需要在Mybatis核心配置檔案中註冊!-->
<mappers>
<package name="com.kuang.dao"/>
</mappers>
注意點:
- 介面和他的Mapper配置檔案必須同名!
- 介面和他的Mapper配置檔案必須在同一個包下!
生命週期和作用域
生命週期,和作用域,是至關重要的,因為錯誤的使用會導致非常嚴重的併發問題。
SqlSessionFactoryBuilder:
- 一旦建立了 SqlSessionFactory,就不再需要它了
- 區域性變數
SqlSessionFactory:
- 說白了就是可以想象為 :資料庫連線池
- SqlSessionFactory 一旦被建立就應該在應用的執行期間一直存在,沒有任何理由丟棄它或重新建立另一個例項。
- 因此 SqlSessionFactory 的最佳作用域是應用作用域。
- 最簡單的就是使用單例模式或者靜態單例模式。
SqlSession
- 連線到連線池的一個請求!
- SqlSession 的例項不是執行緒安全的,因此是不能被共享的,所以它的最佳的作用域是請求或方法作用域。
- 用完之後需要趕緊關閉,否則資源被佔用!
這裡面的每一個Mapper,就代表一個具體的業務!