建站
咨詢
售后
建站咨詢
新聞中心
環(huán)境配置（environments）
Mybatis 可以配置成適應多種環(huán)境，這種機制有助于將 SQL 映射應用于多種數(shù)據(jù)庫之中， 現(xiàn)實情況下有多種理由需要這么做。例如，開發(fā)、測試和生產(chǎn)環(huán)境需要有不同的配置；或者想在具有相同Schema的多個生產(chǎn)數(shù)據(jù)庫中使用相同的 SQL 映射。還有許多類似的使用場景。
創(chuàng)新互聯(lián)建站堅持“要么做到，要么別承諾”的工作理念，服務領域包括：成都網(wǎng)站制作、成都做網(wǎng)站、企業(yè)官網(wǎng)、英文網(wǎng)站、手機端網(wǎng)站、網(wǎng)站推廣等服務，滿足客戶于互聯(lián)網(wǎng)時代的錫林浩特網(wǎng)站設計、移動媒體設計的需求，幫助企業(yè)找到有效的互聯(lián)網(wǎng)解決方案。努力成為您成熟可靠的網(wǎng)絡建設合作伙伴！
不過要記?。罕M管可以配置多個環(huán)境，但每個SqlSessionFactory實例只能選擇一種環(huán)境。
所以，如果你想連接兩個數(shù)據(jù)庫，就需要創(chuàng)建兩個SqlSessionFactory 實例，每個數(shù)據(jù)庫對應一個。而如果是三個數(shù)據(jù)庫，就需要三個實例，依此類推，記起來很簡單：
- 每個數(shù)據(jù)庫對應一個 ?
SqlSessionFactory實例
為了指定創(chuàng)建哪種環(huán)境，只要將它作為可選的參數(shù)傳遞給SqlSessionFactoryBuilder即可?？梢越邮墉h(huán)境配置的兩個方法簽名是：
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment);
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment, properties);如果忽略了環(huán)境參數(shù)，那么將會加載默認環(huán)境，如下所示：
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader);
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, properties);?environments ?元素定義了如何配置環(huán)境。
注意一些關鍵點:
- 默認使用的環(huán)境 ID（比如：default="development"）。
- 每個 ?
environment元素定義的環(huán)境 ID（比如：id="development"）。 - 事務管理器的配置（比如：type="JDBC"）。
- 數(shù)據(jù)源的配置（比如：type="POOLED"）。
默認環(huán)境和環(huán)境 ID 顧名思義。 環(huán)境可以隨意命名，但務必保證默認的環(huán)境 ID 要匹配其中一個環(huán)境 ID。
事務管理器（transactionManager）
在 MyBatis 中有兩種類型的事務管理器（也就是 type="[JDBC|MANAGED]"）：
- ?
JDBC– 這個配置直接使用了 JDBC 的提交和回滾設施，它依賴從數(shù)據(jù)源獲得的連接來管理事務作用域。 - ?
MANAGED– 這個配置幾乎沒做什么。它從不提交或回滾一個連接，而是讓容器來管理事務的整個生命周期（比如 JEE 應用服務器的上下文）。 默認情況下它會關閉連接。然而一些容器并不希望連接被關閉，因此需要將 ?closeConnection屬性設置為 ?false來阻止默認的關閉行為。例如:
如果你正在使用 Spring + MyBatis，則沒有必要配置事務管理器，因為 Spring 模塊會使用自帶的管理器來覆蓋前面的配置。
這兩種事務管理器類型都不需要設置任何屬性。它們其實是類型別名，換句話說，你可以用TransactionFactory接口實現(xiàn)類的全限定名或類型別名代替它們。
public interface TransactionFactory {
default void setProperties(Properties props) { // 從 3.5.2 開始，該方法為默認方法
// 空實現(xiàn)
}
Transaction newTransaction(Connection conn);
Transaction newTransaction(DataSource dataSource, TransactionIsolationLevel level, boolean autoCommit);
}在事務管理器實例化后，所有在 XML 中配置的屬性將會被傳遞給 ?setProperties()? 方法。你的實現(xiàn)還需要創(chuàng)建一個 ?Transaction接口的實現(xiàn)類，這個接口也很簡單：
public interface Transaction {
Connection getConnection() throws SQLException;
void commit() throws SQLException;
void rollback() throws SQLException;
void close() throws SQLException;
Integer getTimeout() throws SQLException;
}使用這兩個接口，你可以完全自定義 MyBatis 對事務的處理。
數(shù)據(jù)源（dataSource）
?dataSource元素使用標準的JDBC數(shù)據(jù)源接口來配置 ?JDBC連接對象的資源。
- 大多數(shù) MyBatis 應用程序會按示例中的例子來配置數(shù)據(jù)源。雖然數(shù)據(jù)源配置是可選的，但如果要啟用延遲加載特性，就必須配置數(shù)據(jù)源。
有三種內(nèi)建的數(shù)據(jù)源類型（也就是 ?type="[UNPOOLED|POOLED|JNDI]"?）：
?UNPOOLED?– 這個數(shù)據(jù)源的實現(xiàn)會每次請求時打開和關閉連接。雖然有點慢，但對那些數(shù)據(jù)庫連接可用性要求不高的簡單應用程序來說，是一個很好的選擇。 性能表現(xiàn)則依賴于使用的數(shù)據(jù)庫，對某些數(shù)據(jù)庫來說，使用連接池并不重要，這個配置就很適合這種情形。?UNPOOLED ?類型的數(shù)據(jù)源僅僅需要配置以下 6 種屬性：
- ?
driver?– 這是 JDBC 驅(qū)動的 Java 類全限定名（并不是 JDBC 驅(qū)動中可能包含的數(shù)據(jù)源類）。 - ?
url?– 這是數(shù)據(jù)庫的 JDBC URL 地址。 - ?
username?– 登錄數(shù)據(jù)庫的用戶名。 - ?
password?– 登錄數(shù)據(jù)庫的密碼。 - ?
defaultTransactionIsolationLevel?– 默認的連接事務隔離級別。 - ?
defaultNetworkTimeout?– 等待數(shù)據(jù)庫操作完成的默認網(wǎng)絡超時時間（單位：毫秒）。查看 java.sql.Connection#setNetworkTimeout() 的 API 文檔以獲取更多信息。
作為可選項，你也可以傳遞屬性給數(shù)據(jù)庫驅(qū)動。只需在屬性名加上“?driver.?”前綴即可，例如：
- ?
driver.encoding=UTF8?
這將通過 ?DriverManager.getConnection(url, driverProperties)? 方法傳遞值為 UTF8 的 ?encoding ?屬性給數(shù)據(jù)庫驅(qū)動。
?POOLED?– 這種數(shù)據(jù)源的實現(xiàn)利用“池”的概念將 ?JDBC連接對象組織起來，避免了創(chuàng)建新的連接實例時所必需的初始化和認證時間。 這種處理方式很流行，能使并發(fā) Web 應用快速響應請求。
除了上述提到 ?UNPOOLED下的屬性外，還有更多屬性用來配置 ?POOLED ?的數(shù)據(jù)源：
- ?
poolMaximumActiveConnections?– 在任意時間可存在的活動（正在使用）連接數(shù)量，默認值：10 - ?
poolMaximumIdleConnections?– 任意時間可能存在的空閑連接數(shù)。 - ?
poolMaximumCheckoutTime?– 在被強制返回之前，池中連接被檢出（checked out）時間，默認值：20000 毫秒（即 20 秒） - ?
poolTimeToWait?– 這是一個底層設置，如果獲取連接花費了相當長的時間，連接池會打印狀態(tài)日志并重新嘗試獲取一個連接（避免在誤配置的情況下一直失敗且不打印日志），默認值：20000 毫秒（即 20 秒）。 - ?
poolMaximumLocalBadConnectionTolerance?– 這是一個關于壞連接容忍度的底層設置， 作用于每一個嘗試從緩存池獲取連接的線程。 如果這個線程獲取到的是一個壞的連接，那么這個數(shù)據(jù)源允許這個線程嘗試重新獲取一個新的連接，但是這個重新嘗試的次數(shù)不應該超過 poolMaximumIdleConnections 與 poolMaximumLocalBadConnectionTolerance 之和。 默認值：3（新增于 3.4.5） - ?
poolPingQuery?– 發(fā)送到數(shù)據(jù)庫的偵測查詢，用來檢驗連接是否正常工作并準備接受請求。默認是“NO PING QUERY SET”，這會導致多數(shù)數(shù)據(jù)庫驅(qū)動出錯時返回恰當?shù)腻e誤消息。 - ?
poolPingEnabled?– 是否啟用偵測查詢。若開啟，需要設置 poolPingQuery 屬性為一個可執(zhí)行的 SQL 語句（最好是一個速度非?？斓?nbsp;SQL 語句），默認值：false。 - ?
poolPingConnectionsNotUsedFor?– 配置 poolPingQuery 的頻率?？梢员辉O置為和數(shù)據(jù)庫連接超時時間一樣，來避免不必要的偵測，默認值：0（即所有連接每一時刻都被偵測 — 當然僅當 poolPingEnabled 為 true 時適用）。
?JNDI ?– 這個數(shù)據(jù)源實現(xiàn)是為了能在如 EJB 或應用服務器這類容器中使用，容器可以集中或在外部配置數(shù)據(jù)源，然后放置一個 JNDI 上下文的數(shù)據(jù)源引用。這種數(shù)據(jù)源配置只需要兩個屬性：
- ?
initial_context?– 這個屬性用來在 InitialContext 中尋找上下文（即，initialContext.lookup(initial_context)）。這是個可選屬性，如果忽略，那么將會直接從 InitialContext 中尋找 data_source 屬性。 - ?
data_source?– 這是引用數(shù)據(jù)源實例位置的上下文路徑。提供了 initial_context 配置時會在其返回的上下文中進行查找，沒有提供時則直接在 InitialContext 中查找。
和其他數(shù)據(jù)源配置類似，可以通過添加前綴“?env.?”直接把屬性傳遞給 ?InitialContext?。比如：
- ?
env.encoding=UTF8?
這就會在 ?InitialContext ?實例化時往它的構造方法傳遞值為 UTF8 的 ?encoding ?屬性。
你可以通過實現(xiàn)接口 ?org.apache.ibatis.datasource.DataSourceFactory? 來使用第三方數(shù)據(jù)源實現(xiàn)：
public interface DataSourceFactory {
void setProperties(Properties props);
DataSource getDataSource();
}?org.apache.ibatis.datasource.unpooled.UnpooledDataSourceFactory? 可被用作父類來構建新的數(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();
}
}為了令其工作，記得在配置文件中為每個希望 MyBatis 調(diào)用的 ?setter ?方法增加對應的屬性。 下面是一個可以連接至 PostgreSQL 數(shù)據(jù)庫的例子：
文章標題：創(chuàng)新互聯(lián)MyBatis教程：MyBatis 3 XML配置-環(huán)境配置
URL鏈接：http://www.dlmjj.cn/article/dhsoiic.html
