<div class="htmledit_views" id="content_views">
                                        <p style="margin-left: 10px">一、前言　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 &nbsp;&nbsp;</p>

  数据库操作怎能少了 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 则采用

七、总结　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　

  关于 MyBatis 的 INSERT 操作就总结到这里吧。

  尊重原创，转载来自：http://www.cnblogs.com/fsjohnhuang/p/4078659.html  ^_^ 肥仔 John

八、参考　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　

  http://mybatis.github.io/mybatis-3/zh/dynamic-sql.html 

   如果您觉得本文的内容有趣就扫一下吧！捐赠互勉！