mybatis模糊查询操作指南-精创网络云防护

帮助文档
mybatis模糊查询操作指南
来源：www.jcwlyf.com浏览：33更新：2025-11-26
MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。在实际开发中，模糊查询是一个非常常见的需求，比如在搜索功能中，用户可能只记得部分关键词，这时就需要使用模糊查询来获取相关的数据。本文将为你详细介绍 MyBatis 中模糊查询的操作指南。
一、模糊查询的基本概念
模糊查询是指在数据库中搜索满足特定模式的数据，而不是精确匹配。在 SQL 中，通常使用 LIKE 关键字结合通配符来实现模糊查询。常见的通配符有：
1. %：代表任意数量（包括 0 个）的任意字符。
2. _：代表单个任意字符。
例如，要查询所有以“张”开头的姓名，可以使用“张%”；要查询所有姓名为两个字且第二个字为“三”的，可以使用“_三”。
二、MyBatis 中实现模糊查询的几种方式
1. 在 SQL 语句中直接拼接通配符
这种方式是最直接的，即在 SQL 语句中直接将通配符和参数拼接起来。以下是一个示例：
```
<select id="findUsersByName" resultType="com.example.User">
    SELECT * FROM users WHERE name LIKE '${name}%'
</select>
```
在 Java 代码中调用该方法：
```
SqlSession session = sqlSessionFactory.openSession();
UserMapper userMapper = session.getMapper(UserMapper.class);
List<User> users = userMapper.findUsersByName("张");
session.close();
```
这种方式的优点是简单直接，缺点是存在 SQL 注入的风险，因为使用了 ${} 占位符，它会直接将参数替换到 SQL 语句中。
2. 在 Java 代码中拼接通配符
为了避免 SQL 注入的风险，可以在 Java 代码中拼接通配符，然后使用 #{} 占位符。示例如下：
```
<select id="findUsersByName" resultType="com.example.User">
    SELECT * FROM users WHERE name LIKE #{name}
</select>
```
在 Java 代码中：
```
SqlSession session = sqlSessionFactory.openSession();
UserMapper userMapper = session.getMapper(UserMapper.class);
String name = "张%";
List<User> users = userMapper.findUsersByName(name);
session.close();
```
这种方式使用了 #{} 占位符，MyBatis 会对参数进行预编译处理，避免了 SQL 注入的风险。
3. 使用 CONCAT 函数
在 SQL 中，可以使用 CONCAT 函数来拼接字符串。示例如下：
```
<select id="findUsersByName" resultType="com.example.User">
    SELECT * FROM users WHERE name LIKE CONCAT('%', #{name}, '%')
</select>
```
在 Java 代码中：
```
SqlSession session = sqlSessionFactory.openSession();
UserMapper userMapper = session.getMapper(UserMapper.class);
List<User> users = userMapper.findUsersByName("张");
session.close();
```
这种方式同样使用了 #{} 占位符，避免了 SQL 注入的风险，并且可以更灵活地拼接通配符。
三、动态 SQL 实现模糊查询
在实际开发中，可能需要根据不同的条件进行模糊查询，这时可以使用 MyBatis 的动态 SQL 来实现。以下是一个示例：
```
<select id="findUsersByCondition" resultType="com.example.User">
    SELECT * FROM users
    <where>
        <if test="name != null and name != ''">
            AND name LIKE CONCAT('%', #{name}, '%')
        </if>
        <if test="email != null and email != ''">
            AND email LIKE CONCAT('%', #{email}, '%')
        </if>
    </where>
</select>
```
在 Java 代码中：
```
SqlSession session = sqlSessionFactory.openSession();
UserMapper userMapper = session.getMapper(UserMapper.class);
UserExample example = new UserExample();
example.setName("张");
example.setEmail("example.com");
List<User> users = userMapper.findUsersByCondition(example);
session.close();
```
在这个示例中，使用了 <where> 标签和 <if> 标签来动态生成 SQL 语句。如果 name 不为空，则添加 name 的模糊查询条件；如果 email 不为空，则添加 email 的模糊查询条件。
四、模糊查询的性能优化
1. 合理使用索引
模糊查询会影响数据库的性能，特别是在数据量较大的情况下。为了提高性能，可以在模糊查询的字段上创建索引。例如，如果经常对 name 字段进行模糊查询，可以在 name 字段上创建索引：
```
CREATE INDEX idx_name ON users (name);
```
需要注意的是，当使用“%”开头的模糊查询时，索引可能会失效，因为数据库无法快速定位到符合条件的数据。因此，尽量避免使用“%”开头的模糊查询。
2. 分页查询
如果模糊查询的结果集较大，可以使用分页查询来减少每次查询的数据量。MyBatis 可以结合分页插件来实现分页查询，例如 PageHelper。以下是一个使用 PageHelper 的示例：
```
// 开启分页
PageHelper.startPage(1, 10);
SqlSession session = sqlSessionFactory.openSession();
UserMapper userMapper = session.getMapper(UserMapper.class);
List<User> users = userMapper.findUsersByName("张");
// 获取分页信息
PageInfo<User> pageInfo = new PageInfo<>(users);
session.close();
```
在这个示例中，使用 PageHelper.startPage(1, 10) 开启分页，每页显示 10 条数据。然后通过 PageInfo 对象获取分页信息。
五、总结
MyBatis 中实现模糊查询有多种方式，包括在 SQL 语句中直接拼接通配符、在 Java 代码中拼接通配符、使用 CONCAT 函数以及动态 SQL 等。在实际开发中，应根据具体情况选择合适的方式，并注意避免 SQL 注入的风险。同时，为了提高模糊查询的性能，可以合理使用索引和分页查询。通过本文的介绍，相信你已经掌握了 MyBatis 中模糊查询的操作方法。