1 简介
- 1.1 单参数
- 1.2 多参数
2 多个接口参数的两种使用方式
- 2.1 Map 方法(不推荐)
- 2.2 @Param 方法(推荐)
3 @Param 的优势
4 Github
一起学 mybatis

1 简介

1.1 单参数

在 Mybatis 中，很多时候，我们传入接口的参数只有一个。对应接口参数的类型有两种，一种是基本的参数类型，一种是 JavaBean。

例如在根据主键获取对象时，我们只需要传入一个主键的参数即可。而在插入，更新等操作时，一般会涉及到很多参数，我们就使用 JavaBean。

1.2 多参数

但是，在实际的情况中，我们遇到类似这样的情况可能：

接口需要使用的参数多于一个；
接口需要使用的参数又远少于对应 JavaBean 的成员变量，或者需要多个 JavaBean 对象；
或者需要使用的参数对应 JavaBean 没有相应的成员变量。

比如获取一段时间产生的日志信息，日志对应的 JavaBean 只有一个日期，那我们使用该 JavaBean 就无法满足我们的要求。

又比如我们进行模糊搜索，搜索条件只有两个，但对应的 JavaBean 有 50+ 个成员变量，那创建对应的 JavaBean 就过于浪费了。

对此，我知道的有如下几种方法

2 多个接口参数的两种使用方式

2.1 Map 方法(不推荐)

Map 方法的使用很简单，就是将对应的参数以 key-value 的方式存储， key 对应 SQL 中的参数名字， value 对应需要传入的参数值。

以获取一段时间内存储的用户为例

2.1.1 创建接口方法

     /**
     * 获取一段时间内的用户
     * @param params
     * @return
     */
    List<Student> selectBetweenCreatedTime(Map<String, Object> params);

该方法返回的是多个记录，因此使用 List 作为返回值。

2.1.2 配置对应的SQL

  <select id="selectBetweenCreatedTime" parameterType="java.util.Map" resultMap="BaseResultMap">
    select
    <include refid="Base_Column_List" />
    from student
    where gmt_created &gt; #{bTime, jdbcType=TIMESTAMP} and gmt_created &lt; #{eTime, jdbcType=TIMESTAMP}
  </select>

id 与之前创建的方法名一样。

2.1.3 调用

@Test
public void testSelectBtweenCreatedTimeMap() {

    Map<String, Object> params = new HashMap<>();
    Calendar bTime = Calendar.getInstance();
    // month 是从0~11， 所以9月是8
    bTime.set(2018, Calendar.AUGUST, 29);
    params.put("bTime", bTime.getTime());

    Calendar eTime = Calendar.getInstance();
    eTime.set(2018,Calendar.SEPTEMBER,2);
    params.put("eTime", eTime.getTime());
    SqlSession sqlSession = null;
    try {
        sqlSession = sqlSessionFactory.openSession();

        StudentMapper studentMapper = (StudentMapper) sqlSession.getMapper(StudentMapper.class);
        List<Student> students = studentMapper.selectBetweenCreatedTime(params);
        for (int i = 0; i < students.size(); i++) {
            System.out.println(students.get(i));
        }
    } catch (Exception e) {
        e.printStackTrace();
    } finally {
        if (sqlSession != null) {
            sqlSession.close();
        }
    }

}

调用方法很简单，传入相应的 Map 参数即可。此时， Map 中的 key 对应。因此，在此例子中传入的参数

传入一个 key 为 btime 的时间，作为开始时间；
传入一个 key为 etime 的时间，作为结束时间；

2.2 @Param 方法(推荐)

@Param 方法就是使用注解的方式，

2.2.1 创建接口方法

/**
 * 获取指定时间内的对象
 * @param pbTime 开始时间
 * @param peTime 结束时间
 * @return
 */
List<Student> selectBetweenCreatedTimeAnno(@Param("bTime")Date pbTime, @Param("eTime")Date peTime);

@Param("bTime") 就是告诉 mybatis , 参数 pbTime 在 SQL 语句中用 bTime 作为 key。

也就是说， mybatis 帮我们完成了调用时, 类似 params.put("bTime", pbTime) 这个过程。

2.2.2 配置 SQL 语句

  <select id="selectBetweenCreatedTimeAnno" resultMap="BaseResultMap">
    select
    <include refid="Base_Column_List" />
    from student
    where gmt_created &gt; #{bTime, jdbcType=TIMESTAMP} and gmt_created &lt; #{eTime, jdbcType=TIMESTAMP}
  </select>

此处的 bTime 对应** @Param("bTime")** 中的 bTime, 需要完全一致。

eTime 也是一样。

2.2.3 调用

在调用时，不需要创建 Map 了，只需要按参数提示传入对应的实际参数即可。

 @Test
public void testSelectBtweenCreatedTimeAnno() {

    Map<String, Object> params = new HashMap<>();
    Calendar bTime = Calendar.getInstance();
    // month 是从0~11， 所以9月是8
    bTime.set(2018, Calendar.AUGUST, 29);


    Calendar eTime = Calendar.getInstance();
    eTime.set(2018,Calendar.SEPTEMBER,2);

    SqlSession sqlSession = null;
    try {
        sqlSession = sqlSessionFactory.openSession();

        StudentMapper studentMapper = (StudentMapper) sqlSession.getMapper(StudentMapper.class);
        List<Student> students = studentMapper.selectBetweenCreatedTimeAnno(bTime.getTime(), eTime.getTime());
        for (int i = 0; i < students.size(); i++) {
            System.out.println(students.get(i));
        }
    } catch (Exception e) {
        e.printStackTrace();
    } finally {
        if (sqlSession != null) {
            sqlSession.close();
        }
    }

}

3 @Param 的优势

Map 方式的缺点就是需要手动创建 Map, 并对 SQL 中的参数进行赋值。其缺点：

手动创建 Map 这个过程很不简洁，看着很繁琐。
手动对参数进行赋值，很容易出错。比如本来是要 params.put("bTime", bTime) 可能会不小心写成 params.put("bime", bTime)，但是这个时候编译器并不会提示。

相比于 Map 方式，使用 @Param 时，我们在使用上就像调用方法一样，传入对应的实际参数即可。调用时基本不会出错。

4 Github

相应代码，可以访问我的Github-helloMybatis

一起学 mybatis

你想不想来学习 mybatis? 学习其使用和源码呢？那么，在博客园关注我吧！！

我自己打算把这个源码系列更新完毕，同时会更新相应的注释。快去 star 吧！！

mybatis最新源码和注释

mybatis 多个接口参数的注解使用方式（@Param)

秒客网