mybatis-config.xml文件詳解


1. 屬性列表

Mybatis的配置文件中包含了影響mybatis行為的設置(settings)和屬性(properties)信息。文檔的頂層結構如下:

·configuration 根配置

     ·properties 屬性

     ·settings 設置

     ·typeAliases 類型別名

     ·typeHandlers 類型處理器

     ·objectFactory 對象工廠

     ·plugins 插件

     ·environments 環境

         ·environment 環境變量

             ·transactionManager 事務管理器

             ·dataSource 數據源

     ·databaseIdProvider 數據庫廠商標識

     ·mappers 映射器

2. properties

屬性可以在外部配置且可動態替換,既可以在properties文件中配置,也可以通過properties元素的子元素來傳遞,例如:

<properties resource="jdbc.properties">
  <property name="driver" value="com.mysql.jdbc.Driver"/>
</properties>



// jdbc.properties
url=jdbc:mysql://192.168.25.84:3306/test
user=root
pwd=mysql  

然后其中的屬性就可以在整個配置文件中被用來替換需要動態配置的屬性值:

<dataSource type="POOLED">
        <property name="driver" value="${driver}"/>
        <property name="url" value="${url}"/>
        <property name="username" value="${user}"/>
        <property name="password" value="${pwd}"/>
      </dataSource>  

真個例子中的url,user,pwd將會由properties元素中設置的相應值來替換。driver將會由properties文件中對應的值來替換。 

屬性也可以被傳遞到SqlSessionFactoryBuilder.build()方法中,例如:

Properties p = new Properties();
p.setProperty("driver", "com.mysql.jdbc.Driver");
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is, p);  

如果屬性在不只一個地方進行了配置,那么mybatis將按照下面的順序來加載:

  1. 在properties元素體內指定的屬性首先被讀取;
  2. 然后根據properties元素體重的resource屬性讀取類路徑下屬性文件或根據url屬性指定的路徑讀取屬性文件,並覆蓋已讀的同名屬性;
  3. 最后讀取作為方法參數傳遞的屬性,並覆蓋已讀取的同名屬性。

因此,通過方法參數傳遞的屬性具有最高優先級,resource/url屬性中指定的配置文件次之,最低優先級的是properties屬性中自定的屬性。

也可以為配置項設置默認值,這個特性默認是關閉的,可以添加屬性enable-default-value來開啟這個特性,同時也可以通過增加一個指定的屬性default-value-separator來改變風隔鍵和默認值的字符。

<properties resource="jdbc.properties">
  <property name="driver" value="com.mysql.jdbc.Driver"/>
  <!-- 允許占位符 -->
  <property name="org.apache.ibatis.parsing.PropertyParser.enable-default-value" value="true"/> 
  <!-- 設置占位符分隔符 -->
  <property name="org.apache.ibatis.parsing.PropertyParser.default-value-separator" value=":?"/>
  </properties>
  <environments default="development">
    <environment id="development">
      <transactionManager type="JDBC"/>
      <dataSource type="POOLED">
        <property name="driver" value="${driver:?com.mysql.jdbc.Driver}"/>
        <property name="url" value="${url}"/>
        <property name="username" value="${user}"/>
        <property name="password" value="${pwd}"/>
      </dataSource>
    </environment>
  </environments>

3. settings

這是mybatis中重要的調整設置,它們會改變mybatis的運行時行為,下表描述了設置中各項的意圖,默認值等。

參數 描述 有效值 默認值
cacheEnabled

全局開啟或關閉配置文件中的所有映射器已經配置的任何緩存

請參考http://www.cnblogs.com/lujiango/p/8631744.html

true|false true
 lazyLoadingEnabled 延遲加載的全局開關,當開啟時,所有關聯對象都會延遲加載。特定關聯關系中可通過設置fetchType屬性來覆蓋該項的開關狀態  true|false  false 
 aggressiveLazyLoading 當開啟時,任何方法的調用都會加載該對象的所有屬性。否則,每個屬性會按需加載(參考lazyLoadTriggerMethods).  true|false  false
 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: 輸出提醒日志 ('org.apache.ibatis.session.AutoMappingUnknownColumnBehavior'的日志等級必須設置為 WARN)
  • FAILING: 映射失敗 (拋出 SqlSessionException
 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 
 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)
 JAVASSIST (MyBatis 3.3 or above)  指定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
       
       

4. typeAliases

 類型別名是為Java類型設置一個短的名字。它只和XML配置有關,存在的意義僅在於用來減少類完全限定名的冗余。例如:

  <typeAliases>
    <typeAlias alias = "user" type = "org.mybatis.mapper.User" />
  </typeAliases>  

當這樣配置時,user可以用在任何使用org.mybatis.mapper.User的地方。

也可以指定一個包名,mybatis會在包名下面搜索需要的JavaBean 

  <typeAliases>
    <package name="org.mybatis.mapper" />
  </typeAliases>  

每個在包org.mybatis.mapper中的JavaBean,在沒有注解的情況下,會使用bean的首字母小寫的非限定類名作為它的別名。比如org.mybatis.mapper.User的別名為user,若有注解,則別名為其注解值。如下:

@Alias("user")
public class User implements Serializable {

}

5. typeHandlers

無論是mybatis在預處理語句(PreparedStatement)中設置一個參數時,還是從結果集中取出一個值時,都會用類型處理器將獲取的值以合適的方式轉換成Java類型。  

可以重寫類型處理器或創建自己的類型處理器來處理不支持的或非標准的類型。具體做法是:實現org.apache.ibatis.type.TypeHandler接口或繼承org.apache.ibatis.type.BaseTypeHandler,然后可以選擇性地將它映射到一個JDBC類型。 

通過類型處理器的泛型,mybatis可以得知該類型處理器處理的Java類型,如: 

public class DateTypeHandler extends BaseTypeHandler<Date>  

 不過這種行為可以通過兩種方法改變:

  • 在類型處理器的配置元素上增加一個javaType屬性,如
      <typeHandlers>
        <typeHandler handler="org.mybatis.handler.DateTypeHandler" javaType="String"/>
      </typeHandlers>  
  • 在類型處理器的類上增加一個@MappedTypes注解來指定與其關聯的Java類型列表,如果在javaType屬性中也同時指定,則注解方式將被忽略
    @MappedTypes(java.lang.String.class)
    public class DateTypeHandler extends BaseTypeHandler<Date>

 可以通過2種方式來指定被關聯的JDBC類型:

  • 在類型處理器的配置元素上增加一個jdbcType屬性,如:
      <typeHandlers>
        <typeHandler handler="org.mybatis.handler.DateTypeHandler" jdbcType="VARCHAR"/>
      </typeHandlers>  
  • 在類型處理器的類上增加一個@MappedJdbcTypes注解來指定與其關聯的JDBC類型列表,如果在jdbcType屬性中也同時指定,則注解方式將被忽略。
    @MappedJdbcTypes(JdbcType.VARCHAR)
    public class DateTypeHandler extends BaseTypeHandler<Date>  

6. objectFactory

mybatis每次創建結果對象的新實例時,它都會使用一個對象工廠實例來完成。默認的對象工廠需要做的僅僅是實例化目標類,要么通過默認構造方法,要么在參數映射存儲的時候通過參數構造方法來實例化。如果想覆蓋對象工廠的默認行為,則可以通過創建自己的對象工廠來實現。

ObjectFactory接口很簡單,它包含兩個創建用的方法,一個是處理默認構造方法的,另一個是處理帶參數的構造方法。最后,setProperties方法可以被用來配置ObjectFactory,在初始化ObjectFactory實例后,objectFactory元素體中定義的屬性會被傳遞給setProperties方法。

public class MyObjectFactory extends DefaultObjectFactory {

    private static final long serialVersionUID = 1L;

    @Override
    public <T> T create(Class<T> type, List<Class<?>> constructorArgTypes, List<Object> constructorArgs) {
        return super.create(type, constructorArgTypes, constructorArgs);
    }

    @Override
    public <T> T create(Class<T> type) {
        return super.create(type);
    }

    @Override
    public <T> boolean isCollection(Class<T> type) {
        return super.isCollection(type);
    }

    @Override
    public void setProperties(Properties properties) {
        System.out.println(properties);
        super.setProperties(properties);
    }
}

// mybatis-config.xml增加如下配置:
<objectFactory type="org.mybatis.handler.MyObjectFactory">
    <property name="id" value="123"/>
  </objectFactory>

 

7. plugins

MyBatis 允許你在已映射語句執行過程中的某一點進行攔截調用。默認情況下,MyBatis 允許使用插件來攔截的方法調用包括:

  • Executor (update, query, flushStatements, commit, rollback, getTransaction, close, isClosed)
  • ParameterHandler (getParameterObject, setParameters)
  • ResultSetHandler (handleResultSets, handleOutputParameters)
  • StatementHandler (prepare, parameterize, batch, update, query)

這些類中方法的細節可以通過查看每個方法的簽名來發現,或者直接查看 MyBatis 發行包中的源代碼。 如果你想做的不僅僅是監控方法的調用,那么你最好相當了解要重寫的方法的行為。 因為如果在試圖修改或重寫已有方法的行為的時候,你很可能在破壞 MyBatis 的核心模塊。 這些都是更低層的類和方法,所以使用插件的時候要特別當心。

通過 MyBatis 提供的強大機制,使用插件是非常簡單的,只需實現 Interceptor 接口,並指定想要攔截的方法簽名即可。

@Intercepts({@Signature(type = Executor.class, method="update",args={MappedStatement.class,Object.class}), 
    @Signature(type=Executor.class, method="query", args={MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class})})
public class MyPlugins implements Interceptor {

    @Override
    public Object intercept(Invocation arg0) throws Throwable {
        return arg0.proceed();
    }

    @Override
    public Object plugin(Object arg0) {
        return Plugin.wrap(arg0, this);
    }

    @Override
    public void setProperties(Properties arg0) {
        System.out.println(arg0);
    }
}

mybatis-config.xml增加如下配置:

<plugins>
    <plugin interceptor="org.mybatis.handler.MyPlugins">
        <property name="id" value="321"/>
    </plugin>
  </plugins>

8. environments

mybatis可以配置成適應多種環境,這種機制有助於將SQL映射應用於多種數據庫中,現實情況下有多種理由需要這么做。例如:開發,測試和生成環境需要不同的配置;貨站共享相同Schema的多個生成數據庫,想使用相同的SQL映射。

盡管可以配置多個環境,每個SqlSessionFactory實例只能選擇其一。

所以,如果你想連接兩個數據庫,就需要創建兩個SqlSessionFactory實例,每個數據庫對應一個。

為了指定創建哪種環境,只要將它作為可選的參數傳遞給SqlSessionFactoryBuilder即可。可以接受環境配置的兩個方法簽名是:

SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment); SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment, properties);

如果忽略了環境參數,那么默認環境將會被加載,如下所示:

SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader); SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, properties);

環境元素定義了如何配置環境。

<environments default="development"> <environment id="development"> <transactionManager type="JDBC"> <property name="..." value="..."/> </transactionManager> <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>

注意這里的關鍵點:

  • 默認的環境 ID(比如:default="development")。
  • 每個 environment 元素定義的環境 ID(比如:id="development")。
  • 事務管理器的配置(比如:type="JDBC")。
  • 數據源的配置(比如:type="POOLED")。

默認的環境和環境ID是自解釋的,因此一目了然。你可以對環境隨意命名,但一定要保證默認的環境 ID 要匹配其中一個環境 ID。

事務管理器(transactionManager)

在 MyBatis 中有兩種類型的事務管理器(也就是 type=”[JDBC|MANAGED]”):

  • JDBC – 這個配置就是直接使用了 JDBC 的提交和回滾設置,它依賴於從數據源得到的連接來管理事務作用域。
  • MANAGED – 這個配置幾乎沒做什么。它從來不提交或回滾一個連接,而是讓容器來管理事務的整個生命周期(比如 JEE 應用服務器的上下文)。 默認情況下它會關閉連接,然而一些容器並不希望這樣,因此需要將 closeConnection 屬性設置為 false 來阻止它默認的關閉行為。例如:
    <transactionManager type="MANAGED"> <property name="closeConnection" value="false"/> </transactionManager>

提示如果你正在使用 Spring + MyBatis,則沒有必要配置事務管理器, 因為 Spring 模塊會使用自帶的管理器來覆蓋前面的配置。

這兩種事務管理器類型都不需要任何屬性。它們不過是類型別名,換句話說,你可以使用 TransactionFactory 接口的實現類的完全限定名或類型別名代替它們。

public interface TransactionFactory { void setProperties(Properties props); Transaction newTransaction(Connection conn); Transaction newTransaction(DataSource dataSource, TransactionIsolationLevel level, boolean autoCommit); }

任何在 XML 中配置的屬性在實例化之后將會被傳遞給 setProperties() 方法。你也需要創建一個 Transaction 接口的實現類,這個接口也很簡單:

public interface Transaction { Connection getConnection() throws SQLException; void commit() throws SQLException; void rollback() throws SQLException; void close() throws SQLException; Integer getTimeout() throws SQLException; }

使用這兩個接口,你可以完全自定義 MyBatis 對事務的處理。

數據源(dataSource)

dataSource 元素使用標准的 JDBC 數據源接口來配置 JDBC 連接對象的資源。

  • 許多 MyBatis 的應用程序會按示例中的例子來配置數據源。雖然這是可選的,但為了使用延遲加載,數據源是必須配置的。

有三種內建的數據源類型(也就是 type=”[UNPOOLED|POOLED|JNDI]”):

UNPOOLED– 這個數據源的實現只是每次被請求時打開和關閉連接。雖然有點慢,但對於在數據庫連接可用性方面沒有太高要求的簡單應用程序來說,是一個很好的選擇。 不同的數據庫在性能方面的表現也是不一樣的,對於某些數據庫來說,使用連接池並不重要,這個配置就很適合這種情形。UNPOOLED 類型的數據源僅僅需要配置以下 5 種屬性:

  • driver – 這是 JDBC 驅動的 Java 類的完全限定名(並不是 JDBC 驅動中可能包含的數據源類)。
  • url – 這是數據庫的 JDBC URL 地址。
  • username – 登錄數據庫的用戶名。
  • password – 登錄數據庫的密碼。
  • defaultTransactionIsolationLevel – 默認的連接事務隔離級別。

作為可選項,你也可以傳遞屬性給數據庫驅動。要這樣做,屬性的前綴為“driver.”,例如:

  • driver.encoding=UTF8

這將通過 DriverManager.getConnection(url,driverProperties) 方法傳遞值為 UTF8 的 encoding 屬性給數據庫驅動。

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 中查找。

和其他數據源配置類似,可以通過添加前綴“env.”直接把屬性傳遞給初始上下文。比如:

  • env.encoding=UTF8

這就會在初始上下文(InitialContext)實例化時往它的構造方法傳遞值為 UTF8 的 encoding 屬性。

你可以通過實現接口 org.apache.ibatis.datasource.DataSourceFactory 來使用第三方數據源:

public interface DataSourceFactory { void setProperties(Properties props); DataSource getDataSource(); }

org.apache.ibatis.datasource.unpooled.UnpooledDataSourceFactory 可被用作父類來構建新的數據源適配器,比如下面這段插入 C3P0 數據源所必需的代碼:

import org.apache.ibatis.datasource.unpooled.UnpooledDataSourceFactory; import com.mchange.v2.c3p0.ComboPooledDataSource; public class C3P0DataSourceFactory extends UnpooledDataSourceFactory { public C3P0DataSourceFactory() { this.dataSource = new ComboPooledDataSource(); } }

為了令其工作,記得為每個希望 MyBatis 調用的 setter 方法在配置文件中增加對應的屬性。下面是一個可以連接至 PostgreSQL 數據庫的例子:

<dataSource type="org.myproject.C3P0DataSourceFactory"> <property name="driver" value="org.postgresql.Driver"/> <property name="url" value="jdbc:postgresql:mydb"/> <property name="username" value="postgres"/> <property name="password" value="root"/> </dataSource>

9. databaseIdProvider

MyBatis 可以根據不同的數據庫廠商執行不同的語句,這種多廠商的支持是基於映射語句中的 databaseId 屬性。 MyBatis 會加載不帶 databaseId 屬性和帶有匹配當前數據庫 databaseId 屬性的所有語句。 如果同時找到帶有 databaseId 和不帶 databaseId 的相同語句,則后者會被舍棄。 為支持多廠商特性只要像下面這樣在 mybatis-config.xml 文件中加入 databaseIdProvider 即可:

<databaseIdProvider type="DB_VENDOR" />

這里的 DB_VENDOR 會通過 DatabaseMetaData#getDatabaseProductName() 返回的字符串進行設置。 由於通常情況下這個字符串都非常長而且相同產品的不同版本會返回不同的值,所以最好通過設置屬性別名來使其變短,如下:

<databaseIdProvider type="DB_VENDOR"> <property name="SQL Server" value="sqlserver"/> <property name="DB2" value="db2"/> <property name="Oracle" value="oracle" /> </databaseIdProvider>

在提供了屬性別名時,DB_VENDOR databaseIdProvider 將被設置為第一個能匹配數據庫產品名稱的屬性鍵對應的值,如果沒有匹配的屬性將會設置為 “null”。 在這個例子中,如果 getDatabaseProductName() 返回“Oracle (DataDirect)”,databaseId 將被設置為“oracle”。

你可以通過實現接口 org.apache.ibatis.mapping.DatabaseIdProvider 並在 mybatis-config.xml 中注冊來構建自己的 DatabaseIdProvider:

public interface DatabaseIdProvider { void setProperties(Properties p); String getDatabaseId(DataSource dataSource) throws SQLException; }

10. mappers

既然 MyBatis 的行為已經由上述元素配置完了,我們現在就要定義 SQL 映射語句了。但是首先我們需要告訴 MyBatis 到哪里去找到這些語句。 Java 在自動查找這方面沒有提供一個很好的方法,所以最佳的方式是告訴 MyBatis 到哪里去找映射文件。你可以使用相對於類路徑的資源引用, 或完全限定資源定位符(包括 file:/// 的 URL),或類名和包名等。例如:  

<!-- 使用相對於類路徑的資源引用 --> <mappers> <mapper resource="org/mybatis/builder/AuthorMapper.xml"/> <mapper resource="org/mybatis/builder/BlogMapper.xml"/> <mapper resource="org/mybatis/builder/PostMapper.xml"/> </mappers>
<!-- 使用完全限定資源定位符(URL) --> <mappers> <mapper url="file:///var/mappers/AuthorMapper.xml"/> <mapper url="file:///var/mappers/BlogMapper.xml"/> <mapper url="file:///var/mappers/PostMapper.xml"/> </mappers>
<!-- 使用映射器接口實現類的完全限定類名 --> <mappers> <mapper class="org.mybatis.builder.AuthorMapper"/> <mapper class="org.mybatis.builder.BlogMapper"/> <mapper class="org.mybatis.builder.PostMapper"/> </mappers>
<!-- 將包內的映射器接口實現全部注冊為映射器 --> <mappers> <package name="org.mybatis.builder"/> </mappers>

 

x. 參考資料

http://www.mybatis.org/mybatis-3/zh/configuration.html

http://www.cnblogs.com/lujiango/p/8631744.html


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM