Mybayis的项目使用的Mapping文件使用总结参考(一)
以前用过ibatis2,但是听说ibatis3有较大的性能提升,而且设计也更合理,他不兼容ibatis2.尽管ibatis3还是beta10的状态,但还是打算直接使用ibatis3.0,
ibatis3.0应该更简单高效.最近还自己写了个ibatis3.0与spring集成的bean,运行还正常,还自鸣得意了一番,但是当独立使用ibatis时,在事务管理这个方面还是出现不少问题,所以还是打算再认真研究一番ibatis3.0
1.SqlSessionFactory
每个ibatis应用都应该只有一个SqlSessionFactory的实例对象,所以一般设置为static属性或者使用spring管理时返回singleton类型,与spring集成时其实也是写一个怎样构建SqlSessionFactory的Bean,
构建SqlSessionFactory一般是SqlSessionFactoryBuild通过读取ibatis的配置文件而进行build的:
Reader reader = Resources.getResourceAsReader("SqlMapConfig.xml");
SqlSessionFactory sessionFactory = new SqlSessionFactoryBuild().build(reader);
配置文件SqlMapConfig.xml的一般结构(元素顺序不能变)
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE configuration PUBLIC "-//ibatis.apache.org//DTD Config 3.0//EN" "http://ibatis.apache.org/dtd/ibatis-3-config.dtd"> <configuration> <properties resource="jdbc.properties" /> <settings> <setting name="cacheEnabled" value="false" /> <setting name="lazyLoadingEnabled" value="true" /> <setting name="multipleResultSetsEnabled" value="false" /> <setting name="useColumnLabel" value="true" /> <setting name="defaultExecutorType" value="SIMPLE" /> </settings> <typeAliases> <typeAlias alias="Person" type="test.Person"/> </typeAliases> <environments default="dev"> <environment id="dev"> <transactionManager type="jdbc"> <property name="" value="" /> </transactionManager> <dataSource type="POOLED"> <property name="driver" value="${driver}" /> <property name="url" value="${url}" /> <property name="username" value="${user}" /> <property name="password" value="${password}" /> </dataSource> </environment> </environments> <mappers> <mapper resource="sqlMappers/Person.xml" /> <mapper resource="sqlMappers/UserShop.xml" /> </mappers> </configuration>
<settings />是配置ibatis的具体行为属性的,
<typeAliases />是为了将较长的module类名简化,在<mappers />里可以使用
<environment />是配置transaction manager和connection pooling的
<mappers />是sql语句的构造地方,一般每个module对应一个文件
2.SqlSession
可以从SqlSessionFactory得到SqlSession: sessionFactory.openSession();
SqlSession是一切Sql相关数据库操作的中心,insert,select,update,delete...
SqlSession不是线程安全的(也就是有状态的),所以它的作用域最好是在一个Thread下,每个Thread有自己的SqlSession对象实例,彼此不相关.
Never keep references to a SqlSession instance in a static field or even an instance field of a class. Never keep references to a
SqlSession in any sort of managed scope, such as HttpSession of of the Servlet framework.
默认sessionFacory.openSession()拿到的SqlSession不是自动commit的,所以如果是更新操作必须自己执行session.commit()
关闭SqlSession很重要,必须保证在线程结束时关闭这个SqlSession,可以在finally中
session.close();
那跟Spring集成是怎样做到这一点的呢,因为dataSource是由spring管理的,所以他可以保证在一个Thread的每个方法中拿到的Connection是同一个对象,
虽然每个方法从sessionFactory.openSession()拿到的SqlSession对象是不同的,但是sqlSession对象中的connection是相同的,所以spring就可以在service层的方法结束之前将这个connection commit跟close,这样就实现了事务控制.
我们往往在dao层是一个方法对应一个sql语句的,不在这里控制事务,控制事务应该在service层, dao的每个方法拿到的sqlsession对象都是不相同的(尽管它的connection可能相同).
那我们应该怎样在没有spring的情况下实现ibatis的事务控制呢?还要保持dao的结构,以保持能跟spring随时切换?
看来ThreadLocal要派上用场了
---占位----
3.讲完了SqlSession这个大头,再来说说具体的配置信息
配置文件结构
configuration
properties
settings
typeAliases
typeHandlers
objectFactory
plugins
environments
environment
transactionManager
dataSource
mappers
4.ibatis可以配置多个environment环境
供开发,测试,上线等切换
但是一个SqlSessionFactory只能对应一个environment,
也就是 one SqlSessionFactory per database
5.transactionManager
There are two TransactionManager types (i.e. type=”?????”) that are included with iBATIS:
JDBC – This configuration simply makes use of the JDBC commit and rollback facilities directly. It relies on the connection retrieved from the dataSource to manage the scope of the transaction.
MANAGED – This configuration simply does nothing, quite literally. It never commits, rolls back or closes a connection. Instead, it lets the container manage the full lifecycle of the transaction (e.g. Spring or a JEE Application Server context).
6.dataSource的配置
类型可使用UNPOOLED,POOLED,JNDI三种
7.接下来是重头戏mappers
这里是我们直接写sql的地方,ibatis在这里也花了最多功夫,特别是关于select的mapper.
<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE mapper PUBLIC "-//ibatis.apache.org//DTD mapper 3.0//EN" "http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd"> <mapper namespace="test.UserShop"> <insert ...> ... </insert> <select ...> ... </select> <update ...> ... </update> <delete ...> ... </delete> </mapper>
select 元素的所有的如下:
<select id="" parameterType="" resultType="" resultMap="" flushCache="" useCache="" timeout="" fetchSize="" statementType="" resultSetType="">
在Ibatis3中parameterMap已经不再使用。
(1).select
<select id="getUser" parameterType="int" resultType="test.User">
select * from user where userId = #{value}
</select>
注意#{value},resultType可以换成resultMap,这个resultMap就比较复杂了,也是最强大的工具,可以完成复杂的mapper(resultSet->object)
(2).insert,update,delete
这几个操作都比较类似,返回的一般是受影响的行数.
insert 可以返回auto_increament的值
<insert id="insertPerson" parameterType="Person" useGeneratedKeys="true" keyProperty="userId"> insert into person(name,age) values(#{name},#{age}) </insert>
这样,传入的Person类对象的userId就会被set成auto_increament那个值.
(3).可以使用<sql id="columns">name,age</sql>构造可重用的sql片段
这样就可以在那四个主要的元素里用<include refid="columns">引用这个常用sql片段
(4).resultMap很复杂,它可以处理一对一,一对多,多对多关系
比如一个blog对应一个author, 一个blog对应多个post, 一个post对应多个comment
resultMap的结构:
resultMap
constructor (向java构造函数设置值)
idArg
arg
id (id result,同result)
result (字段映射注入)
association (一对一关系,它里面有自己的result映射)
collection (一对多关系, 它里面有自己的result映射,和可能的collection)
discriminator
(5).association (一个Blog对应一个Author)
<resultMap id="blogResult" type="Blog"> <association property="author" column="blog_author_id" javaType="Author"> <id property="id" column="author_id" /> <result property="username" column="author_username" /> </associaton> </resultMap>
当然association也可以使用
<association property="author" column="blog_author_id" javaType="Author" resultMap="authorResult"/>
在Blog类定义里会有一个Author类字段,会自动装载数据
private Author author;
(6).collection (一个Blog对应多个Post)
<resultMap id="blogResult" type="Blog"> <collection property="posts" column="blog_id" ofType="Post" javaType="ArrayList" resultMap="postResult" /> </resultMap> collection也可以精简为 <collection property="posts" ofType="Post" resultMap="postResult" /> 相就地,在Blog类定义里会有: private List<Post> posts
8.cache
其实我是不打算在ibatis这层做cache的,一般cache还是在service层做.
ibatis对于select才会进行cache,而我觉得这个时候cache没多大意义,因为多次請求相同的select語句(sql相同)而又没有进行表的相关update的情况并不多.
但还是看看ibatis是怎样处理cache的
要开启cache,需要在mapper文件中加上一句: <cache />
(1).cache所有select的結果
(2).在同一mapper文件中的insert,update,delete会flush cache
(3).cache使用least recently used(LRU)算法
(4).cache没有定时flush的功能
(5).cache保存1024个对象或list引用
(6).cache是read/write cache, 从cache拿出对象不是共享的,caller可以任意修改而不用担心其他caller也拿到相同的对象(相同的reference)
9.动态SQL
以前用jdbc时经常要根据输入条件而组装成不同的sql,这种就是动态sql
ibatis的动态sql关键词:
if, choose(when,otherwise),trim(where,set),foreach (1).if <if test="title != null"> AND title like #{title} </if> <![CDATA[ ]]>
(2).choose(when,otherwise)只选择其中一种情况
<select ...> <choose> <when test="title != null"> AND title like #{title} </when> <when test="author != null and author.name != null"> AND title like #{author.name} </when> <otherwise> AND featured = 1 </otherwise> </choose> </select>
(3).trim, where, set
<select id="findBlog" paramaterType="Blog" resultType="Blog"> select * from blog <where> <if test=”state != null”> state = ${state} </if> <if test=”title != null”> AND title like ${title} </if> <if test=”author != null and author.name != null”> AND title like ${author.name} </if> </where> </select> <update id="updateAuthorIfNecessary" parameterType="domain.blog.Author"> update Author <set> <if test="username != null">username=#{username},</if> <if test="password != null">password=#{password},</if> <if test="email != null">email=#{email},</if> <if test="bio != null">bio=#{bio}</if> </set> where id=#{id} </update>
(4).foreach
<select id="selectPostIn" resultType="domain.blog.Post"> SELECT * FROM POST P WHERE ID in <foreach item="item" index="index" collection="list" open="(" separator="," close=")"> #{item} </foreach> </select>
10.ibatis的annotation
ibatis3.0也增加了annotation,当然主要还是用在mapper这个问题上
个人感觉是鸡肋,暂时不会使用.