MyBatis-04 MyBatis XML方式之insert元素

标签: mybatis insert
43人阅读 评论(0) 收藏 举报
分类:

insert概述

MyBatis-03 MyBatis XML方式之select元素比起来,insert要简单的多。 只有让它返回主键值时,由于不同的数据库的主键生成方式不同,这种情况会复杂一点。


简单的insert用法

1. UserMapper中添加接口方法

    /**
     * 
     * 
     * @Title: insertSysUser
     * 
     * @Description: 增加SysUser
     * 
     * @param sysUser
     * @return
     * 
     * @return: int 受影响的行数
     */
    int insertSysUser(SysUser sysUser);

2. UserMapper.xml 添加节点

<!-- 添加SysUser -->
    <insert id="insertSysUser" >
        insert into sys_user(
            id,user_name, user_password, user_email, 
            user_info, head_img, create_time)
        values(
            #{id},#{userName}, #{userPassword}, #{userEmail}, 
            #{userInfo}, #{headImg, jdbcType=BLOB}, #{createTime, jdbcType=TIMESTAMP})
    </insert>

先看下insert元素标签包含的属性

这里写图片描述

  • id:命名空间中的唯一标示符

  • parameterType:传入的语句参数的全限定类名或者别名,因为 MyBatis可以推断传入语句的具体参数,因此不建议配置该属性

  • flushCache :默认true,任何时候只要语句被调用,都会清空一级缓存和二级缓存

  • timeout:设置在抛出异常之前,驱动程序等待数据库返回请求结果的秒数

  • statementType : 默认PREPARED

  • useGenerateKeys: 默认false. 如果设置为true , MyBatis会使用JDBC的getGeneratedKeys方法取出由数据库内部生成的主键

  • keyProperty: MyBatis通过getGeneratedKeys获取组建后要将辅助的属性名。

  • keyColumn:仅对UPDATE和INSERT又有,通过生成的键值设置表中的列名。

  • databaseId:如果配置了databaseIdProvider, MyBatis会加载所有的不带databaseId或者匹配当前databaseId的语句。 如果同时存在带databaseId和不带databaseId的语句,后者将被忽略。

此外,insert中的sql语句就是一个简单的insert语句,将所有的列都列举出来,在value中通过#{property}方式从参数中取出属性的值

为了防止类型错误,对于一些特殊的数据类型,建议指定具体的jdbcType值#{headImg, jdbcType=BLOB}, #{createTime, jdbcType=TIMESTAMP}


3. 编写单元测试

@Test
    public void insertSysUserTest() {
        logger.info("insertSysUserTest");
        // 获取SqlSession
        SqlSession sqlSession = getSqlSession();
        try {
            // 获取UserMapper接口
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            SysUser sysUser = new SysUser();
            sysUser.setUserName("artisanTest");
            sysUser.setUserPassword("123456");
            sysUser.setUserEmail("test@artisan.com");
            sysUser.setUserInfo("测试用户");
            // 模拟头像
            sysUser.setHeadImg(new byte[] { 1, 2, 3 });
            sysUser.setCreateTime(new Date());
            // 新增用户 ,返回受影响的行数
            int result = userMapper.insertSysUser(sysUser);

            // 只插入一条数据 ,期望是1
            Assert.assertEquals(1, result);
            // id 为null , 因为没有给ID赋值,也没有配置回写id的值 ,期望是null
            Assert.assertNull(sysUser.getId());

            logger.info("受影响的行数:" + result);
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            // 为了保持测试数据的干净,这里选择回滚
            // 由于默认的sqlSessionFactory.openSession()是不自动提交的
            // 除非显式的commit,否则不会提交到数据库
            sqlSession.rollback();
            logger.info("为了保持测试数据的干净,这里选择回滚,不写入mysql,请观察日志,回滚完成");

            sqlSession.close();
            logger.info("sqlSession close successfully ");
        }
    }

日志

2018-04-15 18:32:49,378  INFO [main] (BaseMapperTest.java:26) - sessionFactory bulit successfully
2018-04-15 18:32:49,383  INFO [main] (BaseMapperTest.java:29) - reader close successfully
2018-04-15 18:32:49,386  INFO [main] (UserMapperTest.java:152) - insertSysUserTest
2018-04-15 18:32:49,970 DEBUG [main] (BaseJdbcLogger.java:142) - ==>  Preparing: insert into sys_user( id,user_name, user_password, user_email, user_info, head_img, create_time) values( ?,?, ?, ?, ?, ?, ?) 
2018-04-15 18:32:50,060 DEBUG [main] (BaseJdbcLogger.java:142) - ==> Parameters: null, artisanTest(String), 123456(String), test@artisan.com(String), 测试用户(String), java.io.ByteArrayInputStream@50a14c18(ByteArrayInputStream), 2018-04-15 18:32:49.403(Timestamp)
2018-04-15 18:32:50,066 DEBUG [main] (BaseJdbcLogger.java:142) - <==    Updates: 1
2018-04-15 18:32:50,067  INFO [main] (UserMapperTest.java:174) - 受影响的行数:1
2018-04-15 18:32:50,078  INFO [main] (UserMapperTest.java:182) - 为了保持测试数据的干净,这里选择回滚,不写入mysql,请观察日志,回滚完成
2018-04-15 18:32:50,080  INFO [main] (UserMapperTest.java:185) - sqlSession close successfully 

使用JDCB方式返回主键自增的值

在使用主键自增(比如MySql 、SQLServer数据库)时,插入数据库后可以需要得到自增的主键值,然后使用这个值进行一些其他的操作。

1.UserMapper接口增加接口方法

// 演示使用JDBC方式返回主键的自增长值
int insertSysUser2(SysUser sysUser);

2.UserMapper.xml 配置

    <!-- 添加SysUser 使用JDBC的方式返回自增长的主键的值-->
    <insert id="insertSysUser2"  useGeneratedKeys="true" keyProperty="id">
        insert into sys_user(
            user_name, user_password, user_email, 
            user_info, head_img, create_time)
        values(
            #{userName}, #{userPassword}, #{userEmail}, 
            #{userInfo}, #{headImg, jdbcType=BLOB}, #{createTime, jdbcType=TIMESTAMP})
    </insert>

和insertSysUser比较, insertSysUser2主要的变化是在insert 标签上配置了两个属性

 useGeneratedKeys="true" keyProperty="id"

useGeneratedKeys设置为true后, MyBatis会使用JDBC的getGeneratedKeys方法来取由数据库内部生成的主键。 获取主键值后将其赋值给keyProperty配置的id属性。

当需要设置多个属性时,使用逗号分开,这种情况下通常还需要设置keyColunm属性,按顺序指定数据库的列,这里的列的值会和keyProperty配置的属性一一对应。

由于使用数据库返回的主键值,所以SQL上线两部分中的列去掉了id列和对应的#{id}属性。


3.单元测试

@Test
    public void insertSysUser2Test() {
        logger.info("insertSysUser2Test");
        // 获取SqlSession
        SqlSession sqlSession = getSqlSession();
        try {
            // 获取UserMapper接口
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            SysUser sysUser = new SysUser();
            sysUser.setUserName("artisanTest");
            sysUser.setUserPassword("123456");
            sysUser.setUserEmail("test@artisan.com");
            sysUser.setUserInfo("测试用户");
            // 模拟头像
            sysUser.setHeadImg(new byte[] { 1, 2, 3 });
            sysUser.setCreateTime(new Date());
            // 新增用户 ,返回受影响的行数
            int result = userMapper.insertSysUser2(sysUser);

            // 只插入一条数据 ,期望是1
            Assert.assertEquals(1, result);
            // id不为null ,因为使用了 useGeneratedKeys="true" keyProperty="id"
            Assert.assertNotNull(sysUser.getId());

            logger.info("受影响的行数:" + result);
            logger.info("userId:" + sysUser.getId());
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            // 为了保持测试数据的干净,这里选择回滚
            // 由于默认的sqlSessionFactory.openSession()是不自动提交的
            // 除非显式的commit,否则不会提交到数据库
            sqlSession.rollback();
            logger.info("为了保持测试数据的干净,这里选择回滚,不写入mysql,请观察日志,回滚完成");

            sqlSession.close();
            logger.info("sqlSession close successfully ");
        }
    }

日志

2018-04-16 00:36:27,508  INFO [main] (BaseMapperTest.java:26) - sessionFactory bulit successfully
2018-04-16 00:36:27,511  INFO [main] (BaseMapperTest.java:29) - reader close successfully
2018-04-16 00:36:27,514  INFO [main] (UserMapperTest.java:191) - insertSysUser2Test
2018-04-16 00:36:28,049 DEBUG [main] (BaseJdbcLogger.java:142) - ==>  Preparing: insert into sys_user( user_name, user_password, user_email, user_info, head_img, create_time) values( ?, ?, ?, ?, ?, ?) 
2018-04-16 00:36:28,112 DEBUG [main] (BaseJdbcLogger.java:142) - ==> Parameters: artisanTest(String), 123456(String), test@artisan.com(String), 测试用户(String), java.io.ByteArrayInputStream@4021065(ByteArrayInputStream), 2018-04-16 00:36:27.526(Timestamp)
2018-04-16 00:36:28,124 DEBUG [main] (BaseJdbcLogger.java:142) - <==    Updates: 1
2018-04-16 00:36:28,125  INFO [main] (UserMapperTest.java:213) - 受影响的行数:1
2018-04-16 00:36:28,125  INFO [main] (UserMapperTest.java:214) - userId:1002
2018-04-16 00:36:28,127  INFO [main] (UserMapperTest.java:222) - 为了保持测试数据的干净,这里选择回滚,不写入mysql,请观察日志,回滚完成
2018-04-16 00:36:28,129  INFO [main] (UserMapperTest.java:225) - sqlSession close successfully 

使用selectKey返回主键的值

上面这种写法只适用于支持组件自增的数据库,有些数据库比如Oracle不提供主键自增的功能,而是使用序列得到一个值,然后将这个值赋给id ,然后再插入数据库。

对应这种情况,可以使用 selectKey标签来获取主键的值,这种方式不仅使用不提供主键自增功能的数据库,同时也适用于提供主键自增功能的数据库

1.UserMapper接口增加接口方法

// 演示使用selectKey的方式返回主键的自增长值
int insertSysUser3(SysUser sysUser);

2.UserMapper.xml 配置

    <!-- 添加SysUser 使用selectKey的方式返回自增长的主键的值-->
    <insert id="insertSysUser3">
        insert into sys_user(
            user_name, user_password, user_email, 
            user_info, head_img, create_time)
        values(
            #{userName}, #{userPassword}, #{userEmail}, 
            #{userInfo}, #{headImg, jdbcType=BLOB}, #{createTime, jdbcType=TIMESTAMP})

        <selectKey keyColumn="id" resultType="long" keyProperty="id"  order="AFTER">
            select last_insert_id()
        </selectKey>
    </insert>
  • selectKey标签的keyColum、keyProperty
    和上面useGeneratedKeys的用法含义相同。

  • resultType用于设置返回值的类型。

  • order属性的设置和数据库有关。

    Mysql中,order属性设置为AFTER。因为当前记录的主键值是在insert语句执行成功后才获取到的。
    Oracle数据库中,order的值设置为BEFORE,这是因为ORCLE数据库需要先从序列中获取中,然后将值作为主键插入数据库中

ORACLE的写法如下

<insert  id="insertUser" >
<selectKey resultType="java.lang.Integer" order="BEFORE" 
keyProperty="id">
    SELECT 自定义序列.NEXTVAL FROM DUAL
</selectKey>

insert into *******
</insert>
注意这里使用的order是“BEFORE”

3.单元测试

    @Test
    public void insertSysUser3Test() {
        logger.info("insertSysUser3Test");
        // 获取SqlSession
        SqlSession sqlSession = getSqlSession();
        try {
            // 获取UserMapper接口
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            SysUser sysUser = new SysUser();
            sysUser.setUserName("artisanTest");
            sysUser.setUserPassword("123456");
            sysUser.setUserEmail("test@artisan.com");
            sysUser.setUserInfo("测试用户");
            // 模拟头像
            sysUser.setHeadImg(new byte[] { 1, 2, 3 });
            sysUser.setCreateTime(new Date());
            // 新增用户 ,返回受影响的行数
            int result = userMapper.insertSysUser3(sysUser);

            // 只插入一条数据 ,期望是1
            Assert.assertEquals(1, result);
            // id不为null ,因为使用了 useGeneratedKeys="true" keyProperty="id"
            Assert.assertNotNull(sysUser.getId());

            logger.info("受影响的行数:" + result);
            logger.info("userId:" + sysUser.getId());
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            // 为了保持测试数据的干净,这里选择回滚
            // 由于默认的sqlSessionFactory.openSession()是不自动提交的
            // 除非显式的commit,否则不会提交到数据库
            sqlSession.rollback();
            logger.info("为了保持测试数据的干净,这里选择回滚,不写入mysql,请观察日志,回滚完成");

            sqlSession.close();
            logger.info("sqlSession close successfully ");
        }
    }

日志

2018-04-16 00:44:17,807  INFO [main] (BaseMapperTest.java:26) - sessionFactory bulit successfully
2018-04-16 00:44:17,811  INFO [main] (BaseMapperTest.java:29) - reader close successfully
2018-04-16 00:44:17,814  INFO [main] (UserMapperTest.java:231) - insertSysUser3Test
2018-04-16 00:44:18,278 DEBUG [main] (BaseJdbcLogger.java:142) - ==>  Preparing: insert into sys_user( user_name, user_password, user_email, user_info, head_img, create_time) values( ?, ?, ?, ?, ?, ?) 
2018-04-16 00:44:18,353 DEBUG [main] (BaseJdbcLogger.java:142) - ==> Parameters: artisanTest(String), 123456(String), test@artisan.com(String), 测试用户(String), java.io.ByteArrayInputStream@18a52c57(ByteArrayInputStream), 2018-04-16 00:44:17.833(Timestamp)
2018-04-16 00:44:18,359 DEBUG [main] (BaseJdbcLogger.java:142) - <==    Updates: 1
2018-04-16 00:44:18,361 DEBUG [main] (BaseJdbcLogger.java:142) - ==>  Preparing: select last_insert_id() 
2018-04-16 00:44:18,362 DEBUG [main] (BaseJdbcLogger.java:142) - ==> Parameters: 
2018-04-16 00:44:18,386 TRACE [main] (BaseJdbcLogger.java:148) - <==    Columns: last_insert_id()
2018-04-16 00:44:18,386 TRACE [main] (BaseJdbcLogger.java:148) - <==        Row: 1003
2018-04-16 00:44:18,389 DEBUG [main] (BaseJdbcLogger.java:142) - <==      Total: 1
2018-04-16 00:44:18,391  INFO [main] (UserMapperTest.java:253) - 受影响的行数:1
2018-04-16 00:44:18,391  INFO [main] (UserMapperTest.java:254) - userId:1003
2018-04-16 00:44:18,396  INFO [main] (UserMapperTest.java:262) - 为了保持测试数据的干净,这里选择回滚,不写入mysql,请观察日志,回滚完成
2018-04-16 00:44:18,398  INFO [main] (UserMapperTest.java:265) - sqlSession close successfully 

Mysql使用 uuid实现主键

需要增加通过select uuid()得到uuid值

<insert  id="insertUser">
    <selectKey resultType="java.lang.String" order="BEFORE" 
        keyProperty="id">
    select uuid()
    </selectKey>
    insert into sys_user(
                user_name, user_password, user_email, 
                user_info, head_img, create_time)
            values(
                #{userName}, #{userPassword}, #{userEmail}, 
                #{userInfo}, #{headImg, jdbcType=BLOB}, #{createTime, jdbcType=TIMESTAMP})
</insert>

注意这里使用的order是“BEFORE” , 比较简单就不再测试了。

查看评论

mybatis批量insert的mapper xml写法

order= "AFTER">                 SELECT LAST_INSERT_ID()                        insert into redee...
  • learner198461
  • learner198461
  • 2016-12-28 19:33:04
  • 2280

mybatis的xml映射文件SQL语句的增删改查、参数、缓存

2.2 select 一个select 元素非常简单。例如: Xml代码      select id="getStudent" parameterType="Stri...
  • alan_liuyue
  • alan_liuyue
  • 2017-05-13 12:24:31
  • 526

MyBatis——XML映射文件—更新(Mapper XML文件——Insert ,Update,delete)

数据变更语句 insert,update 和 delete 的实现非常接近:
  • m0_37530301
  • m0_37530301
  • 2017-04-18 10:56:26
  • 1354

MyBatis_insert

  • 2017年04月22日 22:11
  • 4.57MB
  • 下载

Mybatis下mapper映射文件配置之insert、update、delete

本篇文章将简单介绍 insert, update, delete 的配置及使用 ,以后会对mybatis的源码进行深入讲解。 相信,看到insert, update, delete, 我们就知道...
  • Summer_YuXia
  • Summer_YuXia
  • 2016-11-15 15:26:59
  • 11302

04 Mybatis应用篇---XML映射文件之select,insert,update,delete基础介绍

官方说:"MyBatis 的真正强大在于它的映射语句,也是它的魔力所在。由于它的异常强大,映射器的 XML 文件就显得相对简单。如果拿它跟具有相同功能的 JDBC 代码进行对比,你会立即发现省掉了将近...
  • mmd0308
  • mmd0308
  • 2017-04-07 11:50:15
  • 416

Mybatis配置之<properties>属性配置元素详述

紧接着上篇博客《Mybatis的配置文件入门介绍 》,我们开始对mybatis核心配置文件中的各个元素进行详细的说明,在这篇文章中,我们首先来看下元素,这个元素从上篇文章中可以看到是最先被解析的,设置...
  • andamajing
  • andamajing
  • 2017-05-09 13:03:08
  • 722

mybatis的insert元素属性详解 及 在insert插入数据获取主键id的值

其属性如下:    parameterType ,入参的全限定类名或类型别名    keyColumn ,设置数据表自动生成的主键名。对特定数据库(如PostgreSQL),若自动生成的主...
  • a281246240
  • a281246240
  • 2016-12-05 11:43:57
  • 8737

MyBatis Dao插入数据的实现

其中,sqlSession.insert("insertStudent",student)的insertStudent是映射文件的Id!
  • sinat_27115575
  • sinat_27115575
  • 2017-04-06 11:43:28
  • 316
    个人资料
    专栏达人 持之以恒
    等级:
    访问量: 142万+
    积分: 2万+
    排名: 503
    WeChat
      欢迎关注我的公众号,干货只有干货,还有更多惊喜和资源在等着你
    博客专栏