一、前言
数据库操作怎能少了INSERT操作呢?下面记录MyBatis关于INSERT操作的笔记,以便日后查阅。
二、 insert元素 属性详解
其属性如下:
parameterType ,入参的全限定类名或类型别名
keyColumn ,设置数据表自动生成的主键名。对特定数据库(如PostgreSQL),若自动生成的主键不是第一个字段则必须设置
keyProperty ,默认值unset,用于设置getGeneratedKeys方法或selectKey子元素返回值将赋值到领域模型的哪个属性中
useGeneratedKeys ,取值范围true|false(默认值),设置是否使用JDBC的getGenereatedKeys方法获取主键并赋值到keyProperty设置的领域模型属性中。MySQL和SQLServer执行auto-generated key field,因此当数据库设置好自增长主键后,可通过JDBC的getGeneratedKeys方法获取。但像Oralce等不支持auto-generated key field的数据库就不能用这种方法获取主键了
statementType ,取值范围STATEMENT,PREPARED(默认值),CALLABLE
flushCache ,取值范围true(默认值)|false,设置执行该操作后是否会清空二级缓存和本地缓存
timeout ,默认为unset(依赖jdbc驱动器的设置),设置执行该操作的最大时限,超时将抛异常
databaseId ,取值范围oracle|mysql等,表示数据库厂家,元素内部可通过`<if test="_databaseId = 'oracle'">`来为特定数据库指定不同的sql语句
三、一般的INSERT操作——返回值为插入的记录数目
mapper接口代码:
/** * 添加学生信息 * @param student 学生实例 * @return 成功操作的记录数目 */ int add(EStudent student);
mapper.xml:
<insert id="add" parameterType="EStudent"> insert into TStudent(name, age) values(#{name}, #{age}) </insert
四、执行INSERT操作后获取记录主键
mapper接口代码:
/** * 添加学生信息 * @param student 学生实例 * @return 成功操作的记录数目 */ int add(EStudent student);
至于mapper.xml则分为两种情况了,一种是数据库(如MySQL,SQLServer)支持auto-generated key field,另一种是数据库(如Oracle)不支持auto-generated key field的。
1. 数据库(如MySQL,SQLServer)支持auto-generated key field的情况
手段①(推荐做法):
<insert id="add" parameterType="EStudent" useGeneratedKeys="true" keyProperty="id"> insert into TStudent(name, age) values(#{name}, #{age}) </insert>
手段②:
<insert id="add" parameterType="EStudent"> // 下面是SQLServer获取最近一次插入记录的主键值的方式 <selectKey resultType="_long" keyProperty="id" order="AFTER"> select @@IDENTITY as id </selectKey> insert into TStudent(name, age) values(#{name}, #{age}) </insert>
由于手段②获取主键的方式依赖数据库本身,因此推荐使用手段①。
2. 数据库(如Oracle)不支持auto-generated key field的情况
<insert id="add" parameterType="EStudent"> <selectKey keyProperty="id" resultType="_long" order="BEFORE"> select CAST(RANDOM * 100000 as INTEGER) a FROM SYSTEM.SYSDUMMY1 </selectKey> insert into TStudent(id, name, age) values(#{id}, #{name}, #{age}) </insert
注意:mapper接口返回值依然是成功插入的记录数,但不同的是主键值已经赋值到领域模型实体的id中了。
五、 selectKey子元素 详解
作用:在insert元素和update元素中插入查询语句。
其属性如下:
keyProperty ,默认值unset,用于设置getGeneratedKeys方法或selectKey子元素返回值将赋值到领域模型的哪个属性中
resultType ,keyPropety所指向的属性类全限定类名或类型别名
order属性 ,取值范围BEFORE|AFTER,指定是在insert语句前还是后执行selectKey操作
statementType ,取值范围STATEMENT,PREPARED(默认值),CALLABLE
注意:selectKey操作会将操作查询结果赋值到insert元素的parameterType的入参实例下对应的属性中。并提供给insert语句使用
六、批量插入
方式1:
<insert id="add" parameterType="EStudent"> <foreach collection="list" item="item" index="index" separator=";"> INSERT INTO TStudent(name,age) VALUES(#{item.name}, #{item.age}) </foreach> </insert>
上述方式相当语句逐条INSERT语句执行,将出现如下问题:
1. mapper接口的add方法返回值将是最一条INSERT语句的操作成功的记录数目(就是0或1),而不是所有INSERT语句的操作成功的总记录数目
2. 当其中一条不成功时,不会进行整体回滚。
方式2(仅限于MSSQL):
<insert id="add" parameterType="EStudent"> WITH R AS <foreach collection="list" item="item" index="index" open="(" close=")" separator="union all"> SELECT #{item.name} as a, #{item.age} as b </foreach> INSERT INTO TStudent(name,age) SELECT a, b FROM R </insert>
上述方式解决了方式1中的问题。但该方式仅限于MSSQL
方式3(通用解决方法)方式3(MSSQL):
INSERT INTO TStudent(name,age) <foreach collection="list" item="item" index="index" open="(" close=")" separator="union all"> SELECT #{item.name} as a, #{item.age} as b </foreach>
该方式与方式2效果一样,若为Oracle则采用
INSERT INTO TStudent(name,age) <foreach collection="list" item="item" index="index" open="(" close=")" separator="union all"> SELECT #{item.name} as a, #{item.age} as b FROM DUAL </foreach>
七、总结
关于MyBatis的INSERT操作就总结到这里吧。
尊重原创,转载请注明来自:http://www.cnblogs.com/fsjohnhuang/p/4078659.html ^_^肥仔John
八、参考
http://mybatis.github.io/mybatis-3/zh/dynamic-sql.html
在Mybatis的xml配置中使用集合,主要是用到了foreach动态语句。
foreach的参数:
foreach元素的属性主要有 item,index,collection,open,separator,close。
item表示集合中每一个元素进行迭代时的别名.
index指 定一个名字,用于表示在迭代过程中,每次迭代到的位置.
open表示该语句以什么开始,separator表示在每次进行迭代之间以什么符号作为分隔 符.
close表示以什么结束。
1. Mybatis生成select * from table where id in(1,2,...,n)语句的查询
我们一般的做法是在方法的参数处指定传入的参数名称,在xml中使用的时候,集合的名称要和方法的Param的名称一致,这样便于阅读和理解,然后是在对应的xml文件中使用foreach循环。
java代码如下:
public abstract List<Model> findByIds(@Param("ids")List<Integer> ids);
对应的xml代码如下:
select * from table <where> id in <foreach collection="ids" item="item" index="index" open="(" separator="," close=")">#{item}</foreach> </where>
2.Mybatis保存多条记录
我们同样是通过foreach的方法来实现,这里我们巧妙的利用了sql的语法规则用Mybatis的foreach动态语句来处理。
java代码:
public abstract void saves(@Param("tables")List<Model> tables);
xml代码:
insert into table(name,addtime) values <foreach collection="tables" item="item" index="index" separator=","> (#{item.name},#{item.addtime}) </foreach>
以上方法Mybatis会帮我们进行sql注入拦截,Mybatis如果采用#{xxx}的形式设置参数,Mybatis会进行sql注入的过滤。如果采用的是${xxx},Mybatis不会进行sql注入过滤,而是直接将参入的内容输出为sql语句。
参考:http://www.cnblogs.com/fsjohnhuang/p/4078659.html
http://www.suyunyou.com/aid5.html