閱讀(2.1k) 書簽贊(0) 我要糾錯

MyBatis 3 XML配置-設(shè)置

2022-04-07 14:50 更新

這是 MyBatis 中極為重要的調(diào)整設(shè)置，它們會改變 MyBatis 的運行時行為。下表描述了設(shè)置中各項設(shè)置的含義、默認值等。

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

一個配置完整的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)容是否對您有幫助：

← MyBatis 3 XML配置-屬性

MyBatis 3 XML配置-類型別名 →

寫筆記

我要補充