環(huán)境配置（environments）

MyBatis 可以配置成適應(yīng)多種環(huán)境，這種機(jī)制有助于將 SQL 映射應(yīng)用于多種數(shù)據(jù)庫(kù)之中， 現(xiàn)實(shí)情況下有多種理由需要這么做。例如，開(kāi)發(fā)、測(cè)試和生產(chǎn)環(huán)境需要有不同的配置；或者想在具有相同Schema的多個(gè)生產(chǎn)數(shù)據(jù)庫(kù)中使用相同的 SQL 映射。還有許多類似的使用場(chǎng)景。

不過(guò)要記住：盡管可以配置多個(gè)環(huán)境，但每個(gè)SqlSessionFactory實(shí)例只能選擇一種環(huán)境。

所以，如果你想連接兩個(gè)數(shù)據(jù)庫(kù)，就需要?jiǎng)?chuàng)建兩個(gè)SqlSessionFactory 實(shí)例，每個(gè)數(shù)據(jù)庫(kù)對(duì)應(yīng)一個(gè)。而如果是三個(gè)數(shù)據(jù)庫(kù)，就需要三個(gè)實(shí)例，依此類推，記起來(lái)很簡(jiǎn)單：

• 每個(gè)數(shù)據(jù)庫(kù)對(duì)應(yīng)一個(gè) ?SqlSessionFactory實(shí)例

為了指定創(chuàng)建哪種環(huán)境，只要將它作為可選的參數(shù)傳遞給SqlSessionFactoryBuilder即可?？梢越邮墉h(huán)境配置的兩個(gè)方法簽名是：

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

如果忽略了環(huán)境參數(shù)，那么將會(huì)加載默認(rèn)環(huán)境，如下所示：

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

?environments ?元素定義了如何配置環(huán)境。

<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>

注意一些關(guān)鍵點(diǎn):

• 默認(rèn)使用的環(huán)境 ID（比如：default="development"）。
• 每個(gè) ?environment元素定義的環(huán)境 ID（比如：id="development"）。
• 事務(wù)管理器的配置（比如：type="JDBC"）。
• 數(shù)據(jù)源的配置（比如：type="POOLED"）。

默認(rèn)環(huán)境和環(huán)境 ID 顧名思義。 環(huán)境可以隨意命名，但務(wù)必保證默認(rèn)的環(huán)境 ID 要匹配其中一個(gè)環(huán)境 ID。

事務(wù)管理器（transactionManager）

在 MyBatis 中有兩種類型的事務(wù)管理器（也就是 type="[JDBC|MANAGED]"）：

• ?JDBC– 這個(gè)配置直接使用了 JDBC 的提交和回滾設(shè)施，它依賴從數(shù)據(jù)源獲得的連接來(lái)管理事務(wù)作用域。
• ?MANAGED– 這個(gè)配置幾乎沒(méi)做什么。它從不提交或回滾一個(gè)連接，而是讓容器來(lái)管理事務(wù)的整個(gè)生命周期（比如 JEE 應(yīng)用服務(wù)器的上下文）。 默認(rèn)情況下它會(huì)關(guān)閉連接。然而一些容器并不希望連接被關(guān)閉，因此需要將 ?closeConnection屬性設(shè)置為 ?false來(lái)阻止默認(rèn)的關(guān)閉行為。例如:

<transactionManager type="MANAGED">
  <property name="closeConnection" value="false"/>
</transactionManager>

如果你正在使用 Spring + MyBatis，則沒(méi)有必要配置事務(wù)管理器，因?yàn)?nbsp;Spring 模塊會(huì)使用自帶的管理器來(lái)覆蓋前面的配置。

這兩種事務(wù)管理器類型都不需要設(shè)置任何屬性。它們其實(shí)是類型別名，換句話說(shuō)，你可以用TransactionFactory接口實(shí)現(xiàn)類的全限定名或類型別名代替它們。

public interface TransactionFactory {
  default void setProperties(Properties props) { // 從 3.5.2 開(kāi)始，該方法為默認(rèn)方法
    // 空實(shí)現(xiàn)
  }
  Transaction newTransaction(Connection conn);
  Transaction newTransaction(DataSource dataSource, TransactionIsolationLevel level, boolean autoCommit);
}

在事務(wù)管理器實(shí)例化后，所有在 XML 中配置的屬性將會(huì)被傳遞給 ?setProperties()? 方法。你的實(shí)現(xiàn)還需要?jiǎng)?chuàng)建一個(gè) ?Transaction接口的實(shí)現(xiàn)類，這個(gè)接口也很簡(jiǎn)單：

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

使用這兩個(gè)接口，你可以完全自定義 MyBatis 對(duì)事務(wù)的處理。

數(shù)據(jù)源（dataSource）

?dataSource元素使用標(biāo)準(zhǔn)的JDBC數(shù)據(jù)源接口來(lái)配置 ?JDBC連接對(duì)象的資源。

• 大多數(shù) MyBatis 應(yīng)用程序會(huì)按示例中的例子來(lái)配置數(shù)據(jù)源。雖然數(shù)據(jù)源配置是可選的，但如果要啟用延遲加載特性，就必須配置數(shù)據(jù)源。

有三種內(nèi)建的數(shù)據(jù)源類型（也就是 ?type="[UNPOOLED|POOLED|JNDI]"?）：

?UNPOOLED?– 這個(gè)數(shù)據(jù)源的實(shí)現(xiàn)會(huì)每次請(qǐng)求時(shí)打開(kāi)和關(guān)閉連接。雖然有點(diǎn)慢，但對(duì)那些數(shù)據(jù)庫(kù)連接可用性要求不高的簡(jiǎn)單應(yīng)用程序來(lái)說(shuō)，是一個(gè)很好的選擇。 性能表現(xiàn)則依賴于使用的數(shù)據(jù)庫(kù)，對(duì)某些數(shù)據(jù)庫(kù)來(lái)說(shuō)，使用連接池并不重要，這個(gè)配置就很適合這種情形。?UNPOOLED ?類型的數(shù)據(jù)源僅僅需要配置以下 6 種屬性：

• ?driver ?– 這是 JDBC 驅(qū)動(dòng)的 Java 類全限定名（并不是 JDBC 驅(qū)動(dòng)中可能包含的數(shù)據(jù)源類）。
• ?url ?– 這是數(shù)據(jù)庫(kù)的 JDBC URL 地址。
• ?username ?– 登錄數(shù)據(jù)庫(kù)的用戶名。
• ?password ?– 登錄數(shù)據(jù)庫(kù)的密碼。
• ?defaultTransactionIsolationLevel ?– 默認(rèn)的連接事務(wù)隔離級(jí)別。
• ?defaultNetworkTimeout ?– 等待數(shù)據(jù)庫(kù)操作完成的默認(rèn)網(wǎng)絡(luò)超時(shí)時(shí)間（單位：毫秒）。查看 java.sql.Connection#setNetworkTimeout() 的 API 文檔以獲取更多信息。

作為可選項(xiàng)，你也可以傳遞屬性給數(shù)據(jù)庫(kù)驅(qū)動(dòng)。只需在屬性名加上“?driver.?”前綴即可，例如：

• ?driver.encoding=UTF8?

這將通過(guò) ?DriverManager.getConnection(url, driverProperties)? 方法傳遞值為 UTF8 的 ?encoding ?屬性給數(shù)據(jù)庫(kù)驅(qū)動(dòng)。

?POOLED?– 這種數(shù)據(jù)源的實(shí)現(xiàn)利用“池”的概念將 ?JDBC連接對(duì)象組織起來(lái)，避免了創(chuàng)建新的連接實(shí)例時(shí)所必需的初始化和認(rèn)證時(shí)間。 這種處理方式很流行，能使并發(fā) Web 應(yīng)用快速響應(yīng)請(qǐng)求。

除了上述提到 ?UNPOOLED下的屬性外，還有更多屬性用來(lái)配置 ?POOLED ?的數(shù)據(jù)源：

• ?poolMaximumActiveConnections ?– 在任意時(shí)間可存在的活動(dòng)（正在使用）連接數(shù)量，默認(rèn)值：10
• ?poolMaximumIdleConnections ?– 任意時(shí)間可能存在的空閑連接數(shù)。
• ?poolMaximumCheckoutTime ?– 在被強(qiáng)制返回之前，池中連接被檢出（checked out）時(shí)間，默認(rèn)值：20000 毫秒（即 20 秒）
• ?poolTimeToWait ?– 這是一個(gè)底層設(shè)置，如果獲取連接花費(fèi)了相當(dāng)長(zhǎng)的時(shí)間，連接池會(huì)打印狀態(tài)日志并重新嘗試獲取一個(gè)連接（避免在誤配置的情況下一直失敗且不打印日志），默認(rèn)值：20000 毫秒（即 20 秒）。
• ?poolMaximumLocalBadConnectionTolerance ?– 這是一個(gè)關(guān)于壞連接容忍度的底層設(shè)置， 作用于每一個(gè)嘗試從緩存池獲取連接的線程。 如果這個(gè)線程獲取到的是一個(gè)壞的連接，那么這個(gè)數(shù)據(jù)源允許這個(gè)線程嘗試重新獲取一個(gè)新的連接，但是這個(gè)重新嘗試的次數(shù)不應(yīng)該超過(guò) poolMaximumIdleConnections 與 poolMaximumLocalBadConnectionTolerance 之和。 默認(rèn)值：3（新增于 3.4.5）
• ?poolPingQuery ?– 發(fā)送到數(shù)據(jù)庫(kù)的偵測(cè)查詢，用來(lái)檢驗(yàn)連接是否正常工作并準(zhǔn)備接受請(qǐng)求。默認(rèn)是“NO PING QUERY SET”，這會(huì)導(dǎo)致多數(shù)數(shù)據(jù)庫(kù)驅(qū)動(dòng)出錯(cuò)時(shí)返回恰當(dāng)?shù)腻e(cuò)誤消息。
• ?poolPingEnabled ?– 是否啟用偵測(cè)查詢。若開(kāi)啟，需要設(shè)置 poolPingQuery 屬性為一個(gè)可執(zhí)行的 SQL 語(yǔ)句（最好是一個(gè)速度非?？斓?nbsp;SQL 語(yǔ)句），默認(rèn)值：false。
• ?poolPingConnectionsNotUsedFor ?– 配置 poolPingQuery 的頻率?？梢员辉O(shè)置為和數(shù)據(jù)庫(kù)連接超時(shí)時(shí)間一樣，來(lái)避免不必要的偵測(cè)，默認(rèn)值：0（即所有連接每一時(shí)刻都被偵測(cè) — 當(dāng)然僅當(dāng) poolPingEnabled 為 true 時(shí)適用）。

?JNDI ?– 這個(gè)數(shù)據(jù)源實(shí)現(xiàn)是為了能在如 EJB 或應(yīng)用服務(wù)器這類容器中使用，容器可以集中或在外部配置數(shù)據(jù)源，然后放置一個(gè) JNDI 上下文的數(shù)據(jù)源引用。這種數(shù)據(jù)源配置只需要兩個(gè)屬性：

• ?initial_context ?– 這個(gè)屬性用來(lái)在 InitialContext 中尋找上下文（即，initialContext.lookup(initial_context)）。這是個(gè)可選屬性，如果忽略，那么將會(huì)直接從 InitialContext 中尋找 data_source 屬性。
• ?data_source ?– 這是引用數(shù)據(jù)源實(shí)例位置的上下文路徑。提供了 initial_context 配置時(shí)會(huì)在其返回的上下文中進(jìn)行查找，沒(méi)有提供時(shí)則直接在 InitialContext 中查找。

和其他數(shù)據(jù)源配置類似，可以通過(guò)添加前綴“?env.?”直接把屬性傳遞給 ?InitialContext?。比如：

• ?env.encoding=UTF8?

這就會(huì)在 ?InitialContext ?實(shí)例化時(shí)往它的構(gòu)造方法傳遞值為 UTF8 的 ?encoding ?屬性。

你可以通過(guò)實(shí)現(xiàn)接口 ?org.apache.ibatis.datasource.DataSourceFactory? 來(lái)使用第三方數(shù)據(jù)源實(shí)現(xiàn)：

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

?org.apache.ibatis.datasource.unpooled.UnpooledDataSourceFactory? 可被用作父類來(lái)構(gòu)建新的數(shù)據(jù)源適配器，比如下面這段插入 C3P0 數(shù)據(jù)源所必需的代碼：

import org.apache.ibatis.datasource.unpooled.UnpooledDataSourceFactory;
import com.mchange.v2.c3p0.ComboPooledDataSource;

public class C3P0DataSourceFactory extends UnpooledDataSourceFactory {

  public C3P0DataSourceFactory() {
    this.dataSource = new ComboPooledDataSource();
  }
}

為了令其工作，記得在配置文件中為每個(gè)希望 MyBatis 調(diào)用的 ?setter ?方法增加對(duì)應(yīng)的屬性。 下面是一個(gè)可以連接至 PostgreSQL 數(shù)據(jù)庫(kù)的例子：

<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>