基于Java IO API实现文件查找工具

 更新时间:2026年06月15日 09:21:29   作者:Cache技术分享  
这篇文章主要为大家详细介绍了如何基于Java IO API实现文件查找Find工具,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下

Java IO API - Java 文件查找工具

这是一个用 Java 编写的简单文件查找工具,它模仿了 Linux 中的 find 命令,允许你通过 glob 模式查找符合特定命名规则的文件或目录。

/**
 * Sample code that finds files that match the specified glob pattern.
 * For more information on what constitutes a glob pattern, see
 * https://docs.oracle.com/javase/tutorial/essential/io/fileOps.html#glob
 *
 * The file or directories that match the pattern are printed to
 * standard out.  The number of matches is also printed.
 *
 * When executing this application, you must put the glob pattern
 * in quotes, so the shell will not expand any wild cards:
 *              java Find . -name "*.java"
 */

import java.io.*;
import java.nio.file.*;
import java.nio.file.attribute.*;
import static java.nio.file.FileVisitResult.*;
import static java.nio.file.FileVisitOption.*;
import java.util.*;


public class Find {

    public static class Finder
        extends SimpleFileVisitor<Path> {

        private final PathMatcher matcher;
        private int numMatches = 0;

        Finder(String pattern) {
            matcher = FileSystems.getDefault()
                    .getPathMatcher("glob:" + pattern);
        }

        // Compares the glob pattern against
        // the file or directory name.
        void find(Path file) {
            Path name = file.getFileName();
            if (name != null && matcher.matches(name)) {
                numMatches++;
                System.out.println(file);
            }
        }

        // Prints the total number of
        // matches to standard out.
        void done() {
            System.out.println("Matched: "
                + numMatches);
        }

        // Invoke the pattern matching
        // method on each file.
        @Override
        public FileVisitResult visitFile(Path file,
                BasicFileAttributes attrs) {
            find(file);
            return CONTINUE;
        }

        // Invoke the pattern matching
        // method on each directory.
        @Override
        public FileVisitResult preVisitDirectory(Path dir,
                BasicFileAttributes attrs) {
            find(dir);
            return CONTINUE;
        }

        @Override
        public FileVisitResult visitFileFailed(Path file,
                IOException exc) {
            System.err.println(exc);
            return CONTINUE;
        }
    }

    static void usage() {
        System.err.println("java Find <path>" +
            " -name \"<glob_pattern>\"");
        System.exit(-1);
    }

    public static void main(String[] args)
        throws IOException {

        if (args.length < 3 || !args[1].equals("-name"))
            usage();

        Path startingDir = Paths.get(args[0]);
        String pattern = args[2];

        Finder finder = new Finder(pattern);
        Files.walkFileTree(startingDir, finder);
        finder.done();
    }
}

功能简介

这个程序会:

  • 遍历指定目录及其子目录;
  • 使用 glob 模式匹配文件或目录名;
  • 输出所有匹配项的路径;
  • 输出匹配总数。

例如:

$ java Find . -name "*.java"

会打印当前目录及其子目录中所有以 .java 结尾的文件。

示例代码结构详解

main()方法:入口程序

public static void main(String[] args) throws IOException {
    if (args.length < 3 || !args[1].equals("-name"))
        usage();

    Path startingDir = Paths.get(args[0]);
    String pattern = args[2];

    Finder finder = new Finder(pattern);
    Files.walkFileTree(startingDir, finder);
    finder.done();
}
  • 接收命令行参数:路径 + -name + glob 模式。
  • 使用 Files.walkFileTree() 遍历文件树。
  • 调用 Finder 匹配并输出结果。

Finder类:自定义文件访问器

public static class Finder extends SimpleFileVisitor<Path> {

继承 SimpleFileVisitor<Path>,重写几个核心方法来自定义行为:

构造方法:初始化 glob 匹配器

matcher = FileSystems.getDefault().getPathMatcher("glob:" + pattern);

示例:"*.java" ➜ 匹配所有 Java 源文件。

find() 方法:核心匹配逻辑

void find(Path file) {
    Path name = file.getFileName();
    if (name != null && matcher.matches(name)) {
        numMatches++;
        System.out.println(file);
    }
}
  • 使用 matcher.matches(...) 判断文件是否匹配;
  • 统计匹配个数;
  • 输出匹配路径。

preVisitDirectory():遍历目录前的匹配逻辑

public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs) {
    find(dir); // 匹配目录名
    return CONTINUE;
}

不仅可以匹配文件,也能匹配目录名称。

visitFile():遍历文件时的匹配逻辑

public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) {
    find(file);
    return CONTINUE;
}

对每一个文件调用 find() 方法。

visitFileFailed():错误处理

public FileVisitResult visitFileFailed(Path file, IOException exc) {
    System.err.println(exc);
    return CONTINUE;
}

如果文件访问失败(如权限问题),打印错误但不终止遍历。

done():打印统计结果

void done() {
    System.out.println("Matched: " + numMatches);
}

在遍历完成后显示总共找到多少个匹配项。

运行示例

$ java Find . -name "*.html"

输出:

./index.html
./docs/help.html
Matched: 2

扩展思路与练习建议

扩展功能实现方法
仅查找文件,不查找目录visitFile() 中匹配,preVisitDirectory() 不调用 find()
过滤某些目录(如 .gitpreVisitDirectory() 中判断名称并返回 SKIP_SUBTREE
使用正则表达式匹配替换为 getPathMatcher("regex:" + pattern)
跟踪符号链接使用 EnumSet.of(FileVisitOption.FOLLOW_LINKS) 作为 walkFileTree() 参数
查找结果写入文件System.out.println(...) 替换为写入 BufferedWriter

小贴士:PathMatcher 注意事项

  • 仅文件名匹配:要记得用 file.getFileName() 而不是整个 Path,否则路径中目录部分也会被匹配。
  • 通配符需要加引号:如 "*.java",否则 shell 会提前展开通配符。

错误处理建议

  • 可以改进 visitFileFailed() 的行为,比如记录失败日志或重试。
  • 使用 try-catch 包装 walkFileTree(),处理整体异常。

结语

这个 Find 示例是理解 Java 文件遍历与模式匹配机制的绝佳入门材料。它涵盖了:

  • walkFileTree 的用法;
  • 文件访问器的重写方式;
  • PathMatcher 的实际应用;
  • glob 模式的基础。

在实际项目中,结合该示例可构建自己的文件过滤工具、批量处理脚本或配置管理工具。

到此这篇关于基于Java IO API实现文件查找工具的文章就介绍到这了,更多相关Java文件查找内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Java使用FilenameFilter查找出目录下指定后缀的文件示例

    Java使用FilenameFilter查找出目录下指定后缀的文件示例

    这篇文章主要介绍了Java使用FilenameFilter查找出目录下指定后缀的文件,结合实例形式分析了java基于FilenameFilter类的文件遍历、查找相关操作技巧,需要的朋友可以参考下
    2019-10-10
  • 详解Spring Boot使用系统参数表提升系统的灵活性

    详解Spring Boot使用系统参数表提升系统的灵活性

    Spring Boot项目中常有一些相对稳定的参数设置项,其作用范围是系统级的或模块级的,这些参数称为系统参数。这些变量以参数形式进行配置,从而提高变动和扩展的灵活性,保持代码的稳定性
    2021-06-06
  • Spring Boot详解五种实现跨域的方式

    Spring Boot详解五种实现跨域的方式

    跨域指的是浏览器不能执⾏其他⽹站的脚本。它是由浏览器的同源策略造成的,是浏览器对javascript施加的安全限制,这篇文章主要介绍了springboot实现跨域的5种方式,需要的朋友可以参考下
    2022-06-06
  • SpringBoot(十)之邮件服务

    SpringBoot(十)之邮件服务

    这篇文章给大家介绍了SpringBoot邮件服务的相关知识,此文是使用springboot最新版本1.5.3进行开发的。本文给大家介绍的非常详细,具有参考借鉴价值,需要的的朋友参考下吧
    2017-05-05
  • 一文掌握SpringBoot多环境配置

    一文掌握SpringBoot多环境配置

    在实际项目的开发过程中,我们程序往往需要在不同环境中运行,每个环境中的配置参数可能都会有所不同,例如数据库连接信息、文件服务器等等,下面小编给大家介绍SpringBoot多环境配置,感兴趣的朋友一起看看吧
    2024-04-04
  • SpringBoot实现接口参数加密解密的示例代码

    SpringBoot实现接口参数加密解密的示例代码

    加密解密本身并不是难事,问题是在何时去处理?SpringMVC 中给我们提供了 ResponseBodyAdvice 和 RequestBodyAdvice,利用这两个工具可以对请求和响应进行预处理,非常方便。废话不多说,我们一起来学习一下
    2022-09-09
  • 详解Spring Boot整合Mybatis实现 Druid多数据源配置

    详解Spring Boot整合Mybatis实现 Druid多数据源配置

    本篇文章主要介绍了详解Spring Boot整合Mybatis实现 Druid多数据源配置,具有一定的参考价值,感兴趣的小伙伴们可以参考一下。
    2017-03-03
  • java中的序列化解析

    java中的序列化解析

    这篇文章主要介绍了java中的序列化解析,为了将对象进行网络传输或者是持久化,我们需要将对象的状态信息转换为可以存储或者传输的形式,这个转换的过程就叫序列化,需要的朋友可以参考下
    2023-09-09
  • Java Stream流使用最多的方式示例详解

    Java Stream流使用最多的方式示例详解

    在 Java 编程中,Stream 流提供了一种高效、便捷的方式来处理集合数据,本文将详细介绍 Java 中 Stream 流的用法,包括基础用法、中级用法、高级用法以及一些特殊方法的使用,感兴趣的朋友一起看看吧
    2024-12-12
  • Spring AI对接大模型开发易错点总结与实战解决办法

    Spring AI对接大模型开发易错点总结与实战解决办法

    本文介绍了SpringAI接入大模型时常见的问题及解决方案,主要从地址配置、密钥鉴权、模型匹配、版本依赖四大维度入手,详细分析了各种问题的成因,并提供了实用的配置与代码解决方案,帮助开发者快速避坑,提高开发效率,需要的朋友可以参考下
    2026-05-05

最新评论