iBatis最大的特点是简单,最新版本2.0( 下载),和1.0相比,主要改动在XML配置文件上,不过,只要有SQL基础,相信你不用教程也能看明白。下面我们看一个最简单的例子入门。
我们先建一个表Account,包括字段username, varchar(20), pk和password, varchar(20),随便填入一些数据。然后编写iBatis必须的配置文件sql-map-config.xml,文件名随意,内容如下:
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE sqlMapConfig
PUBLIC "-//iBATIS.com//DTD SQL Map Config 2.0//EN"
" http://www.ibatis.com/dtd/sql-map-config-2.dtd ">
<sqlMapConfig>
<settings
cacheModelsEnabled="true"
enhancementEnabled="true"
lazyLoadingEnabled="true"
maxRequests="32"
maxSessions="10"
maxTransactions="5"
useStatementNamespaces="false"
/>
<transactionManager type="JDBC" >
<dataSource type="SIMPLE">
<property name="JDBC.Driver" value="sun.jdbc.odbc.JdbcOdbcDriver"/>
<property name="JDBC.ConnectionURL" value="jdbc:odbc:Blog"/>
<property name="JDBC.Username" value="admin"/>
<property name="JDBC.Password" value=""/>
</dataSource>
</transactionManager>
<sqlMap resource="Account.xml" />
</sqlMapConfig>
其他部分你不用管它,我是直接copy的示例配置,只需注意红色部分,配置好数据源即可。我用的是Access,所以用JdbcOdbc驱动。如果你用MySQL或其他数据库,更改相应的属性。
然后注意到这个配置文件还引用了一个Account.xml,没错,iBatis把每个需要O/R Mapping的Java对象关联到一个xml配置文件,我们需要把一个Account表映射到一个Account类:
package example;
public class Account {
private String username;
private String password;
public String getUsername() { return username; }
public void setUsername(String username) { this.username=username; }
public String getPassword() { return password; }
public void setPassword(String password) { this.password=password; }
}
编写Account.xml文件:
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE sqlMap
PUBLIC "-//iBATIS.com//DTD SQL Map 2.0//EN"
" http://www.ibatis.com/dtd/sql-map-2.dtd ">
<sqlMap namespace="Account">
<select id="getAccount" parameterClass="java.lang.String" resultClass="example.Account">
select * from Account where username = #value#
</select>
<insert id="createAccount" parameterClass="example.Account">
insert into Account (username, password)
values ( #username#, #password# )
</insert>
</sqlMap>
我们主要关心红色部分。以<select ...>为例,这里定义了一个查询方法,名字为getAccount,传入参数为String,返回类型resultClass就是example.Account类,select语句相信你已经很熟悉了,#value#是我们将要传进去的String。
<insert...>与之类似,不过注意到#username#和#password#,由于参数是Account类,它们将被 Account.getUsername()和Account.getPassword()替换。所以,只要你会写SQL,就能非常容易地写出配置文件。
最后便是如何使用iBatis实现O/R映射。首先初始化iBatis获得一个SqlMapClient对象:
com.ibatis.sqlmap.client.SqlMapClient sqlMap = null;
try {
java.io.Reader reader = om.ibatis.common.resources.Resources.getResourceAsReader ("sql-map-config.xml");
sqlMap = SqlMapClientBuilder.buildSqlMapClient(reader);
} catch (Exception e) {
e.printStackTrace();
}
然后就可以异常方便地使用O/R Mapping了,比如查询username=admin的Account:
try {
Account accout = (Account)sqlMap.queryForObject("getAccount", "admin");
...
}
或者创建一个新的Account:
try {
Account account = new Account();
account.setUsername("micheal");
account.setPassword("1234");
sqlMap.insert("createAccount", account);
}
运行时把两个配置文件和iBatis的3个jar包放到classpath中,要求jdk1.4版本。
总结:iBatis确实简单灵活,上手容易,代码很少,配置稍嫌复杂。不足之处一是没有方便的工具来自动生成xml配置文件,二是不管是query还是 insert都只能传入一个参数,有时不得不把两个参数包装成一个类传进去。另外对常见的1:1,1:N关系的支持不如Hibernate。不过,大多数 时候iBatis已经完全可以满足我们的需求。Spring很好的集成了iBatis,你可以参考Spring的JPetStore示例。需要注意的是使 用iBatis 2.0和1.0有较大区别,主要体现在配置文件上,iBatis 2.0新增了DAO框架,不需要Spring提供的DAO也能很方便地实现DAO模式。
-----------------------------------------------------------------------
刚刚看完ibatis的使用说明,对于ibatis的使用有了一定的认识,知道sqlmapping的使用是通过设置xml,然后调用相应的方法完成的,对于每次调用不同的sql语句,都需要设置xml文件,然后在程序中对应相应的语句。
但是对于复合查询语句,就不知道怎么处理,因此现在需要对于此处学习一下,然后学习存储过程,触发器调用。
执行存储过程的心得:
数 据库中的返回结果集的字段最好和对应的bean的字段一样,如果遇到不一样的地方,最好用别名代替,这样可以保证返回的数据在bean对象中显示出来,我 们对应数据库表的bean,他的每个属性都对于数据库的某个字段,当字段不同时,就无法将该值返回到bean中,这一点很重要!
每个bean不一定要和数据库的某个表匹配,而是和你的查询结果匹配就行了,
对于每次的查询结果,返回的结果应该是bean对象,而对于外面的数据获取,对于单个记录,可以直接获取对象,对于多个则最好放到相应的容器中,如list,map等。
用queryForMap中用到了最后的String参数是一个要返回的字段属性,为什么是这样还没有理解
对于用map返回的对象,已经得到东西,但是还需要进一步了解
Map对象的值可以是整个Employee对象,也可以是Employee对象的另一个属性,属性的名称由第二个参数valueProperty指定。
例如,您可能只是需要一个Map对象,用员工号作为key值,员工姓名作为value值。不要把它和用Map作为结果对象的概念混淆。
这个方法可以使用Java Bean和Map(或基本类型的包装类,但不可能这样用)作为结果对象。
对于动态sql问题,ibatis已经有了很好得解决办法,不用把sql作为动态的参数传入,也不用if-else进行sql的拼接,xml文件的处理很成熟的
1. <!--[endif]-->总体描述
以Eclipse为例说明ibatis用法,数据库为MSSQL2000,ibatis版本为2.0, jDK1.5, 以对一个用户信息表 user_info的插入、查询(单条记录),多记录查询为例说明itatis的用法。
说明:
本文适合初次接触ibatis的读者。
文章中如有不妥之处,欢迎指正。
如国引用,请说明出处,谢谢。
<!--[if !supportLists]-->2. <!--[endif]-->准备工作
<!--[if !supportLists]-->1. <!--[endif]-->安装Eclipse 3.0.1
<!--[if !supportLists]-->2. <!--[endif]-->安装jdk1.5
<!--[if !supportLists]-->3. <!--[endif]-->下载 ibatis 2.0 开发包 www.ibatis.com
<!--[if !supportLists]-->4. <!--[endif]-->下载MS SQL 的JDBC驱动包, MSJDBC3.0SP3
<!--[if !supportLists]-->5. <!--[endif]-->下载日志操作包 commons-logging.jar
<!--[if !supportLists]-->3. <!--[endif]-->开发步骤
<!--[if !supportLists]-->1. <!--[endif]-->新建J2EE工程 test
<!--[if !supportLists]-->2. <!--[endif]-->在test下建立包 cjs
<!--[if !supportLists]-->3. <!--[endif]-->建立文件夹 sqlmap
<!--[if !supportLists]-->4. <!--[endif]-->建立文件夹 sqlmap.map
<!--[if !supportLists]-->5. <!--[endif]-->在sqlmap.map 下建立三个文件:
SqlMapConfigExample.properties
sql-map-config.xml
user.xml
文件内容如下:
SqlMapConfigExample.properties
-----------------------------------------------------------------------------------------------------------
driver=com.microsoft.jdbc.sqlserver.SQLServerDriver
url=jdbc:microsoft:sqlserver://localhost:1433;
DatabaseName=java
username=sa
password=tn
-----------------------------------------------------------------------------------------------------------
sql-map-config.xml
-----------------------------------------------------------------------------------------------------------
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sqlMapConfig
PUBLIC "-//iBATIS.com//DTD SQL Map Config 2.0//EN"
"http://www.ibatis.com/dtd/sql-map-config-2.dtd">
<sqlMapConfig>
<properties
resource="sqlmap/map/SqlMapConfigExample.properties" />
<settings
cacheModelsEnabled="true"
enhancementEnabled="true"
lazyLoadingEnabled="true"
maxRequests="32"
maxSessions="10"
maxTransactions="5"
useStatementNamespaces="false" />
<transactionManager type="JDBC" >
<dataSource type="SIMPLE">
<property name="JDBC.Driver" value="${driver}"/>
<property name="JDBC.ConnectionURL" value="${url}"/>
<property name="JDBC.Username" value="${username}"/>
<property name="JDBC.Password" value="${password}"/>
</dataSource>
</transactionManager>
<sqlMap resource="sqlmap/map/User.xml" />
</sqlMapConfig>
-----------------------------------------------------------------------------------------------------------
user.xml
-----------------------------------------------------------------------------------------------------------
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sqlMap
PUBLIC "-//iBATIS.com//DTD SQL Map 2.0//EN"
"http://www.ibatis.com/dtd/sql-map-2.dtd">
<sqlMap namespace="User">
<select id="getUser" parameterClass="java.lang.Integer"
resultClass="cjs.User">
SELECT * FROM user_info WHERE uid=#uid#
</select>
<select id="getAllUser" resultClass="cjs.User">
select
*from user_info
wherename = #value#
</select>
<insertid="insertUser" parameterClass="cjs.User">
INSERTINTO
user_info(name, sex, age, addr,zipcode)
VALUES (#name#, #sex#, #age#,#addr#, #zipcode#)
</insert>
</sqlMap>
-----------------------------------------------------------------------------------------------------
<!--[if !supportLists]-->6. <!--[endif]-->在test上右键,点击导入,将
commonslogging.jar
ibatis-common-2.jar
ibatis-dao-2.jar
ibatis-sqlmap-2.jar
msbase.jar
mssqlserver.jar
msutil.jar
导入到Lib文件夹中
<!--[if !supportLists]-->7. <!--[endif]-->在项目-》属性-》构建路径中添加外部 jar的引用, 也就是上面几个 jar
<!--[if !supportLists]-->8. <!--[endif]-->建立一个数据库 java,并执行下面脚本
Table.sql
-----------------------------------------------------------------------------------------------------
CREATE TABLE user_info
(
uid int identity(1,1) primary key,
name varchar(20),
sex int,
age int,
addr varchar(50),
zipcode varchar(6),
);
-----------------------------------------------------------------------------------------------------
<!--[if !supportLists]-->9. <!--[endif]-->在cjs包下面编写类
Myapp.java
Operates.java
User.java
内容如下:
Myapp.java
-----------------------------------------------------------------------------------------------------------
/*
* 创建日期 2005-10-26
*
* TODO 要更改此生成的文件的模板,请转至
* 窗口- 首选项 - Java - 代码样式 - 代码模板
*/
/**
* @author Administrator
*
* TODO 要更改此生成的类型注释的模板,请转至
* 窗口- 首选项 - Java - 代码样式 - 代码模板
*/
package cjs;
importjava.io.Reader;
importcom.ibatis.common.resources.Resources;
importcom.ibatis.sqlmap.client.SqlMapClient;
importcom.ibatis.sqlmap.client.SqlMapClientBuilder;
public classMyapp {
private static final SqlMapClient sqlMap;
static {
try {
String resource ="sqlmap/map/sql-map-config.xml";
Reader reader =Resources.getResourceAsReader (resource);
sqlMap = SqlMapClientBuilder.buildSqlMapClient(reader);
}
catch (Exception e) {
e.printStackTrace();
throw new RuntimeException ("Errorinitializing MyApp class. Cause:"+e);
}
}
public static SqlMapClientgetSqlMapInstance () {
return sqlMap;
}
}
--------------------------------------------------------------------------------------------------
一、 介绍:
相对于Hibernate和Apache OJB等“一站式”ORM解决方案而言,IBatis是一种“半自动化”的ORM实现。
这个框架将让你能够更好的在JAVA应用中设计和实现实体层。这个框架有两个主要的组成部分,一个是SQL Maps,另一个是Data Access Objects。另外还包括一些可能很有用的工具。
SQL Maps:
Sql Maps是这个框架中最激动人心的部分,它是整个iBATIS Database Layer的核心价值所在。通过使用Sql Maps你可以显著的节约数据库操作的代码量。SQL Maps使用一个简单的XML文件来实现从javaBean到SQL statements的映射。跟其他的框架或者对象映射工具相比,SQL Maps最大的优势是简单。它需要学习的东西很少,在连接表或复杂查询时也不需要复杂的scheme(怎么翻complex scheme?),使用SQL Maps, 你可以自由的使用SQL语句。
Data Access Objects (DAO)
当我们开发灵活的JAVA应用时,有一个好主意就是通过一个通用API层把实体操作的细节封装起来。Data Access Objects允许你通过一个简单接口的来操作数据,从而隐藏了实现的细节。使用DAO,你可以动态配置你的应用程序来访问不同的实体存储机制。如果你有 一个复杂的应用需要用到几个不同的数据库,DAO可以让你建立一个一致的API,让系统的其他部分来调用。
Utilities
iBATIS Database Layer包含一系列的有用的工具,比如SimpleDataSource,JDBC DataSource 2.0(也包括3.0)的一个轻量级实现。ScriptRunner也提供了从单元测试到自动发布的数据库准备工作。
工作流程:
SQL Maps提供一个简单的框架,通过XML描述来映射JAVABeans,MAP implementations甚至原始类型的包装(String,Integer等)到JDBC PreparedStatement。想法很简单,基本的步骤如下:
1) 提供一个对象作为参数(either a JavaBean, Map or primitive wrapper),The parameter object will be used setting input values in an update statement, or query values in a where clause (etc.).(感觉不译为好,你说呢?)
2) 执行这个映射的statement,这一步是魔术发生的地方。SQL Maps框架将建立一个PreparedStatement实例(instance),使用前面提供的对象的参数,执行statement,然后从ResultSet中建立一个返回对象。
3) 如果是Update,则返回有多少行修改了,如果是查询,则返回一个对象或者对象的集合。跟参数一样,返回对象也可以是一个JAVABEAN,MAP或者一个primitive type wrapper。
流程图如下:
二、 现在介绍使用IBatis的配置文件:
SQL Map的配置文件。这个文件是SQL Map实现的根配置,这不是本总结所要具体描述的。
配置文件是XML文件,我们用它来配置属性,JDBC DataSources 和 SQL Maps。它给我们一个便利的地方可以集中配置不同的DataSource。这个框架支持iBATIS SimpleDataSource, Jakarta DBCP (Commons),以及其他任何可以通过JNDI context来访问的DataSource。我们在以后将详细讨论这个问题。现在我们用Jakarta DBCP,结构很简单,上面这个例子,它的配置文件如下。
<properties>元素:
这SQL Map中的<properties>元素支持SQL Map XML配置文件。配置文件里的元素符合Data Map规则。如下图:
<properties>所应用的文件里的元素必须和<datasource>里的元素相对应。下面是SqlMapConfigExample.properties文件的内容。里面的元素和<datasource>里的元素相对应。
<settings>元素
maxRequests:在同一时间内能执行SQL语句的次数
maxSession:在同一时间内能起作用的Session数
maxTransaction:在同一时间内能执行的事务。
statementCacheSize:缓冲区的大小
三、 现在介绍操作IBatis的方法:
注意:本总结适合有使用开发IBatis基础的人员参考。由于本人的能力有限,不足之处请大家指出。
1. statement支持元素及支持的属性:
1.1 ID
ID属性是必须的,它表示这个语句的名称,它在整个<SqlMap>元素内唯一的。在代码通过ID来引用相关语句。
1.2 parameterMap
parameterMap属性定义了一个有序的值列表,分别有序的对应了标准参数化的SQL语句中的?占位符。
1.3 parameterClass
在没有指明parameterMap属性的情况下,你可以指定parameterClass属性方法来替代parameterMap属性。parameterClass属性的值可以使用类型的别名或者类型(类)全称
1.4 resultMap
resultMap可以让你控制你如何让数据从查询结果(ResultMap)中提取出来存入java对象中。并且可以定义如何将字段映射到java bean的属性里。如下图:
1.5 resultClass
在resultMap属性没有指定的情况下,可以采用resultClass方式,resultClass的属性值可采用类型别名或者类型(Class)全称的方式。指定的类将根据数据库的元数据自动的映射到查询结果的字段值中。
2. ParameterMap元素属性
2.1 ID
ID属性是必须的,它提供了<parameterMap>对元素Data Map里的唯一表示符
2.2 Class
Class属性是可选的,Class属性必须是JavaBean或Map实列,Class属
性虽是可选的,但推荐大家指定,Class属性 可以用来验证传入的参数的合法性及优化查询
3. 查询语句
3.1 屏蔽特殊符 <![CDATA[ ]]>
3.2 语句导入 <include>,可以是语句优化
使用<include>方法,上面的语句可以写成:
4.自增长方法:<selectKey resultClass=”int”>,不管<selectKey resultClass=”int”>处于该语句的什么部位,都先执行此自增长方法。注意:Mysql和Oracle的方法不一样。
5. <insert>方法:
Insert方法使用parameterMap属性,字段名要和<parameterMap>方法里的元素一一对应
6. <resultClass>属性:
使用resultClass方法,类Person里必须id,firstName,lastName,birthDate,werghtKilograms,heightMeters这些属性。
7. 使用xmlResultName:XML映射文件
XML文件内容:
8. 使用<parameterMap>方法:用来设置元素的属性,其中nullValue表示缺省值
上面的方法也可以写成这样:
9. 如果传入的参数只有一个,用#value#来替代传入的参数名。如果还传来的是字段名,则IBatis不支持
10. 判断传入的参数是否存在:isNotNull,判断传入的参数值是否大于设定的值:isGreaterThan
11. 判断传入的参数是否为空:isEmpty和isNotEmply