Ibatis 入门

1.总体描述

以Eclipse为例说明ibatis用法，数据库为MSSQL2000，ibatis版本为2.0, jDK1.5, 以对一个用户信息表 user_info的插入、查询（单条记录），多记录查询为例说明itatis的用法。
    
说明：
     本文适合初次接触ibatis的读者。
     文章中如有不妥之处，欢迎指正。
     如国引用，请说明出处，谢谢。

2. 准备工作

<!--[if !supportLists]-->1.       <!--[endif]-->安装Eclipse 3.0.1

<!--[if !supportLists]-->2.       <!--[endif]-->安装jdk1.5

<!--[if !supportLists]-->3.       <!--[endif]-->下载 ibatis 2.0 开发包http://www.ibatis.com/

 

 

<!--[if !supportLists]-->4.       <!--[endif]-->下载MS SQL 的JDBC驱动包， MSJDBC3.0SP3

 

<!--[if !supportLists]-->5.       <!--[endif]-->下载日志操作包 commons-logging.jar

 

3.开发步骤

<!--[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

 

 

-----------------------------------------------------------------------------------------------------------

 

 

 

 

 

 

 

 

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;

    }

一、ibatis教程之ibatis介绍:
ibatis是什么呢？相对于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映射文件 
8. 使用<parametermap>方法：用来设置元素的属性，其中nullvalue表示缺省值 
9. 如果传入的参数只有一个，用#value#来替代传入的参数名。如果还传来的是字段名，则ibatis不支持 
10. 判断传入的参数是否存在:isnotnull,判断传入的参数值是否大于设定的值：isgreaterthan 
11. 判断传入的参数是否为空：isempty和isnotemply 
12. 如果进行模糊查询，使用like方法
那么ibatis教程的入门部分就向你介绍到这里，希望上述的介绍使你对ibatis有了一定的认识。
本贴来自天极网群乐社区--file:///F:/Data/Ibatis/HT-Data/ibatis/iBATIS教程之入门浅析_%20Java.mht