一.XML配置的頂級目錄:
configuration 配置
- properties 屬性
- settings 設置
- typeAliases 類型別名
- typeHandlers 類型處理器
- objectFactory 對象工廠
- plugins 插件
- environments 環境
- environment 環境變量
- transactionManager 事務管理器
- dataSource 數據源
- environment 環境變量
- databaseIdProvider 數據庫廠商標識
- mappers 映射器
注意: configuration 節點下,所有的元素節點,必須按照上述規定的順序自上而下定義 ,不可更改順序
1.properties 屬性
作用: 可以從配置文件讀取屬性鍵值對 或 者在properties節點內自定義屬性鍵值對, 便於 xml配置文件中,可以通過${key}的形式 獲取屬性值
形式一:從屬性配置文件中讀取 key value
<!--屬性配置文件--> <properties resource="jdbc.properties"/>
附上 jdbc.properties 配置文件詳情:
#key=value 形式配置必須的參數
#建議每一個屬性值后 不要留有空格
jdbc.driverClassName=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://127.0.0.1:3306/crm?serverTimezone=GMT%2B8
jdbc.username=root
jdbc.password=
形式二:properties 子元素定義
<properties> <property name="jdbc.driverClassName" value="com.mysql.jdbc.Driver"/> <property name="jdbc.url" value="jdbc:mysql://127.0.0.1:3306/crm?serverTimezone=GMT%2B8"/> <property name="jdbc.username" value="root"/> <property name="jdbc.password" value=""/> </properties>
配置文件中在properties 元素后的任意處獲取屬性值的方式:
<environments default="development"> <environment id="development"> <transactionManager type="JDBC"/> <!--事務管理類型--> <dataSource type="POOLED"> <property name="driver" value="${jdbc.driverClassName}"/> <property name="url" value="${jdbc.url}"/> <property name="username" value="${jdbc.username}"/> <property name="password" value="${jdbc.password}"/> </dataSource> </environment> </environments>
對於設計數據庫的一些參數,通常寫進jdbc.properties配置文件中, 因此推薦通過 形式一的方式 獲取屬性值
屬性也可以通過參數的形式傳遞到 SqlSessionFactoryBuilder.build()方法中,官方給出的案例如下:
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, props); // ... or ... SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment, props);
對於Properties的更進一步介紹,本文不做介紹 , 請參照:https://www.cnblogs.com/bakari/p/3562244.html
那么此時就會有一個疑問,如果傳遞屬性值的三種方式同時使用,那么最終以哪個為准呢 或者是哪個優先級最高呢?
首先先了解MyBatis的加載順序:
- 在 properties 元素體內指定的屬性首先被讀取。
- 然后根據 properties 元素中的 resource 屬性讀取類路徑下屬性文件或根據 url 屬性指定的路徑讀取屬性文件,並覆蓋已讀取的同名屬性。
- 最后讀取作為方法參數傳遞的屬性,並覆蓋已讀取的同名屬性。
由於前者會被后者所覆蓋
所以答案是: 方法傳參 > resource讀取屬性配置文件 > properties 子節點自定義屬性值
如果配置文件中沒有定義相關的屬性的key與value,則在MyBatis 3.4.2之后,通過${key}占位符的形式 取值時可以指定默認值的方式
例如:${key:defaultValue} 如果通過占位符取的這個值,未被定義或提供,那么將會使用冒號后的默認值:defaultValue
使用這種方式前,需要開啟一個配置,這種方式才會生效,開啟方式如下:
<properties resource="jdbc.properties"> <!-- Enable this feature --> <property name="org.apache.ibatis.parsing.PropertyParser.enable-default-value" value="true"/> </properties>
具體配置實例如下:
<dataSource type="POOLED"> <!-- ... --> <property name="username" value="${username:ut_user}"/> <!-- If 'username' property not present, username become 'ut_user' --> </dataSource>
額外的,如果你不想使用默認的冒號作為分隔符, MyBatis也支持你配置其它自定義的符號,配置方式如下:
<properties resource="jdbc.properties"> <!-- Enable this feature --> <property name="org.apache.ibatis.parsing.PropertyParser.enable-default-value" value="true"/> <!-- Change default value of separator --> <property name="org.apache.ibatis.parsing.PropertyParser.default-value-separator" value="?"/> </properties>
此時,使用方式為:
<dataSource type="POOLED"> <property name="driver" value="${jdbc.driverClassName}"/> <property name="url" value="${jdbc.url}"/> <property name="username" value="${jdbc.username?root}"/> <property name="password" value="${jdbc.password}"/> </dataSource>
2.settings 設置
這是 MyBatis 中極為重要的調整設置,它們會改變 MyBatis 的運行時行為。完整的setting元素實例如下:
<settings> <setting name="cacheEnabled" value="true"/> <setting name="lazyLoadingEnabled" value="true"/> <setting name="multipleResultSetsEnabled" value="true"/> <setting name="useColumnLabel" value="true"/> <setting name="useGeneratedKeys" value="false"/> <setting name="autoMappingBehavior" value="PARTIAL"/> <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/> <setting name="defaultExecutorType" value="SIMPLE"/> <setting name="defaultStatementTimeout" value="25"/> <setting name="defaultFetchSize" value="100"/> <setting name="safeRowBoundsEnabled" value="false"/> <setting name="mapUnderscoreToCamelCase" value="false"/> <setting name="localCacheScope" value="SESSION"/> <setting name="jdbcTypeForNull" value="OTHER"/> <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/> </settings>
下表描述了設置中各個參數的作用、默認值等
設置參數 | 描述 | 有效值 | 默認值 |
---|---|---|---|
cacheEnabled | 全局地開啟或關閉配置文件中的所有映射器已經配置的任何緩存。 | true | false | true |
lazyLoadingEnabled | 延遲加載的全局開關。當開啟時,所有關聯對象都會延遲加載。 特定關聯關系中可通過設置fetchType屬性來覆蓋該項的開關狀態。 | true | false | false |
aggressiveLazyLoading | 當開啟時,任何方法的調用都會加載該對象的所有屬性。否則,每個屬性會按需加載(參考lazyLoadTriggerMethods). | true | false | false (true in ≤3.4.1) |
multipleResultSetsEnabled | 是否允許單一語句返回多結果集(需要兼容驅動)。 | true | false | true |
useColumnLabel | 使用列標簽代替列名。不同的驅動在這方面會有不同的表現, 具體可參考相關驅動文檔或通過測試這兩種不同的模式來觀察所用驅動的結果。 | true | false | true |
useGeneratedKeys | 允許 JDBC 支持自動生成主鍵,需要驅動兼容。 如果設置為 true 則這個設置強制使用自動生成主鍵,盡管一些驅動不能兼容但仍可正常工作(比如 Derby)。 | true | false | False |
autoMappingBehavior | 指定 MyBatis 應如何自動映射列到字段或屬性。 NONE 表示取消自動映射;PARTIAL 只會自動映射沒有定義嵌套結果集映射的結果集。 FULL 會自動映射任意復雜的結果集(無論是否嵌套)。 | NONE, PARTIAL, FULL | PARTIAL |
autoMappingUnknownColumnBehavior | 指定發現自動映射目標未知列(或者未知屬性類型)的行為。
|
NONE, WARNING, FAILING | NONE |
defaultExecutorType | 配置默認的執行器。SIMPLE 就是普通的執行器;REUSE 執行器會重用預處理語句(prepared statements); BATCH 執行器將重用語句並執行批量更新。 | SIMPLE REUSE BATCH | SIMPLE |
defaultStatementTimeout | 設置超時時間,它決定驅動等待數據庫響應的秒數。 | 任意正整數 | Not Set (null) |
defaultFetchSize | 為驅動的結果集獲取數量(fetchSize)設置一個提示值。此參數只可以在查詢設置中被覆蓋。 | 任意正整數 | Not Set (null) |
safeRowBoundsEnabled | 允許在嵌套語句中使用分頁(RowBounds)。如果允許使用則設置為false。 | true | false | False |
safeResultHandlerEnabled | 允許在嵌套語句中使用分頁(ResultHandler)。如果允許使用則設置為false。 | true | false | True |
mapUnderscoreToCamelCase | 是否開啟自動駝峰命名規則(camel case)映射,即從經典數據庫列名 A_COLUMN 到經典 Java 屬性名 aColumn 的類似映射。 | true | false | False |
localCacheScope | MyBatis 利用本地緩存機制(Local Cache)防止循環引用(circular references)和加速重復嵌套查詢。 默認值為 SESSION,這種情況下會緩存一個會話中執行的所有查詢。 若設置值為 STATEMENT,本地會話僅用在語句執行上,對相同 SqlSession 的不同調用將不會共享數據。 | SESSION | STATEMENT | SESSION |
jdbcTypeForNull | 當沒有為參數提供特定的 JDBC 類型時,為空值指定 JDBC 類型。 某些驅動需要指定列的 JDBC 類型,多數情況直接用一般類型即可,比如 NULL、VARCHAR 或 OTHER。 | JdbcType 常量. 大多都為: NULL, VARCHAR and OTHER | OTHER |
lazyLoadTriggerMethods | 指定哪個對象的方法觸發一次延遲加載。 | 用逗號分隔的方法列表。 | equals,clone,hashCode,toString |
defaultScriptingLanguage | 指定動態 SQL 生成的默認語言。 | 一個類型別名或完全限定類名。 | org.apache.ibatis.scripting.xmltags.XMLLanguageDriver |
defaultEnumTypeHandler | 指定 Enum 使用的默認 TypeHandler 。 (從3.4.5開始) | 一個類型別名或完全限定類名。 | org.apache.ibatis.type.EnumTypeHandler |
callSettersOnNulls | 指定當結果集中值為 null 的時候是否調用映射對象的 setter(map 對象時為 put)方法,這對於有 Map.keySet() 依賴或 null 值初始化的時候是有用的。注意基本類型(int、boolean等)是不能設置成 null 的。 | true | false | false |
returnInstanceForEmptyRow | 當返回行的所有列都是空時,MyBatis默認返回null。 當開啟這個設置時,MyBatis會返回一個空實例。 請注意,它也適用於嵌套的結果集 (i.e. collectioin and association)。(從3.4.2開始) | true | false | false |
logPrefix | 指定 MyBatis 增加到日志名稱的前綴。 | 任何字符串 | Not set |
logImpl | 指定 MyBatis 所用日志的具體實現,未指定時將自動查找。 | SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING | Not set |
proxyFactory | 指定 Mybatis 創建具有延遲加載能力的對象所用到的代理工具。 | CGLIB | JAVASSIST | JAVASSIST (MyBatis 3.3 or above) |
vfsImpl | 指定VFS的實現 | 自定義VFS的實現的類全限定名,以逗號分隔。 | Not set |
useActualParamName | 允許使用方法簽名中的名稱作為語句參數名稱。 為了使用該特性,你的工程必須采用Java 8編譯,並且加上-parameters選項。(從3.4.1開始) | true | false | true |
configurationFactory | 指定一個提供Configuration實例的類。 這個被返回的Configuration實例用來加載被反序列化對象的懶加載屬性值。 這個類必須包含一個簽名方法static Configuration getConfiguration(). (從 3.2.3 版本開始) | 類型別名或者全類名. | Not set |
3.typeAliases 類型別名
上篇文章中已經介紹 typeAliases 的作用, 他的主要作用是為全限定名 起 一個簡短的名字 ,這樣在Mapper.xml文件中, 就可以使用別名代替全限定名:
<!--為類的權限定名稱設置簡短的別名--> <typeAliases> <typeAlias type="com.baoxian.domain.UserInfo" alias="UserInfo"/> </typeAliases>
使用時:
<!-- 正常情況下 type 需要寫上實體類的全限定名稱,但是由於在 mybatis的配置文件中,即 mybatis_config.xml中指定了別名,所以可以使用別名的方式 <resultMap id="BaseResultMap" type="com.baoxian.domain.UserInfo" > --> <resultMap id="BaseResultMap" type="UserInfo" > <id column="id" property="id" /> <result column="username" property="userName" /> <result column="age" property="age" /> </resultMap>
如果在 domain包下有非常多的類都需要使用別名, 那么一一配置, 就顯得過於繁瑣 ,此時需要提供需要被檢索的包名,MyBatis就會掃描這個包下所有的類,並為他們設置別名:
<typeAliases> <package name="domain.blog"/> </typeAliases>
MyBatis 設置別名的默認規則為:會使用 Bean 的首字母小寫的非限定類名來作為它的別名。 比如 domain.blog.Author 的別名為 author
如果希望自定義別名,則只需要在對應的Java Bean上添加@Alias(aliasName) 注解,如下:
@Alias("UserInfo") public class UserInfo { }
另外.別名是不區分大小寫的,比如設置的別名為UserInfo ,那么在Mapper.xml文件中指定別名,可以寫成UserInfo ,也可以寫成 userinfo;建議保持一致
以下是MyBatis內置的一些別名,會映射到特殊的類, 我們在使用別名時應避免與這些別名重復:
別名 | 映射的類型 |
---|---|
_byte | byte |
_long | long |
_short | short |
_int | int |
_integer | int |
_double | double |
_float | float |
_boolean | boolean |
string | String |
byte | Byte |
long | Long |
short | Short |
int | Integer |
integer | Integer |
double | Double |
float | Float |
boolean | Boolean |
date | Date |
decimal | BigDecimal |
bigdecimal | BigDecimal |
object | Object |
map | Map |
hashmap | HashMap |
list | List |
arraylist | ArrayList |
collection | Collection |
iterator | Iterator |
4.typeHandlers 類型處理器
執行sql語句時,mybatis的類型處理器 會幫我們完成 java 類型 與 jdbc 類型的互相轉換,默認的對應關系如下:
類型處理器 | Java 類型 | JDBC 類型 |
---|---|---|
BooleanTypeHandler | java.lang.Boolean, boolean | 數據庫兼容的 BOOLEAN |
ByteTypeHandler | java.lang.Byte, byte | 數據庫兼容的 NUMERIC 或 BYTE |
ShortTypeHandler | java.lang.Short, short | 數據庫兼容的 NUMERIC 或 SHORT INTEGER |
IntegerTypeHandler | java.lang.Integer, int | 數據庫兼容的 NUMERIC 或 INTEGER |
LongTypeHandler | java.lang.Long, long | 數據庫兼容的 NUMERIC 或 LONG INTEGER |
FloatTypeHandler | java.lang.Float, float | 數據庫兼容的 NUMERIC 或 FLOAT |
DoubleTypeHandler | java.lang.Double, double | 數據庫兼容的 NUMERIC 或 DOUBLE |
BigDecimalTypeHandler | java.math.BigDecimal | 數據庫兼容的 NUMERIC 或 DECIMAL |
StringTypeHandler | java.lang.String | CHAR, VARCHAR |
ClobReaderTypeHandler | java.io.Reader | - |
ClobTypeHandler | java.lang.String | CLOB, LONGVARCHAR |
NStringTypeHandler | java.lang.String | NVARCHAR, NCHAR |
NClobTypeHandler | java.lang.String | NCLOB |
BlobInputStreamTypeHandler | java.io.InputStream | - |
ByteArrayTypeHandler | byte[] | 數據庫兼容的字節流類型 |
BlobTypeHandler | byte[] | BLOB, LONGVARBINARY |
DateTypeHandler | java.util.Date | TIMESTAMP |
DateOnlyTypeHandler | java.util.Date | DATE |
TimeOnlyTypeHandler | java.util.Date | TIME |
SqlTimestampTypeHandler | java.sql.Timestamp | TIMESTAMP |
SqlDateTypeHandler | java.sql.Date | DATE |
SqlTimeTypeHandler | java.sql.Time | TIME |
ObjectTypeHandler | Any | OTHER 或未指定類型 |
EnumTypeHandler | Enumeration Type | VARCHAR-任何兼容的字符串類型,存儲枚舉的名稱(而不是索引) |
EnumOrdinalTypeHandler | Enumeration Type | 任何兼容的 NUMERIC 或 DOUBLE 類型,存儲枚舉的索引(而不是名稱)。 |
InstantTypeHandler | java.time.Instant | TIMESTAMP |
LocalDateTimeTypeHandler | java.time.LocalDateTime | TIMESTAMP |
LocalDateTypeHandler | java.time.LocalDate | DATE |
LocalTimeTypeHandler | java.time.LocalTime | TIME |
OffsetDateTimeTypeHandler | java.time.OffsetDateTime | TIMESTAMP |
OffsetTimeTypeHandler | java.time.OffsetTime | TIME |
ZonedDateTimeTypeHandler | java.time.ZonedDateTime | TIMESTAMP |
YearTypeHandler | java.time.Year | INTEGER |
MonthTypeHandler | java.time.Month | INTEGER |
YearMonthTypeHandler | java.time.YearMonth | VARCHAR or LONGVARCHAR |
JapaneseDateTypeHandler | java.time.chrono.JapaneseDate | DATE |
如果你需要自己定義類型的映射關系,需要實現org.apache.ibatis.type.TypeHandler 接口 或者 繼承一個很便利的類 org.apache.ibatis.type.BaseTypeHandler, 然后可以選擇性地將它映射到一個 JDBC 類型
由於這種需求在開發中不多見,故不做詳細深入,有興趣的可以查閱MyBatis 官方文檔
5.objectFactory 對象工廠
MyBatis 每次創建結果對象的新實例時,它都會使用一個對象工廠(ObjectFactory)實例來完成。 默認的對象工廠需要做的僅僅是實例化目標類,要么通過默認構造方法,要么在參數映射存在的時候通過參數構造方法來實例化。 如果想覆蓋對象工廠的默認行為,則可以通過創建自己的對象工廠來實現,想深入了解更多,請自行查閱資料 ,此處不做深入介紹
6.plugins 插件
MyBatis 允許你在已映射語句執行過程中的某一點進行攔截調用。默認情況下,MyBatis 允許使用插件來攔截的方法調用包括:
- Executor (update, query, flushStatements, commit, rollback, getTransaction, close, isClosed)
- ParameterHandler (getParameterObject, setParameters)
- ResultSetHandler (handleResultSets, handleOutputParameters)
- StatementHandler (prepare, parameterize, batch, update, query)
同上,本元素 不做過多介紹
7.配置環境(environments)
一般MySQL與數據庫的連接信息或事務信息都配置在環境節點下,如果需要連接多個數據庫,則需要配置多個environment,
例如:顯示開發中, 開發環境 ,測試環境,生產環境的數據庫都是獨立的,因此需要配置不同的environment
雖然可以配置多個 環境 ,但是sqlSessionFactory實例只能選擇一個環境
如果需要連接兩個數據庫,則就需要兩個sqlSessionFactory實例, n個數據庫 ,需要n個sqlSessionFactory實例
創建sqlSessionFactory對象時 接收環境的方法簽名共兩個,environment即配置文件中environment元素的id值
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment); SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment, properties);
如果不通過上面兩種方式創建 SqlSessionFactory 實例,那么底層將會傳入默認的 環境.如下兩種方式:
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader); SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, properties);
說了這么多,那么如何在配置文件中,配置環境變量呢? 請看下面的示例:
<environments default="development"> <environment id="development"> <transactionManager type="JDBC"/> <!--事務管理類型--> <dataSource type="POOLED"> <property name="driver" value="${jdbc.driverClassName}"/> <property name="url" value="${jdbc.url}"/> <property name="username" value="${jdbc.username?root}"/> <property name="password" value="${jdbc.password}"/> </dataSource> </environment> <environment id="test"> <transactionManager type="JDBC"/> <!--事務管理類型--> <dataSource type="POOLED"> <property name="driver" value="${jdbc.driverClassName}"/> <property name="url" value="${jdbc.test.url}"/> <property name="username" value="${jdbc.username?root}"/> <property name="password" value="${jdbc.password}"/> </dataSource> </environment> </environments>
此時配置了兩個環境 ,必須為 environments 元素 指定一個默認的環境, 例:default = development , 他表示的含義是指定一個默認的環境,環境的id為 development
7.1 environment元素下的重要子元素
1.transactionManager 事務管理器
2.dataSource 數據源
7.1.1 transactionManager 事務管理器
在 MyBatis 中有兩種類型的事務管理器(也就是 type=”[JDBC|MANAGED]”):
JDBC: 這個配置就是直接使用了 JDBC 的提交和回滾設置,它依賴於從數據源得到的連接來管理事務作用域。
MANAGED:MANAGED – 這個配置幾乎沒做什么。它從來不提交或回滾一個連接,而是讓容器來管理事務的整個生命周期(比如 JEE 應用服務器的上下文)。 默認情況下它會關閉連接,然而一些容器並不希望這樣,因此需要將 closeConnection 屬性設置為 false 來阻止它默認的關閉行為。例如:
<transactionManager type="MANAGED"> <property name="closeConnection" value="false"/> </transactionManager>
一般選擇 JDBC,這兩種事務管理器類型都不需要任何屬性。它們不過是類型別名
如果 使用Spring + MyBatis 集成, 則不需要配置事務管理器,Spring會使用自帶的事務管理器 覆蓋 MyBatis中的配置
7.1.2 dataSource 數據源
dataSource 元素使用標准的 JDBC 數據源接口來配置 JDBC 連接對象的資源。
dataSource 同transactionManager 標簽一樣, 也有type屬性;dataSource標簽的類型有: UNPOOLED,POOLED,JNDI 三種:
UNPOOLED:
該類型表示,每次這個數據源,在請求時都會建立連接,每次關閉時都會斷開連接;對數據庫連接沒有太高性能要求的應用 數據源可以選擇該類型,該類型僅需要配置五種屬性:
- driver – 這是 JDBC 驅動的 Java 類的完全限定名(並不是 JDBC 驅動中可能包含的數據源類)。如果使用的是mysql數據庫:一般為com.mysql.jdbc.diver
- url – 這是數據庫的 JDBC URL 地址。 mysql數據庫如右圖所示:jdbc:mysql://127.0.0.1:3306/crm jdbc:mysql: 數據庫ip地址 : 端口號 / 需要連接的數據庫名稱
- username – 登錄數據庫的用戶名。
- password – 登錄數據庫的密碼。
- defaultTransactionIsolationLevel – 默認的連接事務隔離級別。
POOLED:
數據庫連接池,這種數據源的實現利用“池”的概念將 JDBC 連接對象組織起來,避免了創建新的連接實例時所必需的初始化和認證時間。 這是一種使得並發 Web 應用快速響應請求的流行處理方式。
除了上述提到 UNPOOLED 下的屬性外,還有更多屬性用來配置 POOLED 的數據源:
- poolMaximumActiveConnections – 在任意時間可以存在的活動(也就是正在使用)連接數量,默認值:10
- poolMaximumIdleConnections – 任意時間可能存在的空閑連接數。
- poolMaximumCheckoutTime – 在被強制返回之前,池中連接被檢出(checked out)時間,默認值:20000 毫秒(即 20 秒)
- poolTimeToWait – 這是一個底層設置,如果獲取連接花費了相當長的時間,連接池會打印狀態日志並重新嘗試獲取一個連接(避免在誤配置的情況下一直安靜的失敗),默認值:20000 毫秒(即 20 秒)。
- poolMaximumLocalBadConnectionTolerance – 這是一個關於壞連接容忍度的底層設置, 作用於每一個嘗試從緩存池獲取連接的線程. 如果這個線程獲取到的是一個壞的連接,那么這個數據源允許這個線程嘗試重新獲取一個新的連接,但是這個重新嘗試的次數不應該超過 poolMaximumIdleConnections 與 poolMaximumLocalBadConnectionTolerance 之和。 默認值:3 (新增於 3.4.5)
- poolPingQuery – 發送到數據庫的偵測查詢,用來檢驗連接是否正常工作並准備接受請求。默認是“NO PING QUERY SET”,這會導致多數數據庫驅動失敗時帶有一個恰當的錯誤消息。
- poolPingEnabled – 是否啟用偵測查詢。若開啟,需要設置 poolPingQuery 屬性為一個可執行的 SQL 語句(最好是一個速度非常快的 SQL 語句),默認值:false。
- poolPingConnectionsNotUsedFor – 配置 poolPingQuery 的頻率。可以被設置為和數據庫連接超時時間一樣,來避免不必要的偵測,默認值:0(即所有連接每一時刻都被偵測 — 當然僅當 poolPingEnabled 為 true 時適用)。
JNDI :
使用較少
這個數據源的實現是為了能在如 EJB 或應用服務器這類容器中使用,容器可以集中或在外部配置數據源,然后放置一個 JNDI 上下文的引用。這種數據源配置只需要兩個屬性:
- initial_context – 這個屬性用來在 InitialContext 中尋找上下文(即,initialContext.lookup(initial_context))。這是個可選屬性,如果忽略,那么 data_source 屬性將會直接從 InitialContext 中尋找。
- data_source – 這是引用數據源實例位置的上下文的路徑。提供了 initial_context 配置時會在其返回的上下文中進行查找,沒有提供時則直接在 InitialContext 中查找。
8.databaseIdProvider 數據庫廠商標識
MyBatis 可以根據不同的數據庫廠商執行不同的語句,這種多廠商的支持是基於映射語句中的 databaseId 屬性。 MyBatis 會加載不帶 databaseId 屬性和帶有匹配當前數據庫 databaseId 屬性的所有語句。 如果同時找到帶有 databaseId 和不帶 databaseId 的相同語句,則后者會被舍棄。 為支持多廠商特性只要像下面這樣在 mybatis-config.xml 文件中加入 databaseIdProvider 即可:
<databaseIdProvider type="DB_VENDOR" />
9.映射器(mappers) 必須配置
通過配置mappers 告訴MyBatis 去哪里執行相應的SQL語句,共有以下四種方式:
<!-- 使用相對於類路徑的資源引用 較常用,最直觀--> <mappers> <mapper resource="com/baoxian/dao/UserInfoMapper.xml"/> </mappers> <!-- 使用完全限定資源定位符(URL)一旦項目移植到別的主機,可能就要更改,因此使用較少 --> <mappers> <mapper url="file:///var/mappers/AuthorMapper.xml"/> </mappers> <!-- 使用映射器接口實現類的完全限定類名,此時要保證Mapper.xml中的nameSpace與接口的全限定名相同 --> <mappers> <mapper class="com.baoxian.dao.UserInfoMapper"/> </mappers> <!--掃描整個包,將包下所有的接口類全部注冊成映射器 較常用--> <mappers> <package name="com.baoxian.dao"/> </mappers>