Java 模糊查询程序：原理、实现与应用

原创已于 2025-05-20 16:17:57 修改 · 1.3k 阅读

13 ·

CC 4.0 BY-SA版权

文章标签：

#java #数据库 #sql

于 2025-05-20 16:04:55 首次发布

引言

在软件开发中，数据查询是一项极为常见的操作。当我们需要在大量数据中找到符合特定条件，但又不完全精确匹配的数据时，模糊查询就派上用场了。在 Java 开发领域，无论是 Web 应用、桌面应用还是后端服务，模糊查询都有着广泛的应用场景，比如在数据库中查询用户信息、商品信息等。今天，我们就来深入探讨一下如何用 Java 实现模糊查询，并通过实际代码示例来展示其具体应用。

一.模糊查询原理

模糊查询的核心思想是通过通配符来匹配部分字符串内容。在 Java 中，当涉及到数据库操作时，最常用的是 SQL 语言，SQL 中的LIKE关键字就是实现模糊查询的关键。例如，%是一个通配符，可以匹配任意长度的字符串（包括空字符串），_也为通配符，不过它只能匹配单个字符。

比如，我们要在一个存储用户姓名的表中查询所有姓 “张” 的用户，就可以使用SELECT * FROM users WHERE username LIKE '张%'这样的 SQL 语句。这里的'张%'表示以 “张” 开头的任意字符串。

二.基于 JDBC 的模糊查询实现

2.1准备工作

在开始编写代码之前，我们需要准备好数据库环境。这里以 MySQL 数据库为例，假设我们有一个名为test的数据库，里面有一个students表，表结构如下：

id	name	age
1	张三	20
2	张三丰	25
3	李四	22

2.2代码实现

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;

public class FuzzyQueryExample {
    public static void main(String[] args) {
        String url = "jdbc:mysql://localhost:3306/test?useSSL=false&serverTimezone=UTC";
        String username = "root";
        String password = "your_password";
        String searchKeyword = "张";
        try (Connection connection = DriverManager.getConnection(url, username, password)) {
            String sql = "SELECT * FROM students WHERE name LIKE?";
            try (PreparedStatement preparedStatement = connection.prepareStatement(sql)) {
                preparedStatement.setString(1, searchKeyword + "%");
                try (ResultSet resultSet = preparedStatement.executeQuery()) {
                    while (resultSet.next()) {
                        int id = resultSet.getInt("id");
                        String name = resultSet.getString("name");
                        int age = resultSet.getInt("age");
                        System.out.println("id: " + id + ", name: " + name + ", age: " + age);
                    }
                }
            }
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }
}

2.3代码解析

数据库连接：首先通过DriverManager.getConnection方法建立与 MySQL 数据库的连接，传入数据库的 URL、用户名和密码。
SQL 语句编写：定义了一个SELECT语句，使用LIKE关键字进行模糊查询。这里使用了占位符?，这样做的好处是可以有效防止 SQL 注入攻击。
设置参数：通过preparedStatement.setString方法，将搜索关键词与%通配符拼接后设置到占位符中。
执行查询与结果处理：执行查询语句后，通过ResultSet遍历结果集，获取每一条符合条件的数据记录，并打印出来。

三.基于 MyBatis 的模糊查询实现

MyBatis 是一款优秀的持久层框架，它简化了 JDBC 的操作。下面我们来看看如何使用 MyBatis 实现模糊查询。

3.1引入依赖

在pom.xml文件中添加 MyBatis 和 MySQL 驱动的依赖：

<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.9</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.31</version>
    </dependency>
</dependencies>

3.2配置 MyBatis

创建mybatis-config.xml配置文件：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/test?useSSL=false&serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="your_password"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/StudentMapper.xml"/>
    </mappers>
</configuration>

3.4定义实体类和 Mapper 接口

创建Student实体类：

public class Student {
    private int id;
    private String name;
    private int age;

    // 省略getter和setter方法
}

定义StudentMapper接口：

import java.util.List;

public interface StudentMapper {
    List<Student> fuzzyQueryStudents(String keyword);
}

3.5编写 Mapper 映射文件

在StudentMapper.xml中编写 SQL 语句：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.mapper.StudentMapper">
    <select id="fuzzyQueryStudents" resultType="com.example.Student">
        SELECT * FROM students WHERE name LIKE #{keyword}
    </select>
</mapper>

3.6测试代码

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import java.io.IOException;
import java.io.InputStream;
import java.util.List;

public class MyBatisFuzzyQueryTest {
    public static void main(String[] args) {
        String resource = "mybatis-config.xml";
        try (InputStream inputStream = Resources.getResourceAsStream(resource)) {
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
            try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
                StudentMapper studentMapper = sqlSession.getMapper(StudentMapper.class);
                String keyword = "张%";
                List<Student> students = studentMapper.fuzzyQueryStudents(keyword);
                for (Student student : students) {
                    System.out.println("id: " + student.getId() + ", name: " + student.getName() + ", age: " + student.getAge());
                }
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

3.7代码解析

依赖引入与配置：通过pom.xml引入 MyBatis 和 MySQL 驱动依赖，在mybatis-config.xml中配置数据库连接信息和 Mapper 映射文件路径。
定义实体类和 Mapper 接口：Student实体类用于封装数据库查询结果，StudentMapper接口定义了模糊查询方法。
Mapper 映射文件编写：在StudentMapper.xml中编写 SQL 语句，使用#{keyword}占位符来接收传入的参数。
测试代码：通过 MyBatis 的SqlSessionFactory和SqlSession获取 Mapper 接口实例，调用模糊查询方法并处理结果。

四.模糊查询在实际项目中的应用场景

4.1电商系统

在电商系统中，用户搜索商品时，往往不知道商品的准确名称，此时模糊查询就非常有用。比如用户输入 “运动鞋”，系统可以通过模糊查询在商品表中找到所有包含 “运动鞋” 关键词的商品信息，如 “耐克运动鞋”“阿迪达斯运动鞋” 等，从而提高用户的购物体验。

4.2企业信息管理系统

在企业的员工信息管理系统中，当管理员需要查找某个员工时，如果只记得员工姓名的部分内容，也可以通过模糊查询来快速定位。例如，输入 “王”，就能查询到所有姓王的员工信息。

五.总结

通过本文，我们详细介绍了 Java 中模糊查询的原理，分别通过 JDBC 和 MyBatis 两种方式实现了模糊查询，并探讨了其在实际项目中的应用场景。模糊查询作为一种强大的数据检索手段，在 Java 开发中有着不可或缺的地位。无论是简单的小型项目，还是复杂的大型企业级应用，合理运用模糊查询都能提高系统的易用性和用户体验。希望本文能帮助大家更好地理解和使用 Java 进行模糊查询开发。