Apache下的FileUtils.listFiles方法简单使用技巧 - LiuChunfu - 博客园

一、引言

Apache提供的很多工具方法非常好用，推荐。

今天在使用的过程中使用到了org.apache.commons.io.FileUtils.listFiles方法，本文主要谈谈这个工具方法的用法。

查看源码上的说明是

复制代码; "复制代码")

/** \* Finds files within a given directory (and optionally its
 \* subdirectories). All files found are filtered by an IOFileFilter.
 \* <p>
 \* If your search should recurse into subdirectories you can pass in
 \* an IOFileFilter for directories. You don't need to bind a
 \* DirectoryFileFilter (via logical AND) to this filter. This method does
 \* that for you.
 \* <p>
 \* An example: If you want to search through all directories called
 \* "temp" you pass in <code>FileFilterUtils.NameFileFilter("temp")</code>
 \* <p>
 \* Another common usage of this method is find files in a directory
 \* tree but ignoring the directories generated CVS. You can simply pass
 \* in <code>FileFilterUtils.makeCVSAware(null)</code>.
 \*
 \* @param directory  the directory to search in
 \* @param fileFilter filter to apply when finding files.
 \* @param dirFilter  optional filter to apply when finding subdirectories.
 \*                   If this parameter is {@code null}, subdirectories will not be included in the
 \*                   search. Use TrueFileFilter.INSTANCE to match all directories.
 \* @return an collection of java.io.File with the matching files
 \* @see org.apache.commons.io.filefilter.FileFilterUtils
 \* @see org.apache.commons.io.filefilter.NameFileFilter */

复制代码; "复制代码")

大意就是：

在指定的目录中（可以指定到子目录）通过IOFileFilter过滤器查找文件。
比如:
如果你要在所有的名为"temp"的目录，你可以使用：FileFilterUtils.NameFileFilter("temp")

 二、基本使用

测试目录下的目录结构如下所示：　

复制代码; "复制代码")

M:\FileTest
│ 5.txt
├─001
│ │ 1.txt
│ │ 2.txt
│ │
│ └─011
│ bc.eddx
│ d.docx
│
└─002

   3.txt
   4.txt

复制代码; "复制代码")

最开始仅仅想获取目录下的文件，如下方法：

    Collection<File> listFiles = FileUtils.listFiles(new File("M:/FileTest"), null, null); for (File file : listFiles) {
        System.out.println(file.getName());
    }

此处会抛出错误：

其源码如下：Parameter 'fileFilter' is null"

复制代码; "复制代码")

private static void validateListFilesParameters(final File directory, final IOFileFilter fileFilter) { if (!directory.isDirectory()) { throw new IllegalArgumentException("Parameter 'directory' is not a directory: " + directory);
    } if (fileFilter == null) { throw new NullPointerException("Parameter 'fileFilter' is null");
    }
}

复制代码; "复制代码")

可以看出，第二个针对文件的过滤器不可以为空。

换成第二种做法：利用FileFilterUtils进行文件过滤器的创建。下面代码中使用到了 FileFilterUtils.suffixFileFilter("txt") 表示过滤出文件名后缀为txt的文件，第三个参数表示通常表示是否递归查询目录，null表示递归。

复制代码; "复制代码")

@Test public void test2(){

    Collection<File> listFiles = FileUtils.listFiles(new File("M:/FileTest"), FileFilterUtils.suffixFileFilter("txt"), null);
    showFiles(listFiles);
} private void showFiles(Collection<File> listFiles) { if (listFiles==null) { return;
    } for (File file : listFiles) {
        System.out.println(file.getName());
    }
}

复制代码; "复制代码")

上述方法结果是：

5.txt

稍微修改下最后一个参数，将其由null转变为DirectoryFileFilter.INSTANCE，方法将使用递归的形式来进行文件过滤扫描。

复制代码; "复制代码")

@Test public void test3(){

    Collection<File> listFiles = FileUtils.listFiles(new File("M:/FileTest"), FileFilterUtils.suffixFileFilter("txt"), DirectoryFileFilter.INSTANCE);
    showFiles(listFiles);
}

复制代码; "复制代码")

结果为：

1.txt 2.txt 3.txt 4.txt 5.txt

这里需要注意，如果仅仅是过滤后缀，Apache提供了更加简单的方法：

@Test public void test4(){

    Collection<File> listFiles = FileUtils.listFiles(new File("M:/FileTest"), new String\[\]{"txt"}, true);
    showFiles(listFiles);
}

方法说明参见上图，此处时间关系不在赘述。

三、常见文件过滤器

 从其中最灵活的方法签名中可以得到一些信息：

第二个参数是IOFilFilter fileFilter,通过查看源码的形式可以知道其为一个接口

很显然我们查看这个接口有哪些实现类就可以获得由那些FileFilter。

从上述图的记过可以看出有基于文件大小的SizeFileFilter,基于文件名称前缀的PrefixFileFilter...,具体使用情况，依照自己项目情况选择，我这里就不一一举例了（0.0 其实我也没有全部用过~~~）

复制代码; "复制代码")

@Test public void test5(){

    Collection<File> listFiles = FileUtils.listFiles(new File("M:/FileTest"), FileFilterUtils.and(EmptyFileFilter.NOT_EMPTY,new RegexFileFilter("^\[0-9\]+.\[a-zA-z\]+$")), DirectoryFileFilter.INSTANCE);
    showFiles(listFiles);
}

复制代码; "复制代码")

因为我的目录中只有5.txt有点内容，所以最终的结果是5.txt，上面代码中注意

FileFilterUtils.and(EmptyFileFilter.NOT_EMPTY,new RegexFileFilter("^[0-9]+.[a-zA-z]+$"))

其中表示有2个文件过滤器，其中一个是不为空的文件过滤器，另外一个是查找文件名称的过滤器，其匹配规则是："^[0-9]+.[a-zA-z]+$" 即文件名称只能是一个或者多个数字构成，后缀由一个或多个字母构成。

~~Over

本次博文算是我最用心的一次了。。。。

Original url: Access
Created at: 2019-03-15 15:59:01
Category: default
Tags: none

未标明原创文章均为采集，版权归作者所有，转载无需和我联系，请注明原出处，南摩阿彌陀佛，知识，不只知道，要得到

请先后发表评论
  • 最新评论
  • 总共0条评论