iBATIS_初学者必看_学习资料.doc

《iBATIS_初学者必看_学习资料.doc》由会员分享，可在线阅读，更多相关《iBATIS_初学者必看_学习资料.doc（50页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、如有侵权，请联系网站删除，仅供学习与交流iBATIS_初学者必看_学习资料【精品文档】第 50 页开发指南 iBATIS SQLMaps Page 1 of 62iBATIS SQL Maps开发指南Version 2.02004年6月17日Clinton Begin 著刘 涛 译 Clinton Begin 著 刘涛(toleu) 译开发指南 iBATIS SQLMaps Page 2 of 62目 录简介.4关于本文.4SQL Maps (com.ibatis.sqlmap.*).5SQL Map的概念.5SQL Map如何工作？.5安装SQL Maps.6JAR文件和依赖性.6从1.x版

2、本升级.7是否应该升级.7转换XML配置文件（从1.x到2.0）.7使用新的JAR文件.8SQL Map XML配置文件.10元素.11元素.11元素.13元素.13元素.14元素.15SQL Map XML映射文件.17Mapped Statements.18Statement的类型.18SQL 语句.19自动生成的主键.20存储过程.20parameterClass.21parameterMap.21Inline Parameter简介.22resultClass.22resultMap.23cacheModel.23xmlResultName.24Parameter Map 和 Inli

3、ne Parameter.24元素.25Inline Parameter Map.26基本类型输入参数.27Map类型输入参数.28Result Map.28隐式的Result Map.30基本类型的Result（即String，Integer，Boolean）.31 Clinton Begin 著 刘涛(toleu) 译开发指南 iBATIS SQLMaps Page 3 of 62Map类型的Result.31复杂类型属性（即自定义类型的属性）.32避免N1 Select（1:1）.33延迟加载 VS 联合查询（1:1）.33复杂类型集合的属性.34避免N1 Select（1:M和M:N）

4、.34组合键值或多个复杂参数属性.35支持Parameter Map和Result Map的数据类型.36缓存Mapped Statement结果集.36只读 VS 可读写.37Serializable可读写缓存.37缓存类型.38动态Mapped Statement.41二元条件元素.42一元条件元素.43其他元素.43简单的动态SQL元素.44使用SQL Map API编程.46配置SQL Map.46事务处理.46自动的事务处理.47全局（分布式）事务.48批处理.49用SqlMapClient执行SQL语句.49代码例子.52例子1：执行update（insert，update，del

5、ete）.52例子2：查询成对象（select）.52例子3：用预赋值的结果对象查询成对象（select）.52例子4：查询成对象List（select）.52例子5：自动提交.53例子6：用结果集边界查询成对象List（select）.53例子7：用RowHandler执行查询（select）.53例子8：查询成Paginated List（select）.53例子9：查询成Map（select）.53用Jakarta Commons Logging记录SQL Map日志.54配置日志服务.54Java Bean简易教程.56Resources（mon.resource.*）.58Simpl

6、eDataSource（mon.jdbc.*）.60ScriptRunner (mon.jdbc.*).62 Clinton Begin 著 刘涛(toleu) 译开发指南 iBATIS SQLMaps Page 4 of 62简介使用SQL Map，能够大大减少访问关系数据库的代码。SQL Map使用简单的XML配置文件将Java Bean映射成SQL语句，对比其他的数据库持续层和ORM框架（如JDO的实现，Hibernate等），SQL Map最大的优点在于它简单易学。要使用SQL Map，只要熟悉Java Bean，XML和SQL，就能使您充分发挥SQL语句的能力。关于本文本文讨论了iB

7、ATIS SQL Map最重要的特性。本文中没有提及的其他特性，可能以后不再支持或不久将会修改，并且修改时不作通告，因此最好不要使用它们。本文将随着iBatis SQL Map的修改而变更。如果您发现其中的错误，或是觉得某些地方难以理解，请发email 至clinton.begin 。本文是iBatis SQL Maps Developer Guide的中文版，仅供读者参考，最权威的应以Clinton Begin的官方文档为准。如果中文翻译有错误，请通知译者（email：toleu，Blog： Clinton Begin 著 刘涛(toleu) 译开发指南 iBATIS SQLMaps Pag

8、e 5 of 62SQL Maps (com.ibatis.sqlmap.*)SQL Map的概念SQL Map API让开发人员可以轻易地将Java Bean映射成PreparedStatement的输入参数和ResultSet结果集。开发SQL Map的想法很简单：提供一个简洁的架构，能够用20的代码实现80JDBC的功能。SQL Map如何工作？SQL Map提供了一个简洁的框架，使用简单的XML描述文件将Java Bean，Map实现和基本数据类型的包装类（String，Integer等）映射成JDBC的PreparedStatement。以下流程描述了SQL Maps的高层生命周期：

9、将一个对象作为参数（对象可以是Java Bean，Map实现和基本类型的包装类），参数对象将为SQL修改语句和查询语句设定参数值。1) 执行mapped statement。这是SQL Maps最重要的步骤。SQL Map框架将创建一个PreparedStatement实例，用参数对象为PreparedStatement实例设定参数，执行PreparedStatement并从ResultSet中创建结果对象。2) 执行SQL的更新数据语句时，返回受影响的数据行数。执行查询语句时，将返回一个结果对象或对象的集合。和参数对象一样，结果对象可以是Java Bean，Map实现和基本数据类型的包装类。

10、下图描述了以上的执行流程。 Clinton Begin 著 刘涛(toleu) 译开发指南 iBATIS SQLMaps Page 6 of 62安装SQL Maps安装SQL Maps很简单，只要把相关的JAR文件复制到类路径下即可。类路径或者是JVM启动是指定的类路径（java命令参数），或者是Web应用中的/WEB-INF/lib目录。Java类路径的详尽讨论超出了本文的范围，如果您是Java的初学者，请参考以下的资源：安装iBatis需要在类路径下放置以下JAR文件：文件名描述是否必需ibatis-common.jarIBATIS公用的工具类是ibatis-sqlmap.jarIBAT

11、IS SQL Maps框架是ibatis-dao.jarIBATIS DAO 框架否JAR文件和依赖性如果一个框架依赖于太多的JAR文件，就很难与其他的应用和框架集成。IBATIS 2.0的一个主要的关注点是管理并降低JAR文件的依赖性。因此，如果您用的是JDK1.4，IBATIS Clinton Begin 著 刘涛(toleu) 译开发指南 iBATIS SQLMaps Page 7 of 62仅仅依赖于Jakarta Commons Logging框架。可选的JAR文件放在发布版的/lib/optional目录下。它们根据功能来分类。下面列表总结了何时需要使用可选JAR类库。描述何时使用

12、目录1.4以前JDK版本支持如果您使用的JDK版本低于1.4，并且您的应用服务器不提供这些JAR文件，您将需要这些可选的JAR文件/lib/optional/jdbc/lib/optional/jta/lib/optional/xmlIBATIS的向后兼容如果您使用旧的IBATIS（1.x）DAO框架，或旧的SQL Maps（1.x）/lib/optional/compatibility运行时字节码增强如果您需要使用CGLIB2.0字节码增强来提高lazy loading和reflection的性能/lib/optional/enhancementDataSource实现如果您使用Jakart

13、a DBCP连接池/lib/optional/dbcp分布式缓存如果您使用OSCache来支持集中或分布式缓存/lib/optional/cachingLog4J日志如果您需要使用Log4J/lib/optional/logging从1.x版本升级是否应该升级判断您是否需要升级的最好办法是尝试它。下面是几种升级的方法。1. 版本2.0几乎完全保持和1.x版本的向后兼容，因此某些情况下只需用新的JAR文件替代旧的即可。这个升级方法带来的好处最少，但最简单。您无需修改XML文件或Java代码，但会存在某些不兼容的问题。2. 第二种方法是把1.x的XML文件转换成2.0规范，但仍使用1.x的Java

14、 API。除了XML映射文件存在着细微的不兼容之处外，这是个安全的方法。SQL Map框架包括了用来转换XML映射文件的ANT Task（参见下节）。3. 第三种方法是转换XML文件（和第二种方法相同）和Java代码。因为没有转换Java代码的工具，必须手工进行。4. 第四种方法是不必升级。如果您升级有困难，可以让应用继续使用1.x版本。让旧应用继续使用1.x版，在新应用中使用2.0版是个不错的主意。转换XML配置文件（从1.x到2.0）框架的2.0版本包含了一个可以在ANT构建环境中使用的XML文件转换器。虽然转换 Clinton Begin 著 刘涛(toleu) 译开发指南 iBATIS

15、 SQLMaps Page 8 of 62XML配置文件是可选的，但将1.x的配置文件转换成2.0仍然是个好主意。你几乎不会遇到不兼容的文件，并且还可以使用2.0版本新的特性（即使您继续使用1.x的Java API）。XML配置文件转换器在build.xml文件中的例子如下：就像您看到的一样，它和Ant的copy task很相似。事实上它就是Ant的copy task类的子类，因此您可以用这个task完成任何copy task的功能（详细信息请参考Ant的Copy task文档）使用新的JAR文件要升级到2.0，最好删除iBatis原有旧的JAR文件及其依赖JAR类库，并用新的JAR文件替代。

16、但要主要不要删除其他组件或框架还需要的文件。请参考上节关于JAR类库及其依赖性的讨论。下表总结了旧文件及其相应的新文件。旧文件新文件ibatis-db.jar1.2.9b以后的版本，这个文件被分拆成一下3个文件ibatis-common.jaribatis-dao.jaribatis-sqlmap.jaribatis-common.jar（必需）ibatis-sqlmap.jar（必需）ibatis-dao.jar（可选）commons-logging.jarcommons-logging-api.jarcommons-collection.jarcommons-dbcp.jarcommons

17、-pool.jaroscache.jarjta.jarjdbc2_0-stdext.jarxercesImpl.jarxmlParserAPIs.jarcommons-logging-1-0-3.jar（必需）commons-collection-2-1.jar（可选）commons-dbcp-1-1.jar（可选）commons-pool-1-1.jar（可选）oscache-2-0-1.jar（可选）jta-1-0-1a.jar（可选）jdbc2_0-stdext.jar（可选）xercesImpl-2-4-0.jar（可选）xmlParserAPIs-2-4-0.jar（可选）xalan

18、-2-5-2.jar（可选） Clinton Begin 著 刘涛(toleu) 译开发指南 iBATIS SQLMaps Page 9 of 62jdom.jarlog4j-1.2.8.jar（可选）cglib-full-2-0-rc2.jar（可选）本文余下部分将介绍如何使用SQL Maps框架。 Clinton Begin 著 刘涛(toleu) 译开发指南 iBATIS SQLMaps Page 10 of 62SQL Map XML配置文件SQL Map使用XML配置文件统一配置不同的属性，包括DataSource的详细配置信息，SQL Map和其他可选属性，如线程管理等。以下是SQL Map配置文件的一个例子：SqlMapConfig.xml!DOCTYPE sqlMapConfigPUBLIC -/iBATIS.com/DTD SQL Map Config 2.0/EN