Ibatis學習總結6--使用 SQL Map API 編程，ibatis6--

Ibatis學習總結6--使用 SQL Map API 編程，ibatis6--

SQL Map API 力求簡潔。它為程式員提供 4 種功能：配置一個 SQL Map，執行 SQL update操作，執行查詢語句以取得一個對象，以及執行查詢語句以取得一個對象的 List。

• 配置 SQL Map

一旦您建立了 SQL Map XML 定義檔案和 SQL Map 設定檔，配置 SQL Map 就是一件 極其簡單的事情。SQL Map 使用 XmlSqlMapClientBuilder 來建立。這個類有一個靜態方法 叫 buildSqlMap。方法 buildSqlMap 簡單地用一個 Reader 對象為參數，讀入 sqlMap-config.xml 檔案（不必是這個檔案名稱）的內容。

1 String resource = “com/ibatis/example/sqlMap-config.xml”; 2 Reader reader = Resources.getResourceAsReader (resource); 3 SqlMapClient sqlMap = SqlMapClientBuilder.buildSqlMap(reader);

• 交易處理

  預設情況下 ，調用 SqlMapClient  對象的任 意 executeXxxx() 方法將 預設地自 動 COMMIT/ROLLBACK。這意味著每次調用 executeXxxx()方法都是一個獨立的事務。這確實 很簡單，但對於需要在同一個事務中執行多個語句的情況（即只能同時成功或失敗），並不 適用。這正是交易處理要關心的事情。

  如果您在使用 Global Transaction（在 SQL Map 設定檔中設定），您可以使用自動認可 並且可以得到在同一事務中執行的效果。但為了提高效能，最好是明確地劃分事務的範圍， 因為這樣做可以減少串連池的通訊流量和資料庫連接的初始化。

  SqlMapClient 對象擁有讓您定義事務範圍的方法。使用下面 SqlMapClient 類的方法，可 以開始、提交和/或回退事務：

  1 public void startTransaction () throws SQLException 
  　public void commitTransaction () throws SQLException
    public void endTransaction () throws SQLException

  開始一個事務，意味著您從串連池中得到一個串連，開啟它並執行查詢和更新 SQL 操 作。使用交易處理的例子如下：

   1 private Reader reader = new Resources.getResourceAsReader( "com/ibatis/example/sqlMapconfig.xml"); 2 private SqlMapClient sqlMap = XmlSqlMapBuilder.buildSqlMap(reader); 3 public updateItemDescription (String itemId, String newDescription) throws SQLException { 4 try { 5 sqlMap.startTransaction (); 6 Item item = (Item) sqlMap.queryForObject ("getItem", itemId); 7 item.setDescription (newDescription); sqlMap.update ("updateItem", item); sqlMap.commitTransaction (); 8 } finally { 9 10 sqlMap.endTransaction ();11 12 }13 14 }

  注意！事務不能嵌套。在調用 commit（）或 rollback（）之前，從同     一線程多次調用.startTransaction，將引起拋出例外。換句話說，對於每個 SqlMap 執行個體，每個線程最多隻能開啟一個事務。

  注意！SqlMapClient 交易處理使用 Java 的 ThreadLocal 儲存事務對象。這意味著在處理 事務時，每個調用 startTransaction（）的線程，將得到一個唯一的 Connection 對象。將一個 Connection  對象返回資料來源（或關閉串連）唯一的方法是調用 commitTransaction（）或 rollbackTransaction（）方法。否則，會用光串連池中的串連並導致死結。

• 自動的交易處理

  雖然極力推薦使用明確劃分的事務範圍，在簡單需求（通常使唯讀）的情況下，可以使 用簡化的文法。如果您沒有使用 startTransaction（），commitTransation（）和 rollbackTransaction（）方法來明確地劃分事務範圍，事務將會自動執行。例如：

   1 private Reader reader = new Resources.getResourceAsReader 2  3 ("com/ibatis/example/sqlMapconfig.xml"); 4  5 private SqlMapClient sqlMap = XmlSqlMapBuilder.buildSqlMap(reader); 6  7 public updateItemDescription (String itemId, String newDescription) throws SQLException { 8  9 try {10 11 Item item = (Item) sqlMap.queryForObject ("getItem", itemId);12 13 item.setDescription (“TX1”);14 15 //No transaction demarcated, so transaction will be automatic (implied)16 17 sqlMap.update ("updateItem", item); item.setDescription (newDescription); item.setDescription (“TX2”);18 //No transaction demarcated, so transaction will be automatic (implied)19 20 sqlMap.update("updateItem", item);21 22 23 24 } catch (SQLException e) {25 26 throw (SQLException) e.fillInStackTrace();27 28 }29 30 }

  注意！使用自動交易處理要非常小心。雖然看起來很有吸引力，但如果有多個資料更新操作要在同一事務中處理時，您會遇到麻煩。在上面的例子中，如果第二個“updateItem”操作失敗，第一個“updateItem”操作仍然會執行，description 會更新成“TX1”。

• 全域（分布式）事務

  SQL Map 架構支援全域事務。全域事務也叫分散式交易，它可以允許您在同一事務中 更新多個資料庫（或其他符合 JTA 規範的資源），即同時成功或失敗。

  * External/Programmatic Global  事務

  您可以選擇外部管理或手工編程管理全域事務，或實現一個象 EJB 一樣的架構。使用 EJB，您可以通過使用 EJB 的描述檔案定義事務範圍。要支 持外部管理或手工編程管理全域事務，必須在 SQL Map 設定檔中(參見前面章節的內容) 設定<transactionManager>的 type 屬性為 EXTERNAL。使用外部管理的全域事務，SQL Map 事務控制方法變得有的多餘，因為事務的開始、提交和回退都由外部的交易管理員來控制。 但是，使用 SqlMapClient 的 startTransaction（），commitTransaction（）或 rollbackTransaction（）來劃分事務範圍（相對於自動的交易處理），還是對提高效能有協助。繼續使用這些方 法，可以保持編程規範的一致性。另一個好處是，在某些情況下，您可能需要改變關閉資源 的順序（不幸的是，不同的應用伺服器和交易管理員具有不同的規則）。除了這些考慮，要 使用全域事務，不需要改變您的 SQL Map 代碼。

  * 受管理的（Managed）全域事務

  SQL Map 架構也可以為您管理全域事務。要支援受管理的全域事務，必須在 SQL Map 設定檔中設定<transactionManager>的 type 屬性為 JTA，並設定“UserTransaction”屬性為 JNDI 的全名，以使 SqlMapClient 執行個體能找到 UserTransaction 對象。

  使用全域事務編程，代碼沒有多大的不同，但有幾個小小的地方要注意。例如：

   1 try { 2  3 orderSqlMap.startTransaction(); storeSqlMap.startTransaction(); orderSqlMap.insertOrder(…); orderSqlMap.updateQuantity(…); 4  5 storeSqlMap.commitTransaction(); 6  7 orderSqlMap.commitTransaction(); 8  9 } finally {10 11 try {12 13 storeSqlMap.endTransaction()14 15 } finally {16 17 orderSqlMap.endTransaction()18 19 }20 21 }

  上面的例子中，假設我們通過兩個 SqlMapClient 來使用兩個不同的資料庫。第一個開始事務的 SqlMapClient（orderSqlMap）同時也開始了一個全域事務。在這之後，所有其他的操作將被看作是這個全域事務的一部分，直到同一個 SqlMapClient（orderSqlMap）調用 commitTransaction（）或 rollbackTransaction（），屆時全域事務被提交並完成其他所有的操 作。

  警告！雖然這些看起來很簡單，但記住不要濫用全域（分布式）事務，這點很重要。這 樣做既有效能方面的考慮，同時也是因為全域事務會讓應用伺服器和資料庫驅動程式的設定 變得更複雜。雖然看起來簡單，您可能還是會遇到一些困難。

• 批處理

  如果要執行很多非查詢（insert/update/delete）的語句，您可能喜歡將它們作為一個批處 理來執行，以減少網路通訊流量，並讓 JDBC Driver 進行最佳化（例如壓縮）。SQL Map API 使用批處理很簡單，可以使用兩個簡單的方法劃分批處理的邊界：

  1 sqlMap.startBatch();2 //…execute statements in between 3 sqlMap.executeBatch();

  當調用 endBatch（）方法時，所有的批處理語句將通過 JDBC Driver 來執行。