iBaits学习2

最新推荐文章于 2019-01-28 09:56:30 发布

sun0322

最新推荐文章于 2019-01-28 09:56:30 发布

阅读量1.4k

点赞数

分类专栏： # iBaits # TERASOLUNA学习相关。文章标签： ibatis bean insert class null properties

iBaits 同时被 2 个专栏收录

10 篇文章 0 订阅

订阅专栏

TERASOLUNA学习相关。

9 篇文章 0 订阅

订阅专栏

一， iBatis 简介

iBatis 是一种数据库持续层的 ORM 框架。使用简单的 XML 配置文件将 Java 　 Bean 映射成 PreparedStatement 的输入参数和 ResultSet 结果集。

在不是很复杂的情况下，我们甚至可以使用 HashMap 而不是 Java Bean 来映射 PreparedStatement 的输入参数和 ResultSet 结果集，从而节省开发时间与成本。或者，我们可以使用一些辅助工具来帮助我们通过 XML 配置生成对应的 Java Bean.

二， iBatis 工作原理 , 流程

iBatis 使用简单的 XML 描述文件将 Java Bean ， Map 实现和基本数据类型的包装类（ String ， Integer 等）映射成 JDBC 的 PreparedStatement 的输入参数和 ResultSet 结果集。具体工作流程如下：

1 ．在 sqlMapConfig 的 XML 配置文件中进行数据库连接的配置， XML 配置文件名称任意，比如 sql-map-config.xml

2 ．在 sqlMapConfig 的 XML 配置文件中引用 sqlMap 的 XML 配置文件

3 ．在 sqlMap 的 XML 配置文件中进行 SQL 文的配置，文件名称任意，比如 Person1.xml

4 ．通过 SqlMapClientBuilder 生成具体的操作 sqlMap 配置文件中ＳＱＬ文的ＩＢＡＴＩＳ对象 SqlMapClient

String resource = "config/ibatis/sql-map-config.xml";

Reader reader = Resources.getResourceAsReader (resource);

SqlMapClient sqlMap = SqlMapClientBuilder.buildSqlMapClient(reader);

5 ． SqlMapClient 对象提供函数，函数的参数对应替换 sqlMap 配置文件中的 id,parameter 等等属性，完成ＳＱＬ文的执行。具体参照 iBatis 的 API

public List queryForList(String statementName, Object parameterObject,

int skipResults, int maxResults)

statement:sqlMap 配置中 id 属性， parameterObject:sqlMap 配置中 parameterXXX 属性

iBatis 的工作重点在于配置文件的做成上，尤其 sqlMap 配置文件的做成是我们需要重点学习的。

三， SqlMapConfig.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">

<settings

cacheModelsEnabled="true"

enhancementEnabled="true"

lazyLoadingEnabled="true"

maxRequests="32"

maxSessions="10"

maxTransactions="5"

useStatementNamespaces="false"

</dataSource>

</transactionManager>

</sqlMapConfig>

以上，主要注意 DB 连接情报的配置方法，采用了 Java 的标准 Properties 文件。

然后在 XML 中引用 properties 文件中的定义。

四， SqlMap.xml 总体印象

较复杂的例子：

</cacheModel>

</parameterMap>

</resultMap>

<select id=”getProduct” parameterMap=”productParam”

resultMap=”productResult” cacheModel=”product-cache”>

select * from PRODUCT where PRD_ID = ?

</select>

</sqlMap>

以上例子简化版：

<select id=”getProduct” parameterClass=” com.ibatis.example.Product”

resultClass=”com.ibatis.example.Product”>

Select

PRD_ID as id,

PRD_DESCRIPTION as description

From PRODUCT

Where PRD_ID = #id#

</select>

</sqlMap>

五， Statement 语法，类型，及其属性和特点

1. 语法

<statement

id=”statementName”

[parameterClass=”some.class.Name”]

[resultClass=”some.class.Name”]

[parameterMap=”nameOfParameterMap”]

[resultMap=”nameOfResultMap”]

[cacheModel=”nameOfCache”]

select * from PRODUCT where PRD_ID = [?|#propertyName#] order by [$simpleDynamic$]

</statement>

[] 内为可选项，不是必须存在的。

2.Statement 类型，属性，特点

六，关于映射时输入值的匹配问题

1. 类 SqlMapClient 如何从 SqlMap 的配置文件中找到对应的 SQL 文

通过类函数的参数 statementName 与配置文件中 statement 配置的 id 相匹配

2. bean 中的数据如何映射给 SQL 文中对应的输入参数

a. 通过参数变量名称与 bean 中对应属性名称相匹配

insert into PRODUCT values (#id#, #description#, #price#)

</statement>

b. 通过参数变量的出现顺序相匹配

</parameterMap>

insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (?,?);

</statement>

3. map 中的数据如何映射给 SQL 文中对应的输入参数

a. 通过参数变量名称与 map 中对应 key 相匹配

insert into PRODUCT values (#id#, #description#, #price#)

</statement>

HashMap hm = new HashMap();

hm.put(“id”,”value”);

hm.put(“description”,”value”);

hm.put(“price”,”value”);

sqlMapClient.queryForList(“statementName”, hm,…………);

4. 基本数据类型的数据如何映射给 SQL 文中对应的输入参数

基本数据类型与参数 1 对 1 ，没啥匹配的问题。不过官方的开发指南中强调参数要写成 #value# 这种写法，原因不明。

select * from PRODUCT where PRD_ID = #value#

</statement>

七，关于映射时返回值的匹配问题

1. 查询结果如何映射给 bean 中的对应属性

a. 通过查询结果的字段名称与 bean 中对应属性名称相匹配

select

PRD_ID as id,

PRD_DESCRIPTION as description

from PRODUCT

where PRD_ID = #value#

</statement>

官方的开发指南中说这种写法叫做隐式 ResultMap

b. 指定查询结果的字段名称与 bean 中对应属性名称的映射关系

</resultMap>

以上，数据类型通过反射与对应的属性类型自动匹配，极少数时候可能需要通过 resultMap 的 javaType 属性进行设定，参考后面关于 Result Map 外部形式中各个参数的说明

2. 查询结果如何设定给 Map

a. 通过查询结果的字段名称与 map 中对应 key 相匹配

</resultMap>

select * from PRODUCT

</statement>

b. 指定查询结果的字段名称与 bean 中对应属性名称的映射关系

与 bean 基本相同，参考使用 bean 作为返回结果的写法

3. 查询结果如何映射给基本数据类型

只能指定一个返回值，名字可以随便，一般采用 value,val 等

</resultMap>

或者

select count(1) as value

from PRODUCT

</statement>

八，关于 Parameter Map 外部形式中各个参数的说明

<parameter

property =”propertyName”

[jdbcType=”VARCHAR”]

[javaType=”string”]

[nullValue=”NUMERIC”]

[null=”-9999999”]/>

</parameterMap>

1.JdbcType

属性 jdbcType 用于显式地指定给本属性（ property ）赋值的数据库字段的数据类型。对于某些特定的操作，如果不指定字段的数据类型，某些 JDBC Driver 无法识别字段的数据类型。

正常情况下，只有当字段可以为 NULL 时才需要 jdbcType 属性。另一需要指定 jdbcType 属性的情况是字段类型为日期时间类型的情况。因为 Java 只有一个 Date 类型（ java.util.Date ），而大多数 SQL 数据库有多个－通常至少有 3 种。因此，需要指定字段类型是 DATE 还是 DATETIME 。

注意！当使用 Oracle Driver 时，如果没有给可以为 NULL 的字段指定 jdbcType 属性，当试图给这些字段赋值 NULL 时，会出现“ Invalid column type ”错误。

2.javaType

属性 javaType 用于显式地指定被赋值参数 Java 属性的类名。正常情况下，这可以通过反射从 Java Bean 的属性获得

3.nullValue, null

用于指定 NULL 的替换值。就是说，当 Java Bean 的属性值等于指定值时，相应的字段将赋值 NULL 。这个特性允许在应用中给不支持 null 的数据类型（即 int ， double ， float 等）赋值 null 。当这些数据类型的属性值匹配 null 值（即匹配 -9999 ）时， NULL 将代替 null 值写入数据库。

一个完整的例子

<parameter

property=”id”

jdbcType=”NUMERIC”

javaType=”int”

nullValue=”-9999999”/>

<parameter

property=”description”

jdbcType=”VARCHAR”

nullValue=”NO_ENTRY”/>

</parameterMap>

insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (?,?);

</statement>

简化写法

insert into PRODUCT (PRD_ID, PRD_DESCRIPTION)

values (#id:NUMERIC#, #description:VARCHAR#);

</statement>

或者：

insert into PRODUCT (PRD_ID, PRD_DESCRIPTION)

values (#id:NUMERIC:-999999#, #description:VARCHAR:NO_ENTRY#);

</statement>

九， Result Map 外部形式中各个参数的说明

<result property=”propertyName” column=”COLUMN_NAME”

[columnIndex=”1”]

[javaType=”int”]

[jdbcType=”NUMERIC”]

[nullValue=”-999999”]

[select=”someOtherStatement”]

</resultMap>

1. columnIndex

属性 columnIndex 是可选的，用于改善性能。属性 columnIndex 的值是 ResultSet 中用于赋值 Java Bean 属性的字段次序号。在 99 ％的应用中，不太可能需要牺牲可读性来换取性能。使用 columnIndex ，某些 JDBC Driver 可以大幅提高性能，某些则没有任何效果。

2.javaType

属性 javaType 用于显式地指定被赋值的 Java Bean 属性的类型。正常情况下，这可以通过反射从 Java Bean 的属性获得，但对于某些映射（例如 Map 和 XML document ），框架不能通过这种方法来获知。如果没有设置 javaType ，同时框架也不能获知类型信息，类型将被假定为 Object 。

3.jdbcType,nullValue, null

同 Parameter Map

4.select

属性 select 用于描述对象之间的关系，并自动地装入复杂类型（即用户定义的类型）属性的数据。属性 select 的值必须是另外一个 mapped statement 元素的名称。在同一个 result 元素中定义的数据库字段（ column 属性）以及 property 属性，将被传给相关的 mapped statement 作为参数。因此，字段的数据类型必须是 SQL Map 支持的简单数据类型。关于简单数据类型和复杂类型之间映射 / 关系的信息，参照后面章节更详细的讨论。

具体参考稍后关于复杂类型属性的例子

十，复杂类型属性说明

1 ．关于复杂类型属性的例子

</resultMap>

</resultMap>

select * from PRODUCT where PRD_ID = #value#

</statement>

select * from CATEGORY where CAT_ID = #value#

</statement>

避免 N ＋ 1 Select （ 1:1 ）

</resultMap>

select *

from PRODUCT, CATEGORY

where PRD_CAT_ID=CAT_ID

and PRD_ID = #value#

</statement>

2 ．关于复杂类型级和属性的例子

</resultMap>

</resultMap>

select * from CATEGORY where CAT_ID = #value#

</statement>

select * from PRODUCT where PRD_CAT_ID = #value#

</statement>

避免 N ＋ 1 Select （ 1:1 ）

暂时无解，在新版本中可能会对应

3 ．组合键值或多个复杂参数属性

<result property=”payments” column=”{itemId=ORD_ID, custId=ORD_CST_ID}”

select=” getOrderPayments”/>

</resultMap>

select * from PAYMENT

where PAY_ORD_ID = #itemId#

and PAY_CST_ID = #custId#

</statement>

十一，在查询 statement 中指定 cacheModel 属性

</cacheModel>

select * from PRODUCT where PRD_CAT_ID = #value#

</statement>

1 ． Serializable 可读写缓存

正如您所知道的，只对当前 Session 有效的缓存对整体应用性能的提高作用有限。 Serializable 可读写缓存可以提高整体应用（而不仅仅是每个 Session ）的性能。这种缓存为每一个 Session 返回缓存对象不同的实例（复本）。因此每一个 Session 都可以安全修改返回的对象。不同之处在于，通常您希望从缓存中得到同一个对象，但这种情况下得到的是不同的对象。还有，每一个缓冲在 Serializable 缓存的对象都必须是 Serializable 的。这意味着不能同时使用 Serializable 缓存和延迟加载，因为延迟加载代理不是 Serializable 的。想知道如何把 Serializable 缓存，延迟加载和联合查询结合起来使用，最好的方法是尝试。要使用 Serializable 缓存，设置 readOnly= “ false ”和 serialize= “ true ”。缺省情况下，缓存是只读模式，不使用 Serializable 缓存。只读缓存不需要 Serializable 。

2 ． Type

a.type=”MEMORY”

MEMORY cache 实现只认识一个 <property> 元素。这个名为“ reference-type ”属性的值必须是 STRONG ， SOFT 和 WEAK 三者其一。这三个值分别对应于 JVM 不同的内存 reference 类型。

b.type=”LRU”

LRU Cache 实现用“近期最少使用”原则来确定如何从 Cache 中清除对象。

c.type=”FIFO”

FIFO Cache 实现用“先进先出”原则来确定如何从 Cache 中清除对象。

d.type= ” OSCACHE ” 没用过，没研究过。这个不太懂，哈

OSCACHE Cache 实现是 OSCache2.0 缓存引擎的一个 Plugin 。它具有高度的可配置性，分布式，高度的灵活性。

OSCACHE 实现不使用 property 元素，而是在类路径的根路径中使用标准的 oscache.properties 文件进行配置。在 oscache.properties 文件中，您可以配置 Cache 的算法（和上面讨论的算法很类似）， Cache 的大小，持久化方法（内存，文件等）和集群方法。

要获得更详细的信息，请参考 OSCache 文档。 OSCache 及其文档可以从 OpenSymphony 网站上获取：

http://www.opensymphony.com/oscache/

十二，动态 Mapped Statement

<select id="dynamicGetAccountList"

cacheModel="account-cache"

resultMap="account-result"

select * from ACCOUNT

where ACC_ID = #id#

</isGreaterThan>

order by ACC_LAST_NAME

</select>

上面的例子中，根据参数 bean “ id ”属性的不同情况，可创建两个可能的语句。如果参数“ id ”大于 0 ，将创建下面的语句：

select * from ACCOUNT where ACC_ID = ?

或者，如果“ id ”参数小于等于 0 ，将创建下面的语句：

select * from ACCOUNT

1 ．二元条件元素

二元条件元素将一个属性值和一个静态值或另一个属性值比较，如果条件为“真”，元素体的内容将被包括在查询 SQL 语句中。

二元条件元素的属性：

prepend －可被覆盖的 SQL 语句组成部分，添加在语句的前面（可选）

property －被比较的属性（必选）

compareProperty －另一个用于和前者比较的属性（必选或选择 compareValue ）

compareValue －用于比较的值（必选或选择 compareProperty ）

比较属性值和静态值或另一个属性值是否相等。

比较属性值和静态值或另一个属性值是否不相等。

比较属性值是否大于静态值或另一个属性值。

比较属性值是否大于等于静态值或另一个属性值。

比较属性值是否小于静态值或另一个属性值。

比较属性值是否小于等于静态值或另一个属性值。

例子：

ADOLESCENT = ‘TRUE’

</isLessEqual>

2 ．一元条件元素

一元条件元素检查属性的状态是否符合特定的条件。

一元条件元素的属性：

prepend －可被覆盖的 SQL 语句组成部分，添加在语句的前面（可选）

property －被比较的属性（必选）

检查是否存在该属性（存在 parameter bean 的属性）。

检查是否不存在该属性（不存在 parameter bean 的属性）。

检查属性是否为 null 。

检查属性是否不为 null 。

检查 Collection.size() 的值，属性的 String 或 String.valueOf() 值 , 是否为 null 或空（“”或 size() < 1 ）。

检查 Collection.size() 的值，属性的 String 或 String.valueOf() 值 , 是否不为 null 或不为空（“”或 size() > 0 ）。

例子：

FIRST_NAME=#firstName#

</isNotEmpty>

3 ．其他元素

Parameter Present ：这些元素检查参数对象是否存在。

Parameter Present 的属性：

prepend －可被覆盖的 SQL 语句组成部分，添加在语句的前面（可选）

检查是否存在参数对象（不为 null ）。

检查是否不存在参数对象（参数对象为 null ）。

例子：

EMPLOYEE_TYPE = ‘DEFAULT’

</isNotParameterPresent>

4 ． Iterate ：这属性遍历整个集合，并为 List 集合中的元素重复元素体的内容。

Iterate 的属性：

prepend －可被覆盖的 SQL 语句组成部分，添加在语句的前面（可选）

property －类型为 java.util.List 的用于遍历的元素（必选）

open －整个遍历内容体开始的字符串，用于定义括号（可选）

close －整个遍历内容体结束的字符串，用于定义括号（可选）

conjunction －每次遍历内容之间的字符串，用于定义 AND 或 OR （可选）

遍历类型为 java.util.List 的元素。

例子：

<iterate prepend=”AND” property=”userNameList”

open=”(” close=”)” conjunction=”OR”>

username=#userNameList[]#

</iterate>

注意：使用 <iterate> 时，在 List 元素名后面包括方括号 [] 非常重要，方括号 [] 将对象标记为 List ，以防解析器简单地将 List 输出成 String 。

一，注意事项

1. 关于特殊字符

因为 SQL 语句是嵌在 XML 文档中的，因此有些特殊的字符不能直接使用，例如大于号和小于号（ <> ）。幸运的是，解决的办法很简单，只需将包含特殊字符的 SQL 语句放在 XML 的 CDATA 区里面就可以了。例如：

<![CDATA[

SELECT *

FROM PERSON

WHERE AGE > #value#

]]>

</statement>

2. 关于多个 SqlMap.xml 中 id 冲突问题

问题描述：

当 sql-map-config 中引用多个 sqlmap.xml ，多个 sqlmap.xml 中存在相同的 statementname 的时候， ibatis 如何判断当前我准备使用哪一个 sqlmap.xml 中的 statementname 对应的 sql 语句

解决方法：

在 SqlMapConfig.xml 中的 settings 标签中存在一个属性 useStatementNamespaces 当这个设定为 true 的时候，那么 iBatis 通过 SqlMap.xml 的 namespace.id 来查找对应的 sql 文 id ，从而避免这个问题。

二，其他

1. 自动生成的主健

SELECT STOCKIDSEQUENCE.NEXTVAL AS ID FROM DUAL

</selectKey>

insert into PRODUCT (PRD_ID,PRD_DESCRIPTION)

values (#id#,#description#)

</insert>

<!— Microsoft SQL Server IDENTITY Column Example -->

insert into PRODUCT (PRD_DESCRIPTION)

values (#description#)

SELECT @@IDENTITY AS ID

</selectKey>

</insert>

2. 调用存储过程

</parameterMap>

{call swap_email_address (?, ?)}

</procedure> SELECT @@IDENTITY AS ID

十五， Sample

1.java 类，生成 iBatis 数据库操作对象

public class MyAppSqlConfig {

private static final SqlMapClient sqlMap;

static {

try {

String resource = “com/ibatis/example/sql-map-config.xml”;

Reader reader = Resources.getResourceAsReader (resource);

sqlMap = SqlMapClientBuilder.buildSqlMapClient(reader);

} catch (Exception e) {

e.printStackTrace();

throw new RuntimeException (“”);

}

public static getSqlMapInstance () {

return sqlMap;

}

本章来源： http://blog.csdn.net/qingwaxw1980/archive/2010/02/05/5291253.aspx

sun0322

关注

0
点赞
踩
4

收藏

觉得还不错? 一键收藏
0
评论
iBaits学习2

一， iBatis简介iBatis是一种数据库持续层的ORM框架。使用简单的XML配置文件将JavaBean映射成PreparedStatement的输入参数和ResultSet结果集。在不是很复杂的情况下，我们甚至可以使用HashMap而不是Java Bean来映射PreparedStatement的输入参数和ResultSet结果集，从而节省开发时间与成本。或者，我们可以使用一些辅助工具来帮助我们通过XML配置生成对应的Java Bean.二， iBatis工作原理,流程iBat
复制链接

扫一扫