iBATIS.NET API基礎淺析
有了對iBATIS.NET配置系統的一些認識后，現在就先來簡單了解一下，iBATIS.NET是通過什么的方式去調用映射文件的SQL語句的。這對我們接下來深入了解有很大的幫助。
對于簡單的iBatis應用場合來說，我想大部分都是集中在與SqlMapper對象打交道。這個類應該說是一個工具類，因為我們一般都是直接調用這個類的方法去執行QUID操作，但是它卻不是真正的去做這些事情。因為iBatis內部有很多的類，對象之間的關系是非常復雜的，如果讓客戶直接去使用它內部方法，無疑增加了使用的復雜性，同樣也會產生很多的冗余代碼。因此這里它使用外觀設計模式，通過SqlMapper類封裝了iBatis執行數據庫訪問的復雜操作，包括打開一個會話(Session)，獲取返回IMappedStatement對象實例，執行數據庫訪問，關閉連接等相關操作。這樣我們在使用iBatis API的時候就可以非常簡單調用的一個方法，就可以做所有的事情了。比如查詢接口public IList QueryForList(string statementName, object parameterObject)，它的內部實現代碼是這樣的。
- IList list1;
- bool flag1 = false;
- IDalSession session1 = this._sessionHolder.LocalSession;
- if (session1 == null)
- {
- session1 = new SqlMapSession(this.DataSource);
- session1.OpenConnection();
- flag1 = true;
- }
- IMappedStatement statement1 = this.GetMappedStatement(statementName);
- try
- {
- list1 = statement1.ExecuteQueryForList(session1, parameterObject);
- }
- catch
- {
- throw;
- }
- finally
- {
- if (flag1)
- {
- session1.CloseConnection();
- }
- }
- return list1;
那這些代碼如果直接在客戶代碼中去實現，可想而知工作量會有多大。并且還法保證正確性。
以上簡單看了一個SqlMapper的作用，那該怎樣實例化這個對象呢？實例化它也是一個非常簡單的事情。在iBATIS.NET中，SqlMapper對象默認是一個單件模式的實現。通過Mapper類的靜態Instance屬性來實例化一個SqlMapper對象。這樣的設計可能有一部分是出于性能方面的考慮。因為在初始化SqlMapper對象，需要初始iBatis運行環境配置，讀取和初步解析包含的各個映射文件，所以在在系統運行時第一次調用iBATIS.NET API的時候，可能會需要比較長來處理這個配置。Mapper.Instance屬性的實現如下：
- public static SqlMapper Instance()
- {
- if (Mapper._mapper == null)
- {
- lock (typeof(SqlMapper))
- {
- if (Mapper._mapper == null)
- {
- Mapper.InitMapper();
- }
- }
- }
- return Mapper._mapper;
- }
所以在使用API的時候可以像下面的這么簡單：
- Mapper.Instance().Insert("ContentObject_DefaultInsert", p_dataObject);
當然，如果愿意而且有必要的話，也完全可以由自己來實例化這個對象，我們可以直接使用DomSqlMapBuilder，它為我們提供這樣的擴展能力，通過它的多種實例方法都可以返回出SqlMapper對象：Build，Configure，ConfigureAndWatch。在需要用到多個數據庫或是多種不同數據庫類型的場合下，這種方法是非常有用的。
注意：在使用一個接口時，使用的statementName要在對應類型的statement類型。比如在使用Insert接口時，如果你指定的是一個select類型配置語句的話，那將會拋出異常。因為每一種statement類型都對應一種類型，比如如select 類型的配置語句對應的是SelectMappedStatement類，它是從MappedStatement繼承下來，而它的ExcuteInsert方法是這樣實現的
- public override object ExecuteInsert(IDalSession session, object parameterObject)
- {
- throw new DataMapperException("Update statements cannot be executed as a query insert.");
- }
這樣就保證了每一種語句類型的職責明確。
iBATIS.NET API基礎就向你介紹到這里，希望對你了解iBATIS.NET API基礎有所幫助。
【編輯推薦】
