MyBatis注解方式之@Update/@Delete使用详解-eolink官网

MyBatis注解方式之@Update/@Delete使用详解

@Update

1. RoleMapper接口增加接口方法

/**

* @Title: updateSysRoleById

* @Description: updateSysRoleById

* @param sysRole

* @return

* @return: int

@Update({ "update sys_role set role_name = #{roleName},enabled = #{enabled},create_by = #{createBy},create_time = #{createTime, jdbcType=TIMESTAMP} where id = #{id}" })

int updateSysRoleById(SysRole sysRole);

2. 单元测试

@Test

public void updateSysRoleByIdTest() {

logger.info("updateSysRoleByIdTest");

// 获取SqlSession

SqlSession sqlSession = getSqlSession();

try {

// 获取RoleMapper接口

RoleMapper roleMapper = sqlSession.getMapper(RoleMapper.class);

// 先根据ID查询出对应的sysRole

SysRole sysRole = roleMapper.selectSysRoleById((long) 1);

// roleName期望为管理员

Assert.assertEquals("管理员", sysRole.getRoleName());

// 修改RoleName

sysRole.setRoleName("管理员Artisan");

// 修改CreateBy

sysRole.setCreateBy("Artisan");

// 修改用户 ,返回受影响的行数

int result = roleMapper.updateSysRoleById(sysRole);

// 只插入一条数据 ,期望是1

Assert.assertEquals(1, result);

logger.info("受影响的行数:" + result);

// 期望的RoleName为管理员Artisan

Assert.assertEquals("管理员Artisan", sysRole.getRoleName());

// 期望的CreateBy为Artisan

Assert.assertEquals("Artisan", sysRole.getCreateBy());

logger.info("sysRole:" + sysRole);

} catch (Exception e) {

e.printStackTrace();

} finally {

// 为了保持测试数据的干净，这里选择回滚

// 由于默认的sqlSessionFactory.openSession()是不自动提交的

// 除非显式的commit，否则不会提交到数据库

sqlSession.rollback();

logger.info("为了保持测试数据的干净，这里选择回滚,不写入mysql,请观察日志，回滚完成");

sqlSession.close();

logger.info("sqlSession close successfully ");

}

2018-04-19 02:55:57,225 INFO [main] (BaseMapperTest.java:26) - sessionFactory bulit successfully

2018-04-19 02:55:57,230 INFO [main] (BaseMapperTest.java:29) - reader close successfully

2018-04-19 02:55:57,233 INFO [main] (RoleMapperTest.java:229) - updateSysRoleByIdTest

2018-04-19 02:55:57,726 DEBUG [main] (BaseJdbcLogger.java:145) - ==> Preparing: SELECT a.id, a.role_name roleName, a.enabled, a.create_by createBy, a.create_time createTime FROM sys_role a WHERE a.id = ?

2018-04-19 02:55:57,799 DEBUG [main] (BaseJdbcLogger.java:145) - ==> Parameters: 1(Long)

2018-04-19 02:55:57,824 TRACE [main] (BaseJdbcLogger.java:151) - <== Columns: id, roleName, enabled, createBy, createTime

2018-04-19 02:55:57,825 TRACE [main] (BaseJdbcLogger.java:151) - <== Row: 1, 管理员, 1, 1, 2018-04-13 21:12:46.0

2018-04-19 02:55:57,828 DEBUG [main] (BaseJdbcLogger.java:145) - <== Total: 1

2018-04-19 02:55:57,829 DEBUG [main] (BaseJdbcLogger.java:145) - ==> Preparing: update sys_role set role_name = ?,enabled = ?,create_by = ?,create_time = ? where id = ?

2018-04-19 02:55:57,835 DEBUG [main] (BaseJdbcLogger.java:145) - ==> Parameters: 管理员Artisan(String), 1(Integer), Artisan(String), 2018-04-13 21:12:46.0(Timestamp), 1(Long)

2018-04-19 02:55:57,839 DEBUG [main] (BaseJdbcLogger.java:145) - <== Updates: 1

2018-04-19 02:55:57,840 INFO [main] (RoleMapperTest.java:250) - 受影响的行数:1

2018-04-19 02:55:57,845 INFO [main] (RoleMapperTest.java:257) - sysRole:SysRole [id=1, roleName=管理员Artisan, enabled=1, createBy=Artisan, createTime=Fri Apr 13 21:12:46 BOT 2018, user=null, privilegeList=null]

2018-04-19 02:55:57,849 INFO [main] (RoleMapperTest.java:267) - 为了保持测试数据的干净，这里选择回滚,不写入mysql,请观察日志，回滚完成

2018-04-19 02:55:57,851 INFO [main] (RoleMapperTest.java:270) - sqlSession close successfully

@Delete

1. RoleMapper接口增加接口方法

/**

* @Title: deleteSysRoleById

* @Description: deleteSysRoleById

* @param id

* @return

* @return: int

@Delete("delete from sys_role where id = #{id}")

int deleteSysRoleById(Long id);

2. 单元测试

@Test

public void deleteSysRoleByIdTest() {

logger.info("deleteSysRoleByIdTest");

// 获取SqlSession

SqlSession sqlSession = getSqlSession();

try {

// 获取roleMapper接口

RoleMapper roleMapper = sqlSession.getMapper(RoleMapper.class);

// 调用删除接口

int result = roleMapper.deleteSysRoleById((long) 1);

// 期望影响的结果条数为 1

Assert.assertEquals(1, result);

// 再次查询

SysRole sysRole = roleMapper.selectSysRoleById((long) 1);

// 期望查询出来的sysRole 为 null

Assert.assertNull(sysRole);

} catch (Exception e) {

e.printStackTrace();

} finally {

// 为了保持测试数据的干净，这里选择回滚

// 由于默认的sqlSessionFactory.openSession()是不自动提交的

// 除非显式的commit，否则不会提交到数据库

sqlSession.rollback();

logger.info("为了保持测试数据的干净，这里选择回滚,不写入mysql,请观察日志，回滚完成");

sqlSession.close();

logger.info("sqlSession close successfully ");

}

2018-04-19 02:56:23,024 INFO [main] (BaseMapperTest.java:26) - sessionFactory bulit successfully

2018-04-19 02:56:23,027 INFO [main] (BaseMapperTest.java:29) - reader close successfully

2018-04-19 02:56:23,030 INFO [main] (RoleMapperTest.java:276) - deleteSysRoleByIdTest

2018-04-19 02:56:23,517 DEBUG [main] (BaseJdbcLogger.java:145) - ==> Preparing: delete from sys_role where id = ?

2018-04-19 02:56:23,589 DEBUG [main] (BaseJdbcLogger.java:145) - ==> Parameters: 1(Long)

2018-04-19 02:56:23,596 DEBUG [main] (BaseJdbcLogger.java:145) - <== Updates: 1

2018-04-19 02:56:23,599 DEBUG [main] (BaseJdbcLogger.java:145) - ==> Preparing: SELECT a.id, a.role_name roleName, a.enabled, a.create_by createBy, a.create_time createTime FROM sys_role a WHERE a.id = ?

2018-04-19 02:56:23,599 DEBUG [main] (BaseJdbcLogger.java:145) - ==> Parameters: 1(Long)

2018-04-19 02:56:23,625 DEBUG [main] (BaseJdbcLogger.java:145) - <== Total: 0

2018-04-19 02:56:23,628 INFO [main] (RoleMapperTest.java:299) - 为了保持测试数据的干净，这里选择回滚,不写入mysql,请观察日志，回滚完成

2018-04-19 02:56:23,631 INFO [main] (RoleMapperTest.java:302) - sqlSession close successfully

补充知识：Mybatis注解大全 Mybatis支持的所有注解说明

注解

使用对象

相对应的XML

描述

@CacheNamespace

类

为给定的命名空间（比如类）配置缓存。属性有：implemetation, eviction, flushInterval, size, readWrite, blocking 和properties。

@Property

N/A

指定参数值或占位值（placeholder）（能被 mybatis-config.xml内的配置属性覆盖）。属性有：name, value。（仅在MyBatis 3.4.2以上版本生效）

@CacheNamespaceRef

类

参照另外一个命名空间的缓存来使用。属性有：value, name。如果你使用了这个注解，你应设置 value 或者 name 属性的其中一个。value 属性用于指定 Java 类型而指定命名空间（命名空间名就是指定的 Java 类型的全限定名），name 属性（这个属性仅在MyBatis 3.4.2以上版本生效）直接指定了命名空间的名字。

@ConstructorArgs

方法

收集一组结果传递给一个结果对象的构造方法。属性有：value，它是形式参数数组。

@Arg

N/A

单参数构造方法，是 ConstructorArgs 集合的一部分。属性有：id, column, javaType, jdbcType, typeHandler, select 和 resultMap。id 属性是布尔值，来标识用于比较的属性，和 XML 元素相似。

@TypeDiscriminator

方法

一组实例值被用来决定结果映射的表现。属性有：column, javaType, jdbcType, typeHandler 和 cases。cases 属性是实例数组。

@Case

N/A

单独实例的值和它对应的映射。属性有：value, type, results。results 属性是结果数组，因此这个注解和实际的 ResultMap 很相似，由下面的 Results 注解指定。

@Results

方法

结果映射的列表，包含了一个特别结果列如何被映射到属性或字段的详情。属性有：value, id。value 属性是 Result 注解的数组。这个 id 的属性是结果映射的名称。

@Result

N/A

在列和属性或字段之间的单独结果映射。属性有：id, column, javaType, jdbcType, typeHandler, one, many。id 属性是一个布尔值，来标识应该被用于比较（和在 XML 映射中的相似）的属性。one 属性是单独的联系，和相似，而 many 属性是对集合而言的，和相似。它们这样命名是为了避免名称冲突。

@One

N/A

复杂类型的单独属性值映射。属性有：select，已映射语句（也就是映射器方法）的全限定名，它可以加载合适类型的实例。fetchType会覆盖全局的配置参数 lazyLoadingEnabled。注意联合映射在注解 API中是不支持的。这是因为 Java 注解的限制,不允许循环引用。

@Many

N/A

映射到复杂类型的集合属性。属性有：select，已映射语句（也就是映射器方法）的全限定名，它可以加载合适类型的实例的集合，fetchType 会覆盖全局的配置参数 lazyLoadingEnabled。注意联合映射在注解 API中是不支持的。这是因为 Java 注解的限制，不允许循环引用

@MapKey

方法

？？

这是一个用在返回值为 Map 的方法上的注解。它能够将存放对象的 List 转化为 key 值为对象的某一属性的 Map。属性有： value，填入的是对象的属性名，作为 Map 的 key 值。

@Options

方法

映射语句的属性

这个注解提供访问大范围的交换和配置选项的入口，它们通常在映射语句上作为属性出现。Options 注解提供了通俗易懂的方式来访问它们，而不是让每条语句注解变复杂。属性有：useCache=true, flushCache=FlushCachePolicy.DEFENFgVkBAULT, resultSetType=DEFAULT, statementType=PREPARED, fetchSize=-1, timeout=-1, useGeneratedKeys=false, keyProperty="", keyColumn="", resultSets=""。值得一提的是， Java 注解无法指定 null 值。因此，一旦你使用了 Options 注解，你的语句就会被上述属性的默认值所影响。要注意避免默认值带来的预期以外的行为。注意： keyColumn 属性只在某些数据库中有效（如 Oracle、PostgreSQL等）。请在插入语句一节查看更多关于 keyColumn和 keyProperty 两者的有效值详情。

@Insert @Update @Delete @Select

方法

这四个注解分别代表将会被执行的 SQL 语句。它们用字符串数组（或单个字符串）作为参数。如果传递的是字符串数组，字符串之间先会被填充一个空格再连接成单个完整的字符串。这有效避免了以 Java 代码构建 SQL 语句时的“丢失空格”的问题。然而，你也可以提前手动连接好字符串。属性有：value，填入的值是用来组成单个 SQL 语句的字符串数组。

@InsertProvider @UpdateProvider @DeleteProvider @SelectProvider

方法

允许构建动态 SQL。这些备选的 SQL 注解允许你指定类名和返回在运行时执行的 SQL 语句的方法。（自从MyBatis 3.4.6开始，你可以用 CharSequence 代替 String 来返回类型返回值了。）当执行映射语句的时候，MyBatis 会实例化类并执行方法，类和方法就是填入了注解的值。你可以把已经传递给映射方法了的对象作为参数，“Mapper interface type” 和 “Mapper method” and “Database ID” 会经过 ProviderContext （仅在MyBatis 3.4.5及以上支持）作为参数值。（MyBatis 3.4及以上的版本，支持多参数传入）属性有： type, method。 type 属性需填入类。 method 需填入该类定义了的方法名 (Since 3.5.1, you can omit method attribute, the MyBatis will resolve a target method via the ProviderMethodResolver interface. If not resolve by it, the MyBatis use the reserved fallback method that named provideSql)。注意接下来的小节将会讨论类，能帮助你更轻松地构建动态 SQL。

@Param

参数

N/A

如果你的映射方法的形参有多个，这个注解使用在映射方法的参数上就能为它们取自定义名字。若不给出自定义名字，多参数（不包括 RowBounds 参数）则先以 “param” 作前缀，再加上它们的参数位置作为参数别名。例如 #{param1}, #{param2}，这个是默认值。如果注解是 @Param("person")，那么参数就会被命名为 #{person}。

@SelectKey

方法

这个注解的功能与标签完全一致，用在已经被 @Insert 或 @InsertProvider 或 @Update 或 @UpdateProvider 注解了的方法上。若在未被上述四个注解的方法上作 @SelectKey 注解则视为无效。如果你指定了 @SelectKey 注解，那么 MyBatis 就会忽略掉由 @Options注解所设置的生成主键或设置（configuration）属性。属性有：statement填入将会被执行的 SQL 字符串数组，keyProperty 填入将会被更新的参数对象的属性的值，before 填入 true 或 false 以指明 SQL 语句应被在插入语句的之前还是之后执行。resultType 填入 keyProperty 的 Java 类型和用 Statement、 PreparedStatement 和 CallableStatement中的 STATEMENT、 PREPARED 或 CALLABLE中任一值填入 statementType。默认值是 PREPARED。

@ResultMap

方法

N/A

这个注解给 @Select 或者 @SelectProvider提供在 XML 映射中的的id。这使得注解的 select 可以复用那些定义在 XML 中的 ResultMap。如果同一 select 注解中还存在 @Results 或者 @ConstructorArgs，那么这两个注解将被此注解覆盖。

@ResultType

方法

N/A

此注解在使用了结果处理器的情况下使用。在这种情况下，返回类型为 void，所以 Mybatis 必须有一种方式决定对象的类型，用于构造每行数据。如果有 XML 的结果映射，请使用 @ResultMap 注解。如果结果类型在 XML 的

@Flush

方法

N/A

如果使用了这个注解，定义在 Mapper 接口中的方法能够调用 SqlSession#flushStatements() 方法。（Mybatis 3.3及以上）

Flask接口签名sign原理与实例代码浅析

1271 2022-11-11

MyBatis注解方式之@Update/@Delete使用详解

多平台统一管理软件接口，如何实现多平台统一管理软件接口

Flask接口签名sign原理与实例代码浅析

java中的接口是类吗

推荐文章

接口调用是什么意思？几种常用接口调用方式

接口设计原则

8款在线 API 接口文档管理工具

api管理系统是什么？

什么是接口调试？接口调试的步骤有哪些？

api 接口管理系统有哪些？

接口测试有几种测试方法

API文档生成工具有哪些？

微服务和api网关区别

交换机配置步骤

最近发表

热评文章

在线接口文档管理工具推荐，支持在线测试，HTTP接口

开源的在线接口文档wiki工具Mindoc的介绍与使

如何优雅的进行接口设计？接口设计的六大原则是什么？

什么是API测试,api检测公司

软件接口设计怎么做？前后端分离软件接口设计思路

接口管理平台推荐，几大接口管理平台总有一款适合你！