Mybatis中SqlSession接口中的selectList方法怎么使用

MyBatis 是一个优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。

在 MyBatis 中，SqlSession 是一个非常重要的接口，它提供了执行 SQL 命令、获取映射器实例和管理事务的方法。其中，selectList 方法是 SqlSession 接口中用于执行查询操作并返回结果列表的方法。本文将详细介绍 selectList 方法的使用。

1. SqlSession 接口简介

SqlSession 是 MyBatis 中用于执行 SQL 语句的核心接口。它提供了多种方法来执行 SQL 查询、插入、更新和删除操作。SqlSession 的生命周期通常与数据库连接的生命周期一致，即在一个请求或事务中创建，并在请求或事务结束时关闭。

SqlSession 接口的主要方法包括：

• selectOne: 执行查询并返回单个结果对象。
• selectList: 执行查询并返回结果列表。
• insert: 执行插入操作。
• update: 执行更新操作。
• delete: 执行删除操作。
• commit: 提交事务。
• rollback: 回滚事务。
• close: 关闭 SqlSession。

2. selectList 方法概述

selectList 方法是 SqlSession 接口中用于执行查询操作并返回结果列表的方法。它通常用于查询多条记录，并将结果封装为一个 List 对象。

selectList 方法有多个重载版本，常用的有以下几种：

<E> List<E> selectList(String statement);
<E> List<E> selectList(String statement, Object parameter);
<E> List<E> selectList(String statement, Object parameter, RowBounds rowBounds);

• statement: 映射语句的 ID，通常是在 XML 映射文件中定义的 SQL 语句的 ID。
• parameter: 传递给 SQL 语句的参数对象。
• rowBounds: 用于分页查询的 RowBounds 对象。

3. selectList 方法的使用示例

3.1 基本使用

假设我们有一个 User 表，并且已经在 MyBatis 的 XML 映射文件中定义了如下的查询语句：

<select id="selectAllUsers" resultType="User">
    SELECT * FROM User
</select>

我们可以通过 selectList 方法来执行这个查询并获取所有用户的信息：

SqlSession sqlSession = MyBatisUtil.getSqlSession();
try {
    List<User> userList = sqlSession.selectList("selectAllUsers");
    for (User user : userList) {
        System.out.println(user);
    }
} finally {
    sqlSession.close();
}

在这个例子中，selectList 方法执行了 selectAllUsers 这个 SQL 语句，并将结果封装为一个 List<User> 对象。

3.2 带参数的查询

如果我们需要根据条件查询用户信息，可以在 XML 映射文件中定义带参数的 SQL 语句：

<select id="selectUsersByName" resultType="User">
    SELECT * FROM User WHERE name = #{name}
</select>

然后，我们可以通过 selectList 方法传递参数来执行查询：

SqlSession sqlSession = MyBatisUtil.getSqlSession();
try {
    List<User> userList = sqlSession.selectList("selectUsersByName", "John");
    for (User user : userList) {
        System.out.println(user);
    }
} finally {
    sqlSession.close();
}

在这个例子中，selectList 方法执行了 selectUsersByName 这个 SQL 语句，并将 "John" 作为参数传递给 SQL 语句，查询所有名字为 "John" 的用户。

3.3 分页查询

MyBatis 提供了 RowBounds 类来实现分页查询。我们可以通过 selectList 方法的第三个参数来指定分页信息。

假设我们需要查询第 2 页的用户信息，每页显示 10 条记录：

SqlSession sqlSession = MyBatisUtil.getSqlSession();
try {
    RowBounds rowBounds = new RowBounds(10, 10); // offset, limit
    List<User> userList = sqlSession.selectList("selectAllUsers", null, rowBounds);
    for (User user : userList) {
        System.out.println(user);
    }
} finally {
    sqlSession.close();
}

在这个例子中，RowBounds 的构造函数接收两个参数：offset 和 limit。offset 表示从第几条记录开始查询，limit 表示查询多少条记录。因此，new RowBounds(10, 10) 表示从第 11 条记录开始查询，查询 10 条记录。

4. 注意事项

• selectList 方法返回的是一个 List 对象，如果查询结果为空，返回的是一个空的 List，而不是 null。
• 在使用 selectList 方法时，确保传递的参数类型与 SQL 语句中的参数类型一致，否则可能会导致查询失败。
• 在使用分页查询时，RowBounds 的分页是在内存中进行的，因此对于大数据量的查询，建议使用数据库的分页功能（如 MySQL 的 LIMIT 和 OFFSET）。

5. 总结

selectList 方法是 MyBatis 中用于执行查询操作并返回结果列表的重要方法。通过本文的介绍，我们了解了 selectList 方法的基本使用、带参数的查询以及分页查询的实现方式。在实际开发中，合理使用 selectList 方法可以大大提高数据查询的效率和灵活性。