免費(fèi)AI編程助手
MyBatis 3 XML配置-設(shè)置
2022-04-07 14:50 更新
這是 MyBatis 中極為重要的調(diào)整設(shè)置，它們會(huì)改變 MyBatis 的運(yùn)行時(shí)行為。 下表描述了設(shè)置中各項(xiàng)設(shè)置的含義、默認(rèn)值等。
| 設(shè)置名 | 描述 | 有效值 | 默認(rèn)值 |
?cacheEnabled? |
全局性地開(kāi)啟或關(guān)閉所有映射器配置文件中已配置的任何緩存 | true | false | true |
?lazyLoadingEnabled? |
延遲加載的全局開(kāi)關(guān)。當(dāng)開(kāi)啟時(shí)，所有關(guān)聯(lián)對(duì)象都會(huì)延遲加載。特定關(guān)聯(lián)關(guān)系中可通過(guò)設(shè)置?fetchType?屬性來(lái)覆蓋該項(xiàng)的開(kāi)關(guān)狀態(tài) |
true | false | false |
?aggressiveLazyLoading? |
開(kāi)啟時(shí)，任一方法的調(diào)用都會(huì)加載該對(duì)象的所有延遲加載屬性。否則，每個(gè)延遲加載屬性會(huì)按需加載 | true | false | false(在 3.4.1 及之前的版本中默認(rèn)為 true) |
?multipleResultSetsEnabled? |
是否允許單個(gè)語(yǔ)句返回多結(jié)果集(需要數(shù)據(jù)庫(kù)驅(qū)動(dòng)支持) | true | false | true |
?useColumnLabel? |
使用列標(biāo)簽代替列明。實(shí)際表現(xiàn)依賴于數(shù)據(jù)庫(kù)驅(qū)動(dòng)，具體可參考數(shù)據(jù)庫(kù)驅(qū)動(dòng)的相關(guān)文檔，或通過(guò)對(duì)比測(cè)試來(lái)觀察 | true | false | true |
?useGeneratedKeys? |
允許?JDBC?支持自動(dòng)生成主鍵，需要數(shù)據(jù)庫(kù)驅(qū)動(dòng)支持。如果設(shè)置為true，將強(qiáng)制使用自動(dòng)生成主鍵。盡管一些數(shù)據(jù)庫(kù)驅(qū)動(dòng)不支持此特性，但仍可正常工作(如?Derby?) |
true | false | false |
?autoMappingBehavior? |
指定 MyBatis 應(yīng)如何自動(dòng)映射列到字段或?qū)傩浴??NONE ?表示關(guān)閉自動(dòng)映射；?PARTIAL ?只會(huì)自動(dòng)映射沒(méi)有定義嵌套結(jié)果映射的字段。 ?FULL ?會(huì)自動(dòng)映射任何復(fù)雜的結(jié)果集（無(wú)論是否嵌套）。 |
NONE, PARTIAL, FULL | PARTIAL |
?autoMappingUnknownColumnBehavior? |
指定發(fā)現(xiàn)自動(dòng)映射目標(biāo)未知列（或未知屬性類型）的行為。
|
NONE, WARNING, FAILING | NONE |
?defaultExecutorType? |
配置默認(rèn)的執(zhí)行器。?SIMPLE ?就是普通的執(zhí)行器；?REUSE ?執(zhí)行器會(huì)重用預(yù)處理語(yǔ)句（PreparedStatement）； ?BATCH ?執(zhí)行器不僅重用語(yǔ)句還會(huì)執(zhí)行批量更新。 |
SIMPLE REUSE BATCH | SIMPLE |
?defaultStatementTimeout? |
設(shè)置超時(shí)時(shí)間，它決定數(shù)據(jù)庫(kù)驅(qū)動(dòng)等待數(shù)據(jù)庫(kù)響應(yīng)的秒數(shù)。 | 任意正整數(shù) | 未設(shè)置 (null) |
?defaultFetchSize? |
為驅(qū)動(dòng)的結(jié)果集獲取數(shù)量（?fetchSize?）設(shè)置一個(gè)建議值。此參數(shù)只可以在查詢?cè)O(shè)置中被覆蓋。 |
任意正整數(shù) | 未設(shè)置 (null) |
?defaultResultSetType? |
指定語(yǔ)句默認(rèn)的滾動(dòng)策略。（新增于 3.5.2） | FORWARD_ONLY | SCROLL_SENSITIVE | SCROLL_INSENSITIVE | DEFAULT（等同于未設(shè)置） | 未設(shè)置 (null) |
?safeRowBoundsEnabled? |
是否允許在嵌套語(yǔ)句中使用分頁(yè)（?RowBounds?）。如果允許使用則設(shè)置為 false。 |
true | false | False |
?safeResultHandlerEnabled? |
是否允許在嵌套語(yǔ)句中使用結(jié)果處理器（?ResultHandler?）。如果允許使用則設(shè)置為 false。 |
true | false | True |
?mapUnderscoreToCamelCase? |
是否開(kāi)啟駝峰命名自動(dòng)映射，即從經(jīng)典數(shù)據(jù)庫(kù)列名 ?A_COLUMN ?映射到經(jīng)典 Java 屬性名 ?aColumn?。 |
true | false | False |
?localCacheScope? |
MyBatis 利用本地緩存機(jī)制（Local Cache）防止循環(huán)引用和加速重復(fù)的嵌套查詢。 默認(rèn)值為 ?SESSION?，會(huì)緩存一個(gè)會(huì)話中執(zhí)行的所有查詢。 若設(shè)置值為 ?STATEMENT?，本地緩存將僅用于執(zhí)行語(yǔ)句，對(duì)相同 ?SqlSession ?的不同查詢將不會(huì)進(jìn)行緩存。 |
SESSION | STATEMENT | SESSION |
?jdbcTypeForNull? |
當(dāng)沒(méi)有為參數(shù)指定特定的 ?JDBC類型時(shí)，空值的默認(rèn) ?JDBC類型。 某些數(shù)據(jù)庫(kù)驅(qū)動(dòng)需要指定列的 ?JDBC類型，多數(shù)情況直接用一般類型即可，比如 ?NULL?、?VARCHAR ?或 ?OTHER?。 |
JdbcType 常量，常用值：NULL、VARCHAR 或 OTHER。 | OTHER |
?lazyLoadTriggerMethods? |
指定對(duì)象的哪些方法觸發(fā)一次延遲加載。 | 用逗號(hào)分隔的方法列表。 | equals,clone,hashCode,toString |
?defaultScriptingLanguage? |
指定動(dòng)態(tài) SQL 生成使用的默認(rèn)腳本語(yǔ)言。 | 一個(gè)類型別名或全限定類名。 | org.apache.ibatis.scripting.xmltags.XMLLanguageDriver |
?defaultEnumTypeHandler? |
指定?Enum?使用的默認(rèn)?TypeHandler?。（新增于 3.4.5） |
一個(gè)類型別名或全限定類名。 | org.apache.ibatis.type.EnumTypeHandler |
?callSettersOnNulls? |
指定當(dāng)結(jié)果集中值為 ?null ?的時(shí)候是否調(diào)用映射對(duì)象的 ?setter?（map 對(duì)象時(shí)為 ?put?）方法，這在依賴于 ?Map.keySet()? 或 null 值進(jìn)行初始化時(shí)比較有用。注意基本類型（int、boolean 等）是不能設(shè)置成 null 的。 |
true | false | false |
?returnInstanceForEmptyRow? |
當(dāng)返回行的所有列都是空時(shí)，MyBatis默認(rèn)返回 null。 當(dāng)開(kāi)啟這個(gè)設(shè)置時(shí)，MyBatis會(huì)返回一個(gè)空實(shí)例。 請(qǐng)注意，它也適用于嵌套的結(jié)果集（如集合或關(guān)聯(lián)）。（新增于 3.4.2） | true | false | false |
?logPrefix? |
指定 MyBatis 增加到日志名稱的前綴。 | 任何字符串 | 未設(shè)置 |
?logImpl? |
指定 MyBatis 所用日志的具體實(shí)現(xiàn)，未指定時(shí)將自動(dòng)查找。 | SLF4J | LOG4J(deprecated since 3.5.9) | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING | 未設(shè)置 |
?proxyFactory? |
指定 Mybatis 創(chuàng)建可延遲加載對(duì)象所用到的代理工具。 | CGLIB | JAVASSIST | JAVASSIST （MyBatis 3.3 以上） |
?vfsImpl? |
指定 VFS 的實(shí)現(xiàn) | 自定義 VFS 的實(shí)現(xiàn)的類全限定名，以逗號(hào)分隔。 | 未設(shè)置 |
?useActualParamName? |
允許使用方法簽名中的名稱作為語(yǔ)句參數(shù)名稱。 為了使用該特性，你的項(xiàng)目必須采用 Java 8 編譯，并且加上 ?-parameters? 選項(xiàng)。（新增于 3.4.1） |
true | false | true |
?configurationFactory? |
指定一個(gè)提供 ?Configuration實(shí)例的類。 這個(gè)被返回的 ?Configuration ?實(shí)例用來(lái)加載被反序列化對(duì)象的延遲加載屬性值。 這個(gè)類必須包含一個(gè)簽名為?static Configuration getConfiguration()? 的方法。（新增于 3.2.3） |
一個(gè)類型別名或完全限定類名。 | 未設(shè)置 |
?shrinkWhitespacesInSql? |
從SQL中刪除多余的空格字符。請(qǐng)注意，這也會(huì)影響SQL中的文字字符串。 (新增于 3.5.5) | true | false | false |
?defaultSqlProviderType? |
指定一個(gè)包含提供程序方法的 sql 提供程序類（自 3.5.6 起）。 當(dāng)省略這些屬性時(shí)，此類適用于 sql 提供程序注釋（例如 ?@SelectProvider?）上的類型（或值）屬性。 |
類型別名或完全限定的類名 | 未設(shè)置 |
?nullableOnForEach? |
指定'?foreach?'標(biāo)記上的'?nullable?'屬性的默認(rèn)值。（自 3.5.9 起） |
true | false | false |
一個(gè)配置完整的settings元素的示例如下：
<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>以上內(nèi)容是否對(duì)您有幫助：
更多建議：