• 环境配置

java 版本: jdk1.8

Mybatis 版本: 3.4.1

SpringBoot 整合 Mybatis 版本: SpringBoot2.0

  • 涉及到的知识点:

jdk8 新增了-parameters 参数,开启此参数可以将编译后的 class 文件保留源码中的参数名称,而不是(arg0,arg1)。保留参数名称方便判断反射参数。由于 Java8 的新特性,使得 Mybatis 在 3.4.1 版本后可以省略 @Param 注解。

起始原因:

在回顾 Mybatis 的基础知识点编写 Demo 程序时,发现 Mapper 接口中传递多参数时,需要添加 @param 注解指定传递参数名称,而在 SpringBoot 整合 Mybatis 框架的项目中则可以省略 @param 注解。于是乎,开始探究原因。

下面开始我们的探索之旅

1、新建 mybatis 的 Demo 项目

1.1、首先创建一个 Mybatis 的单独的 Demo, 并编写 UserMapper.java,这里省略 @Param 注解。这里使用的只是非常简单的查询语句。

public interface UserMapper {
    User getUser(String username, String password);
}

1.2、创建完 Demo,编写完 Mapper 接口和 xml 文件后,在 Test 目录下开始编写测试类。

public class MyBatisTest {
    @Test
    public void testCrud() throws IOException {
        InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
        SqlSession sqlSession = sqlSessionFactory.openSession(true);
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        User admin = mapper.getUser("admin", "123456");
        System.out.println(admin);
    }
}

Debug 路线如下: 直接上图

Java Mybatis忽略大小写_mybatis

Java Mybatis忽略大小写_Java Mybatis忽略大小写_02

此时参数封装的结构为:

Java Mybatis忽略大小写_mybatis_03

然后就不出意外的报错了

Java Mybatis忽略大小写_sql_04

那么如何解决呢?

2、添加-parameters 参数后的执行结果如下:

为了解决以上问题,在 pom 文件添加插件并参加参数,参数的意义: 让编译器在编译代码时,保留参数的实际名称。

<build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <compilerArgs>
                        <arg>-parameters</arg>
                    </compilerArgs>
                </configuration>
            </plugin>
        </plugins>
    </build>

添加插件和参数后, 可以在 idea 查看编译器添加参数的情况。

Java Mybatis忽略大小写_Java Mybatis忽略大小写_05

此时 Mybatis 封装参数效果如下:

Java Mybatis忽略大小写_sql_06

那么执行结果如何呢?

Java Mybatis忽略大小写_java_07

没有问题,只是数据库没有匹配的数据。

那么为什么 springboot 项目我们没有配置过这类的参数,但是也可以省略 @param 注解呢?

3、SpringBoot 项目为什么不用另外配置-parameters 参数呢

首先新建一个 springboot 项目(2.0.3 版本), 查看 POM 的依赖管理文件和参数设置。

Java Mybatis忽略大小写_mybatis_08

Java Mybatis忽略大小写_sql_09

此时就看到了熟悉的关键字。为了确认是否这个参数,于是乎将这一段注释掉。

Java Mybatis忽略大小写_Java Mybatis忽略大小写_10

想法得到验证。

想法得到验证。然后在 SpringBoot1.x 版本中,目前已知的是 SpringBoot1.5.1 版本没有添加该参数。