当前位置：首页 > backend >正文

MyBatis 参数处理全解析

backend 2025/5/6 8:20:32

在 Java 开发领域，MyBatis 作为一款优秀的持久层框架，凭借其简洁的设计和强大的功能，受到了广大开发者的青睐。而参数处理作为 MyBatis 中一个至关重要的环节，掌握好它能让我们更高效地使用 MyBatis 进行数据库操作。本文将全面深入地探讨 MyBatis 参数处理的相关知识。

一、基本参数类型处理

1. 基本数据类型

当我们使用基本数据类型（如 int、String、boolean 等）作为参数时，MyBatis 处理起来十分简单直接。在 XML 映射文件中，我们可以通过 parameterType 属性指定参数类型，然后在 SQL 语句里使用 #{} 占位符引用参数。

<select id="findUserById" parameterType="int" resultType="com.example.entity.User">SELECT * FROM user WHERE id = #{id}
</select>

在上述代码中，parameterType="int" 明确表示传入的参数是 int 类型。#{id} 就是对传入参数的引用，MyBatis 会自动将传入的 int 类型参数值绑定到该占位符上。

2. 基本数据类型的包装类

对于基本数据类型的包装类（如 Integer、String、Boolean 等），处理方式与基本数据类型类似。

<select id="findUserByUsername" parameterType="java.lang.String" resultType="com.example.entity.User">SELECT * FROM user WHERE username = #{username}
</select>

这里 parameterType="java.lang.String" 表明传入的是 String 类型的参数，MyBatis 会把传入的 String 值绑定到 #{username} 占位符上。

二、对象类型参数处理

1. 简单 Java 对象

当传入的参数是一个简单的 Java 对象时，我们可以通过对象的属性名来引用参数。

<insert id="insertUser" parameterType="com.example.entity.User">INSERT INTO user (username, password, age) VALUES (#{username}, #{password}, #{age})
</insert>

在这个例子中，parameterType="com.example.entity.User" 表示传入的是 User 类型的对象。MyBatis 会自动将 User 对象的 username、password 和 age 属性值分别绑定到对应的占位符上。

2. 包含嵌套对象的 Java 对象

如果 Java 对象中包含嵌套对象，我们可以通过点号（.）来访问嵌套对象的属性。

<select id="findOrderByUserAddress" parameterType="com.example.entity.Order" resultType="com.example.entity.Order">SELECT * FROM order WHERE user.address = #{user.address}
</select>

这里假设 Order 对象中包含一个 User 对象，而 User 对象又包含 address 属性。MyBatis 会按照对象的层次结构正确地获取并绑定相应的属性值。

三、集合类型参数处理

1. List 集合

当传入的参数是 List 集合时，我们可以使用 foreach 标签来遍历集合。

<select id="findUsersByIds" parameterType="java.util.List" resultType="com.example.entity.User">SELECT * FROM user WHERE id IN<foreach item="item" index="index" collection="list"open="(" separator="," close=")">#{item}</foreach>
</select>

在这个 foreach 标签中，item 表示集合中的每个元素，index 表示元素的索引，collection="list" 表示传入的集合参数。open、separator 和 close 分别表示开始符号、分隔符和结束符号。MyBatis 会将集合中的元素依次取出并拼接成 SQL 语句中的 IN 子句。

2. Map 集合

对于 Map 集合，我们可以通过键名来引用参数。

<select id="findUsersByConditions" parameterType="java.util.Map" resultType="com.example.entity.User">SELECT * FROM user WHERE username = #{username} AND age = #{age}
</select>

这里假设传入的 Map 集合中包含 "username" 和 "age" 这两个键。MyBatis 会根据键名从 Map 中取出对应的值并绑定到 SQL 语句的占位符上。

四、多个参数处理

1. 使用 `@Param` 注解

当方法有多个参数时，我们可以使用 @Param 注解为每个参数指定一个名称。

public interface UserMapper {User findUserByIdAndUsername(@Param("id") int id, @Param("username") String username);
}

<select id="findUserByIdAndUsername" resultType="com.example.entity.User">SELECT * FROM user WHERE id = #{id} AND username = #{username}
</select>

在这个例子中，@Param 注解为参数 id 和 username 分别指定了名称，这样在 XML 映射文件中就可以通过这些名称来引用参数。

2. 使用 JavaBean 封装参数

另一种处理多个参数的方式是使用 JavaBean 来封装这些参数。

public class UserQuery {private int id;private String username;// 省略 getter 和 setter 方法
}

public interface UserMapper {User findUserByQuery(UserQuery userQuery);
}

<select id="findUserByQuery" parameterType="com.example.entity.UserQuery" resultType="com.example.entity.User">SELECT * FROM user WHERE id = #{id} AND username = #{username}
</select>