1.
总体描述
以Eclipse为例说明ibatis用法，数据库为MS
SQL2000，ibatis版本为2.0, jDK1.5, 以对一个用户信息表 user_info的插入、查询（单条记录），多记录查询为例说明itatis的用法。
说明：
本文适合初次接触ibatis的读者。
文章中如有不妥之处，欢迎指正。
如国引用，请说明出处，谢谢。
2.
准备工作
1.
安装Eclipse 3.0.1
2.
安装jdk1.5
3.
下载 ibatis 2.0 开发包 www.ibatis.com
4.
下载MS SQL 的JDBC驱动包， MSJDBC3.0
SP3
5.
下载日志操作包 commons-logging.jar
3.
开发步骤
1.
新建J2EE工程 test
2.
在test下建立包 cjs
3.
建立文件夹 sqlmap
4.
建立文件夹 sqlmap.map
5.
在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
where
name = #value#
</select>
<insert
id="insertUser" parameterClass="cjs.User">
INSERT
INTO
user_info(name, sex, age, addr,
zipcode)
VALUES (#name#, #sex#, #age#,
#addr#, #zipcode#)
</insert>
</sqlMap>
-----------------------------------------------------------------------------------------------------
6.
在test上右键，点击导入，将
commonslogging.jar
ibatis-common-2.jar
ibatis-dao-2.jar
ibatis-sqlmap-2.jar
msbase.jar
mssqlserver.jar
msutil.jar
导入到Lib文件夹中
7.
在项目－》属性－》构建路径中
添加外部 jar的引用， 也就是上面几个 jar
8.
建立一个数据库 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),
);
-----------------------------------------------------------------------------------------------------
9.
在cjs包下面编写类
Myapp.java
Operates.java
User.java
内容如下：
Myapp.java
-----------------------------------------------------------------------------------------------------------
/*
* 创建日期 2005-10-26
*
* TODO 要更改此生成的文件的模板，请转至
* 窗口
－ 首选项 － Java － 代码样式 － 代码模板
*/
/**
* @author Administrator
*
* TODO 要更改此生成的类型注释的模板，请转至
* 窗口
－ 首选项 － Java － 代码样式 － 代码模板
*/
package cjs;
import
java.io.Reader;
import
com.ibatis.common.resources.Resources;
import
com.ibatis.sqlmap.client.SqlMapClient;
import
com.ibatis.sqlmap.client.SqlMapClientBuilder;
public class
Myapp {
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 ("Error
initializing MyApp class. Cause:"+e);
}
}
public static SqlMapClient
getSqlMapInstance () {
return sqlMap;
}
}
-----------------------------------------------------------------------------------------------------------
Operates.java
-----------------------------------------------------------------------------------------------------------
/*
* 创建日期 2005-10-26
*
* TODO 要更改此生成的文件的模板，请转至
* 窗口
－ 首选项 － Java － 代码样式 － 代码模板
*/
/**
* @author Administrator
*
* TODO 要更改此生成的类型注释的模板，请转至
* 窗口
－ 首选项 － Java － 代码样式 － 代码模板
*/
package cjs;
import cjs.User;
import
java.util.Iterator;
import
java.util.List;
import
com.ibatis.sqlmap.client.SqlMapClient;
public class
Operates {
private static void insertData(User newUser){
SqlMapClient sqlMap =
Myapp.getSqlMapInstance();
try{
Integer uid= new Integer(1);
//
User user = (User) sqlMap.queryForObject ("getUser", uid);
System.out.println("Use ibatis
to Insert a new User:");
/*
System.out.println("Uid =
" + "系统自动产生");
System.out.println("name
=" + newUser.getName());
System.out.println("setSex
=" + newUser.getSex());
System.out.println("setAge =
" + newUser.getAge());
System.out.println("setAddr =
" + newUser.getAddr());
System.out.println("setZipcode
= " + newUser.getZipcode());
*/
System.out.println(newUser.toString());
sqlMap.insert
("insertUser", newUser);
System.out.println("Insert
success!");
}
catch(Exception e){
e.printStackTrace();
}
}
private static User query(Integer uid){
User myuser = new User();
SqlMapClient sqlMap =
Myapp.getSqlMapInstance();
try{
myuser =
(User)sqlMap.queryForObject ("getUser", uid);
}catch(Exception e){
e.printStackTrace();
}finally{
return myuser;
}
}
private static void queryList(String name){
try{
SqlMapClient sqlMap =
Myapp.getSqlMapInstance();
List userList =
sqlMap.queryForList("getAllUser",name);
if(userList!=null &&
!userList.isEmpty()){
User tmpUser = new User();
System.out.println("There
are " + userList.size()+ " rows records"
+ "
whose name is " + name + ":" );
for(Iterator iter =
userList.iterator(); iter.hasNext();){
tmpUser =
(User)iter.next();
System.out.println(tmpUser.toString());
}
}else{
System.out.println("There
is 0 row record whose name is: " + name);
}
}catch(Exception e){
e.printStackTrace();
}
}
public static void main(String[] args) {
User newUser= new User();
//newUser.setUid(6);
newUser.setName("cjs");
newUser.setSex(2);
newUser.setAge(2);
newUser.setAddr("dfghg");
newUser.setZipcode("301");
// insert
//insertData(newUser);
// query a object
/*
Integer uid= new Integer(5);
User getUser = query(uid);
System.out.println("Query User
whose id equal " + uid + ":");
System.out.println(getUser.toString());
*/
// query many objects
String name = "cjs";
queryList(name);
}
}
-----------------------------------------------------------------------------------------------------------
User.java
-----------------------------------------------------------------------------------------------------------
package cjs;
/*
* 创建日期 2005-10-26
*
* TODO 要更改此生成的文件的模板，请转至
* 窗口
－ 首选项 － Java － 代码样式 － 代码模板
*/
/**
* @author Administrator
*
* TODO 要更改此生成的类型注释的模板，请转至
* 窗口
－ 首选项 － Java － 代码样式 － 代码模板
*/
public class
User {
public int uid;
public String name;
public int sex;
public int age;
public String addr;
public String zipcode;
public String getAddr() {
return addr;
}
public void setAddr(String addr) {
this.addr = addr;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getSex() {
return sex;
}
public void setSex(int sex) {
this.sex = sex;
}
public int getUid() {
return uid;
}
public void setUid(int uid) {
this.uid = uid;
}
public String getZipcode() {
return zipcode;
}
public void setZipcode(String zipcode) {
this.zipcode = zipcode;
}
public String toString(){
String
szUser = new String();
szUser
+= "Uid = " + uid + "; ";
szUser
+= "name =" + name + "; ";
szUser += "setSex =" + sex +
"; ";
szUser += "setAge = " + age+
"; ";
szUser += "setAddr = " +
addr+ "; ";
szUser += "setZipcode = " +
zipcode+ "; ";
return szUser;
}
}
-----------------------------------------------------------------------------------------------------------
4.
运行
通过Operates.java 中的main() 来调试各种情况，包括插入数据，查询一条数据，查询多条数据。
5.
注意
1.
连接不同的数据库，通过修改SqlMapConfigExample.properties 中的 driver和URL就可以了。
2.
注意sql-map-config.xml 的路径
3.
参数中为Integer时，最好指定为 java.Lang.Integer，如果为字符串，则可以不指定
4.
注意返回结果类型的指定
5.
注意插入语句中，sql语句中的变量为类的属性值。
