Java客戶端對象 · Java 開源項目中文文檔

# Java客戶端對象 MyBatis Generator (MBG)生成幾種類型的Java客戶端對象.用Java的客戶端對象與所產生的XML交互容易得多. 對于配置中的每個表，MBG生成一個或多個Java客戶端對象.如MyBatis的3, 這些都接口映射.對于iBATIS的2.x中，這些都是DAO接口和實現類. 生成Java客戶對象是可選的,由`<javaClientGenerator>`配置. MBGr可以產生以下的Java客戶短對象類型: * 如MyBatis 3.x: * XMLMAPPER - 用與支持MyBatis 3.x映射 * 如iBATIS 2.x: * IBATIS - 使用iBATIS DAO框架 * SPRING - 與Spring框架聯合使用 * GENERIC-CI - 使用不依賴iBATIS數據映射 * GENERIC-SI - 使用不依賴iBATIS數據映射每個字段和方法產生包括JavaDoc標簽`@mbggenerated`.Eclipse插件運行時, 運行中每個字段和方法包括此Javadoc標記將被刪除并替換.在類中的其他任何字段或方法將保持不變. 考慮到這一點,您可以不用擔心加入的字段和方法丟失 -不包括在Javadoc標簽`@mbggenerated`中內容. 離開Eclipse插件,您需要手動合并Java文件,但是使用JavaDoc的 `@mbggenerated`標簽用來了解刪除以前版本的文件是否安全. 注意: 下面描述中"BLOB"指任何列的BLOB數據類型包括BLOB, CLOB, LONGVARCHAR, 和 LONGVARBINARY. ## 通用DAO方法根據表的特性,以及配置選項,Java客戶端自動生成如下方法: * countByExample * deleteByPrimaryKey * deleteByExample * insert * insertSelective * selectByPrimaryKey * selectByExample * selectByExampleWithBLOBs * updateByPrimaryKey (否更新BLOB字段需要重寫方法) * updateByPrimaryKeySelective (只更新參數類非空字段) * updateByExample (否更新BLOB字段需要重寫方法) * updateByExampleSelective (只更新參數類非空字段) 對于包含BLOB的表,MBG通過生成不同的對象和方法使您更容易使用BLOB字段,是否忽略它們,這取決于具體情況. 詳見 [Example類使用說明](exampleClassUsage.html) 中`selectByExample`方法使用. ## XMLMAPPER 客戶端 (MyBatis 3.x) XMLMAPPER客戶端是將接口方法映射到生成的XML映射文件中.例如,MBG自動生成的接口名為`MyTableMapper`.您可以如下使用該接口: ``` SqlSession sqlSession = sqlSessionFactory.openSession(); try { MyTableMapper mapper = sqlSession.getMapper(MyTableMapper.class); List<MyTable> allRecords = mapper.selectByExample(null); } finally { sqlSession.close(); } ``` 有關如何創建實例的詳細信息,請參閱MyBatis文檔怎么創建`sqlSessionFactory`實例. ## IBATIS DAOs (iBATIS 2.x) iBATIS DAO依賴于iBATIS的DAO框架(iBATIS的一個可選部分 - 現在已經過時). 他們繼承SqlMapDaoTemplate類和初始化DAOManager對象的實例,并且調用方法執行不同的語句. MBG不會為您更新“dao.xml”文件 - 您必須添加手動相應的內容. iBATIS DAO框架是一個非常基礎的IoC容器,如果您尚未使用像Spring或PicoContainer的管理依賴關系的框架,iBATIS DAO框架可能會有用. 然而,該框架現在已經過時,我們建議您使用Spring. ## SPRING DAOs (iBATIS 2.x) SPRING DAO依賴于Spring框架.他們繼承Spring的SqlMapClientDaoSupport類通過Spring容器構造DAO. ## GENERIC-CI DAOs (iBATIS 2.x) GENERIC-CI DAO調用iBATIS的SqlMapClient接口.該接口的實例是通過構造函數注入. ## GENERIC-SI DAOs (iBATIS 2.x) GENERIC-SI DAO調用iBATIS的SqlMapClient接口.該接口的實例是通過setter注入.