iBATIS 2.0 开发指南

iBATIS2.0开发指南ibatisQuickStart准备工作构建ibatis基础代码ibatis配置ibatis基础语义XmlSqlMapClientBuilderSqlMapClientSqlMapClient基本操作示例OR映射ibatis高级特性数据关联一对多关联一对一关联延迟加载动态映射事务管理基于JDBC的事务管理机制基于JTA的事务管理机制外部事务管理CacheMEMORY类型Cache与WeakReferenceLRU型CacheFIFO型CacheOSCacheibatisinSpringibatis开发指南相对Hibernate和ApacheOJB等“一站式”ORM解决方案而言，ibatis是一种“半自动化”的ORM实现。所谓“半自动”，可能理解上有点生涩。纵观目前主流的ORM，无论Hibernate还是ApacheOJB，都对数据库结构提供了较为完整的封装，提供了从POJO到数据库表的全套映射机制。程序员往往只需定义好了POJO到数据库表的映射关系，即可通过Hibernate或者OJB提供的方法完成持久层操作。程序员甚至不需要对SQL的熟练掌握，Hibernate/OJB会根据制定的存储逻辑，自动生成对应的SQL并调用JDBC接口加以执行。大多数情况下（特别是对新项目，新系统的开发而言），这样的机制无往不利，大有一统天下的势头。但是，在一些特定的环境下，这种一站式的解决方案却未必灵光。在笔者的系统咨询工作过程中，常常遇到以下情况：1．系统的部分或全部数据来自现有数据库，处于安全考虑，只对开发团队提供几条SelectSQL（或存储过程）以获取所需数据，具体的表结构不予公开。2．开发规范中要求，所有牵涉到业务逻辑部分的数据库操作，必须在数据库层由存储过程实现（就笔者工作所面向的金融行业而言，工商银行、中国银行、交通银行，都在开发规范中严格指定）3．系统数据处理量巨大，性能要求极为苛刻，这往往意味着我们必须通过经过高度优化的SQL语句（或存储过程）才能达到系统性能设计指标。面对这样的需求，再次举起Hibernate大刀，却发现刀锋不再锐利，甚至无法使用，奈何？恍惚之际，只好再摸出JDBC准备拼死一搏，说得未免有些凄凉，直接使用JDBC进行数据库操作实际上也是不错的选择，只是拖沓的数据库访问代码，乏味的字段读取操作令人厌烦。“半自动化”的ibatis，却刚好解决了这个问题。这里的“半自动化”，是相对Hibernate等提供了全面的数据库封装机制的“全自动化”ORM实现而言，“全自动”ORM实现了POJO和数据库表之间的映射，以及SQL的自动生成和执行。而ibatis的着力点，则在于POJO与SQL之间的映射关系。也就是说，ibatis并不会为程序员在运行期自动生成SQL执行。具体的SQL需要程序员编写，然后通过映射配置文件，将SQL所需的参数，以及返回的结果字段映射到指定POJO。使用ibatis提供的ORM机制，对业务逻辑实现人员而言，面对的是纯粹的Java对象，这一层与通过Hibernate实现ORM而言基本一致，而对于具体的数据操作，Hibernate会自动生成SQL语句，而ibatis则要求开发者编写具体的SQL语句。相对Hibernate等“全自动”ORM机制而言，ibatis以SQL开发的工作量和数据库移植性上的让步，为系统设计提供了更大的自由空间。作为“全自动”ORM实现的一种有益补充，ibatis的出现显得别具意义。ibatisQuickStart准备工作1.下载ibatis软件包。2.创建测试数据库，并在数据库中创建一个t_user表，其中包含三个字段：Øid(int)Øname(varchar)Øsex(int)。3.为了使开发过程更加直观，我们需要将ibatis日志打开以便观察ibatis运作的细节。ibatis采用Apachecommonlogging，并结合Apachelog4j作为日志输出组件。在CLASSPATH中新建log4j.properties配置文件，内容如下：log4j.rootLogger=DEBUG,stdoutlog4j.appender.stdout=org.apache.log4j.ConsoleAppenderlog4j.appender.stdout.layout=org.apache.log4j.PatternLayoutlog4j.appender.stdout.layout.ConversionPattern=%c{1}-%m%nlog4j.logger.java.sql.PreparedStatement=DEBUG构建ibatis基础代码ibatis基础代码包括：1．ibatis实例配置一个典型的配置文件如下（具体配置项目的含义见后）：?xmlversion=1.0encoding=UTF-8?!DOCTYPEsqlMapConfigPUBLIC-//iBATIS.com//DTDSQLMapConfig2.0//EN=trueenhancementEnabled=truelazyLoadingEnabled=trueerrorTracingEnabled=truemaxRequests=32maxSessions=10maxTransactions=5useStatementNamespaces=false/transactionManagertype=JDBCdataSourcetype=SIMPLEpropertyname=JDBC.Drivervalue=com.p6spy.engine.spy.P6SpyDriver/propertyname=JDBC.ConnectionURLvalue=jdbc:mysql://localhost/sample/propertyname=JDBC.Usernamevalue=user/propertyname=JDBC.Passwordvalue=mypass/propertyname=Pool.MaximumActiveConnectionsvalue=10/propertyname=Pool.MaximumIdleConnectionsvalue=5/propertyname=Pool.MaximumCheckoutTimevalue=120000/propertyname=Pool.TimeToWaitvalue=500/propertyname=Pool.PingQueryvalue=select1fromACCOUNT/propertyname=Pool.PingEnabledvalue=false/propertyname=Pool.PingConnectionsOlderThanvalue=1/propertyname=Pool.PingConnectionsNotUsedForvalue=1//dataSource/transactionManagersqlMapresource=com/ibatis/sample/User.xml//sqlMapConfig2．POJO（PlainOrdinaryJavaObject）下面是我们用作示例的一个POJO:publicclassUserimplementsSerializable{privateIntegerid;privateStringname;privateIntegersex;privateSetaddresses=newHashSet();/**defaultconstructor*/publicUser(){}publicIntegergetId(){returnthis.id;}publicvoidsetId(Integerid){this.id=id;}publicStringgetName(){returnthis.name;}publicvoidsetName(Stringname){this.name=name;}publicIntegergetSex(){returnthis.sex;}publicvoidsetSex(Integersex){this.sex=sex;}}3．映射文件与Hibernate不同。因为需要人工编写SQL代码，ibatis的映射文件一般采用手动编写（通过Copy/Paste，手工编写映射文件也并没想象中的麻烦）。针对上面POJO的映射代码如下：?xmlversion=1.0encoding=UTF-8?!DOCTYPEsqlMapPUBLIC-//iBATIS.com//DTDSQLMap2.0//EN=UsertypeAliasalias=usertype=com.ibatis.sample.User/selectid=getUserparameterClass=java.lang.StringresultClass=user![CDATA[selectname,sexfromt_userwherename=#name#]]/selectupdateid=updateUserparameterClass=user![CDATA[updatet_usersetname=#name#,sex=#sex#whereid=#id#]]/updateinsertid=insertUserparameterClass=userinsertintot_user(name,sex)values(#name#,#sex#)/insertdeleteid=deleteUserparameterClass=java.lang.Stringdeletefromt_userwhereid=#value#/delete/sqlMap从上面的映射文件可以看出，通过insert、delete、update、select四个节点，我们分别定义了针对TUser对象的增删改查操作。在这四个节点中，我们指定了对应的SQL语句，以update节点为例：……updateid=updateUser⑴parameterClass=user⑵![CDATA[⑶UPDATEt_user⑷SET(name=#name#,⑸sex=#sex#⑹)WHEREid=#id#⑺]]/update……⑴ID指定了操作ID，之后我们可以在代码中通过指定操作id来执行此节点所定义的操作，如：sqlMap.update(updateUser,user);ID设定使得在一个配置文件中定义两个同名节点成为可能（两个update节点，以不同id区分）⑵parameterClass指定了操作所需的参数类型，此例中update操作以com.ibatis.sample.User类型的对象作为参数，目标是将提供的User实例更新到数据库。parameterClass=user中，user为“com.ibatis.sample.User”类的别名，别名可通过typeAlias节点指定，如示例配置文件中的：typeAliasalias=usertype=com.ibatis.sample.User/⑶![CDATA[……]]通过![CDATA[……]]节点，可以避免SQL中与XML规范相冲突的字符对XML映射文件的合法性造成影响。⑷执行更新操作的SQL，这里的SQL即实际数据库支持的SQL语句，将由ibatis填入参数后交给数据库执行。⑸SQL中所需的用户名参数，“#name#”在运行期会由传入的