MyBatis执行完sql后,返回的数值代表的意思

在 MyBatis 中,常见的数据库操作方法返回的数值(如 insertupdatedelete)代表了 受影响的行数,即数据库操作成功后,实际修改(插入、更新或删除)的记录数量。每个方法返回的数值有不同的含义,具体如下:

1. insert(插入操作)

返回值:插入的记录数

  • 返回 1:表示成功插入了一条记录。
  • 返回 0 :理论上,insert 方法不应返回 0,因为插入操作要么成功插入一条记录,要么因为某些错误(如违反唯一约束)导致插入失败。如果返回 0,通常表示插入失败。
示例:
复制代码
@Insert("INSERT INTO user (name, age) VALUES (#{name}, #{age})")
int insertUser(User user);

调用返回 1 表示成功插入了一条记录。

2. update(更新操作)

返回值:更新的记录数

  • 返回 1:表示成功更新了 1 条记录。
  • 返回 0 :表示没有记录被更新。常见的原因包括:
    • 传入的条件没有匹配的记录。
    • 更新的数据与数据库中的数据一致,导致没有实际变化。
    • 由于其他原因(如并发控制等)未能更新任何记录。
示例:
复制代码
@Update("UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}")
int updateUser(User user);

调用返回 1 表示成功更新了一条记录,返回 0 表示没有记录被更新。

3. delete(删除操作)

返回值:删除的记录数

  • 返回 1:表示成功删除了 1 条记录。
  • 返回 0 :表示没有记录被删除。可能的原因包括:
    • 删除条件没有匹配的记录。
    • 由于外键约束等原因,无法删除记录(虽然不常见,依赖于数据库的配置)。
示例:
复制代码
@Delete("DELETE FROM user WHERE id = #{id}")
int deleteUser(Long id);

调用返回 1 表示成功删除了一条记录,返回 0 表示没有记录被删除。

4. select(查询操作)

对于查询操作,返回值的解释略有不同,因为 select 查询的是数据,而不是更新或删除数据。返回值通常是 结果集的数量或数据对象

  • 返回 null 或空集合:表示没有找到符合条件的记录。
  • 返回非空集合或对象 :表示查询到数据,通常是一个 List 或单个对象,具体取决于查询语句。
示例:
复制代码
@Select("SELECT * FROM user WHERE id = #{id}")
User selectUserById(Long id);
  • 如果找到了用户记录,返回 User 对象。
  • 如果没有找到,返回 null

5. batch(批量操作)

对于批量操作,如批量插入、批量更新、批量删除等,返回值通常是操作影响的记录总数。

  • 返回值 :表示批量操作成功影响的行数。
    • 比如,如果你批量插入了 5 条记录,返回值应该是 5。
示例:
复制代码
@Insert({
    "<script>",
    "INSERT INTO user (name, age) VALUES ",
    "<foreach collection='users' item='user' separator=','>",
    "(#{user.name}, #{user.age})",
    "</foreach>",
    "</script>"
})
int insertBatch(List<User> users);

如果 users 列表中有 3 个用户被成功插入,那么返回值应该是 3

总结:

  1. insert 方法返回:插入的记录数(通常为 1,表示成功插入一条记录)。
  2. update 方法返回:更新的记录数(通常为 1,表示成功更新一条记录;0 表示没有更新记录)。
  3. delete 方法返回:删除的记录数(通常为 1,表示成功删除一条记录;0 表示没有删除记录)。
  4. select 方法返回:查询到的记录或对象(null 或空集合表示没有找到数据)。

返回值通常用于判断数据库操作是否成功,以及对操作结果进行进一步的处理或日志记录

相关推荐
小圆5318 分钟前
java-learn(9):常见算法,collection框架
java·开发语言·算法
nbsaas-boot20 分钟前
SaaS 租户上下文传播架构
java·架构·saas
西岭千秋雪_44 分钟前
Zookeeper监听机制
java·linux·服务器·spring·zookeeper
脏脏a1 小时前
【C++ 入门】:引用、内联函数与 C++11 新特性(auto、范围 for、nullptr)全解析
开发语言·c++
毕设源码-林学长1 小时前
计算机毕业设计java和Vue的安全教育科普平台设计与实现 安全知识普及与教育平台 安全教育信息化管理平台
java·开发语言·课程设计
ruleslol1 小时前
java-接口适配器模式 & jsk8 接口默认实现
java·适配器模式
恒者走天下1 小时前
cpp / c++零基础就业学习一站式学习平台
开发语言·c++·学习
Python私教1 小时前
Rust 编程语言基础知识全面介绍
开发语言·后端·rust
鬼火儿1 小时前
网卡驱动架构以及源码分析
java·后端
向前阿、1 小时前
数据结构从基础到实战——排序
c语言·开发语言·数据结构·程序人生·算法