章节索引 :

MyBatis update

1. 定义

慕课解释:update 标签用于映射 SQL 中的更新语句。

2. 前言

本小节,我们将一起学习 MyBatis update。

在 MyBatis 中,update 标签对应于 SQL 语句中的 update 更新。

3. 实例

3.1 xml 实例

如下就是一个真实的 update 标签实例。

<update id="updateUserAgeById">
  UPDATE imooc_user SET age = #{age} WHERE id = #{id}
</update>

每一个 update 标签都必须有一个唯一的 id 属性,在 update 标签内部则是一条 SQL 语句。

3.2 注解实例

使用如下的注解方式,我们也可以实现同样的功能。

@Update("UPDATE imooc_user SET age = #{age} WHERE id = #{id}")
int updateUserAgeById(@Param("age") Integer age, @Param("id") Integer id);

4. update 属性

update 标签支持一些属性来改变更新语句的行为。

其中常见且重要的属性如下表:

属性 描述
id 在命名空间中的唯一标识符
parameterType 语句的参数类型,默认可选,MyBatis 会自动推断
flushCache 设置为 true 后,只要语句被调用,都会导致本地缓存和二级缓存被清空,默认为 false
timeout 设置超时时间
statementType STATEMENT,PREPARED 或 CALLABLE 中的一个,默认为 PREPARED(预处理)

5. 实践

5.1 例1. 更新用户年龄

请使用 MyBatis 完成对 imooc_user 表中用户年龄更新的功能。

分析:

按照 MyBatis 的开发模式,先在对应 UserMapper.xml 文件中添加用户年龄更新的 update 标签,然后在 UserMapper.java 中增加上对应的方法即可。

步骤:

首先,在 UserMapper.xml 中添加 update 标签,并在标签中写入 SQL :

<update id="updateUserAgeById">
  UPDATE imooc_user SET age = #{age} WHERE id = #{id}
</update>

然后在 UserMapper.java 中添加上对应的接口方法,方法接受 age 和 id 两个参数。

package com.imooc.mybatis.mapper;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

@Mapper
public interface UserMapper {
  int updateUserAgeById(@Param("age") Integer age, @Param("id") Integer id);
}

注意:这里我们使用了@Param这个注解,由于在 update 标签中有两个参数 age 和 id,我们需要通过 @Param 来告诉 MyBatis 参数的对应关系。

结果:

通过如下代码,我们运行 updateUserAgeById 这个方法。

UserMapper userMapper = session.getMapper(UserMapper.class);
int rows = userMapper.updateUserAgeById(180, 1);
System.out.println(rows);
// 一定要提交
session.commit();
session.close();

成功后,id 为 1 的用户年龄已经被更新为 180。

+----+-------------+-----+--------+
| id | username    | age | score  |
+----+-------------+-----+--------+
| 1  | peter       | 180 | 100    |
+----+-------------+-----+--------+

5.2 例2. 更新用户名称和分数

请使用 MyBatis 完成对 imooc_user 表中用户名称和分数更新的功能。

分析:

同上。

步骤:

首先,在 UserMapper.xml 中添加另一个 update 标签,并在标签中写入 SQL :

<update id="updateUsernameAndScoreById">
  UPDATE imooc_user SET username = #{username}, score = #{score} WHERE id = #{id}
</update>

然后在 UserMapper.java 中添加上对应的接口方法,方法接受 username、score 和 id 三个参数。

package com.imooc.mybatis.mapper;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

@Mapper
public interface UserMapper {
  int updateUsernameAndScoreById(@Param("username") String username, @Param("score") Integer score, @Param("id") Integer id);
}

结果:

通过如下代码,我们运行 updateUsernameAndScoreById 这个方法。

UserMapper userMapper = session.getMapper(UserMapper.class);
int rows = userMapper.updateUsernameAndScoreById("peter-gao", 1000,1);
System.out.println(rows);
// 一定要提交
session.commit();
session.close();

成功后,id 为 1 的用户信息已被更改。

+----+-------------+-----+--------+
| id | username    | age | score  |
+----+-------------+-----+--------+
| 1  | peter-gao   | 180 | 1000   |
+----+-------------+-----+--------+

6. 小结

  • update 标签并无太多的知识点,主要的工作量在书写 SQL 上,因此良好的 SQL 功底可以帮助你更加快速的上手 MyBatis。