MyBatis 中 @Param 注解的四种使用场景，最后一种经常被人忽略！

有一些小伙伴觉得 MyBatis 只有方法中存在多个参数的时候，才需要添加 @Param 注解，其实这个理解是不准确的。即使 MyBatis 方法只有一个参数，也可能会用到 @Param 注解。

但是，在你总结出规律之前，你可能会觉得莫名其妙，有的时候一个参数明明不用添加 @Param 注解，有的时候，却需要添加，不添加会报错。

有的人会觉得这是 MyBatis 各个版本差异的锅，不可否认，MyBatis 发展很快，不同版本之间的差异还挺明显的，不过这个加不加 @Param 注解的问题，却并不是版本的锅！今天松哥就和大家来聊一聊这个问题，到底哪些情况下需要添加 @Param 注解。

首先，如下几个需要添加 @Param 注解的场景，相信大家都已经有共识了：

• 第一种：方法有多个参数，需要 @Param 注解

例如下面这样：

1. @Mapper

2. public interface UserMapper {

3. Integer insert(@Param("username") String username, @Param("address") String address);

4. }

对应的 XML 文件如下：

1. <insert id="insert" parameterType="org.javaboy.helloboot.bean.User">

2. insert into user (username,address) values (#{username},#{address});

3. </insert>

这是最常见的需要添加 @Param 注解的场景。

• 第二种：方法参数要取别名，需要 @Param 注解

当需要给参数取一个别名的时候，我们也需要 @Param 注解，例如方法定义如下：

1. @Mapper

2. public interface UserMapper {

3. User getUserByUsername(@Param("name") String username);

4. }

对应的 XML 定义如下：

1. <select id="getUserByUsername" parameterType="org.javaboy.helloboot.bean.User">

2. select * from user where username=#{name};

3. </select>

老实说，这种需求不多，费事。

• 第三种：XML 中的 SQL 使用了 $ ，那么参数中也需要 @Param 注解

$ 会有注入漏洞的问题，但是有的时候你不得不使用 $ 符号，例如要传入列名或者表名的时候，这个时候必须要添加 @Param 注解，例如：

1. @Mapper

2. public interface UserMapper {

3. List<User> getAllUsers(@Param("order_by")String order_by);

4. }

对应的 XML 定义如下：

1. <select id="getAllUsers" resultType="org.javaboy.helloboot.bean.User">

2. select * from user

3. <if test="order_by!=null and order_by!=''">

4. order by ${order_by} desc

5. </if>

6. </select>

前面这三种，都很容易懂，相信很多小伙伴也都懂，除了这三种常见的场景之外，还有一个特殊的场景，经常被人忽略。

• 第四种，那就是动态 SQL ，如果在动态 SQL 中使用了参数作为变量，那么也需要 @Param 注解，即使你只有一个参数。

如果我们在动态 SQL 中用到了 参数作为判断条件，那么也是一定要加 @Param 注解的，例如如下方法：

1. @Mapper

2. public interface UserMapper {

3. List<User> getUserById(@Param("id")Integer id);

4. }

定义出来的 SQL 如下：

1. <select id="getUserById" resultType="org.javaboy.helloboot.bean.User">

2. select * from user

3. <if test="id!=null">

4. where id=#{id}

5. </if>

6. </select>

这种情况，即使只有一个参数，也需要添加 @Param 注解，而这种情况却经常被人忽略！

好了，不知道大家有没有 GET 到呢？有问题欢迎留言讨论。

---

往期精彩回顾：

对于加入松哥知识星球的同学提供基本的福利：

松哥最新录制的 Spring Boot2.1.6 视频教程，已于上周开始连载，Spring Boot 中的方方面面+手把手带你做微人事项目：

 https://t.zsxq.com/EUNjma6

海量学习资源分享，包含各种面试题

 https://t.zsxq.com/NNVfUzR

最重要的就是松哥亲自录制了一套 Spring Boot 视频，这套视频加密，加入星球可以免费下载学习，松哥的视频和松哥的博客一样，条理清晰，深入浅出简单易懂。

我做知识星球的目的和其他星主一样，就是为了帮助大家一起更好的成长，与高手拉近距离，减少差距，其实你也是高手！

来两个小伙伴的评价

Java 达摩院

加入星球不满意，三天内无条件退款。

你点的每个在看，我都认真当成了喜欢