天天看点
返回

Ibatis 入门1.总体描述2. 准备工作3.开发步骤

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

ibatis sql properties primitive JDBC 数据库
上一篇: iBatis：O/R Mapping解决方案
下一篇: 连接数据库 六大步骤

继续阅读