NIO之Files介绍

[TOC]

一、概述

Files是Java1.7 在nio中新增的专门用于处理文件和目录的工具类。Files和Path配合可以很方便的完成对文件/目录的创建、读取、修改、删除等操作。

二、常用方法介绍

2.1 Files.exits()

boolean exists(Path path, LinkOption... options)

描述 ：方法检查一个路径是否存在于当前的文件系统中。

参数 ：

• Path ：传入的文件路径。 必须
• LinkOption：exits()方法的选项数组。如LinkOption.NOFOLLOW_LINKS代表不允许跟随文件系统中的符号链接来确定路径是否存在。 非必须

    Path path = Paths.get("D:\\path_test\\demo");
    
    boolean exists = Files.exists(path);
    System.out.println(exists);

2.2 Files.createDirectory()

createDirectory(Path dir, FileAttribute<?>... attrs)

描述 ：此方法使用给定的路径创建目录，如果创建目录成功，它将返回创建的目录的路径。

参数 ：

• Path ：需要创建的文件路径。 必须
• FileAttribute：是在创建不存在的目录时自动设置的可选参数，它返回创建的目录的路径。 非必须

注意

• 如果目录已经存在，那么它会抛出 nio.file.FileAlreadyExistsException。
• 不能一次创建多级目录，否则会抛异常 NoSuchFileException

    Path path = Paths.get("D:\\path_test\\demo2");
    Files.createDirectories(path);

2.3 Files.createDirectories()

createDirectories(Path dir, FileAttribute<?>... attrs)

描述 ：此方法通过首先创建所有不存在的父目录来使用给定路径创建目录。如果由于目录已存在而无法创建该目录，则此方法不会引发异常。

该方法用来创建多级目录。

    Path path = Paths.get("D:\\path_test\\demo3\\a\\b");
    Files.createDirectories(path);

2.4 Files.copy()

long copy(InputStream in, Path target, CopyOption... options)

描述 ：此方法将指定输入流中的所有字节复制到指定目标文件，并返回读取或写入的字节数作为长值。

• 将InputStream中的数据复制到目标文件

    InputStream inputStream = new FileInputStream("D:\\path_test\\demo\\first_input.txt");
    Path targetPath = Paths.get("D:\\path_test\\demo3\\first_copy2.txt");
    
    long size = Files.copy(inputStream, targetPath, StandardCopyOption.REPLACE_EXISTING);
    System.out.println(size);

注意

• 默认情况，如果目标文件已经存在或是一个符号链接，则复制失败；
• 指定了REPLACE_EXISTING的情况，如果目标文件已经存在，那么只要它不是一个非空目录（例如它是一个空目录，或者是一个符号链接），它就会被替换。截止到JDK1.8，options只支持REPLACE_EXISTING。

long copy(Path source, OutputStream out)

描述 ：此方法将指定源文件中的所有字节复制到给定的输出流，并返回读取或写入的字节数作为长值。

• 将本地文件中的内容复制到OutputStream

    Path path = Paths.get("D:\\path_test\\demo\\first_copy.txt");
    OutputStream outputStream = new FileOutputStream("D:\\path_test\\demo\\first_output.txt");
    
    long size = Files.copy(path, outputStream);
    System.out.println(size);

注意

• 当发生异常的时候，由于输出了可能已经获取到了一部分内容，所以输出流此时的内容可能很奇怪，应该直接关闭。
• 如果输出流是Flushable的实现类的实例，在执行完方法以后应该调用flush方法以刷新缓存。

Path copy(Path source, Path target, CopyOption... options)

描述 ：此方法将给定的源文件复制到指定的目标文件，并返回目标文件的路径。

• 将文件first_copy.txt复制到文件first_copy2.txt

    Path path = Paths.get("D:\\path_test\\demo3\\first_copy.txt");
    Path targetPath = Paths.get("D:\\path_test\\demo3\\first_copy2.txt");
    
    Path copy = Files.copy(path, targetPath);
    System.out.println(copy);

注意

• 在默认情况下，如果目标文件已经存在，或者是一个符号链接，那么复制失败；

options参数

2.5 Files.move()

move(Path source, Path target, CopyOption... options)

描述 ：此方法将源文件移动或重命名为目标文件，并返回目标文件的路径。

    Path sourcePath = Paths.get("D:\\path_test\\demo\\first_copy.txt");
    Path targetPath = Paths.get("D:\\path_test\\demo3\\first_copy2.txt");
    
    Path move = Files.move(sourcePath, targetPath, StandardCopyOption.REPLACE_EXISTING);
    System.out.println(move);

options参数

注意

• 如果目标文件存在但由于未指定 REPLACE_EXISTING 选项而无法替换，则此方法将引发 FileAleadyExistsException 。
• 如果指定了 REPlACE_EXISTING 选项，则此方法将引发 DirectoryNotEmptyException 但无法替换该文件，因为它是一个非空目录。

2.6 Files.delete()

void delete(Path path)

描述 ：删除一个文件或文件夹。

    Path path = Paths.get("D:\\path_test\\demo");
    
    //如果path指定到一个目录，并且目标不为空时会抛出异常
    Files.delete(path);

如果目标存在，并且是文件或者空的文件夹，就删除文件；如果目标不存在，或者目标是非空的文件夹，就会抛出异常。

2.7 Files.walkFileTree()

描述 ：Files.walkFileTree()方法可以递归遍历目录树。它使用一个Path和一个FileVisitor作为参数。

首先先展示一下FileVisitor接口

    public interface FileVisitor {
    
        public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs) throws IOException;
    
        public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException;
    
        public FileVisitResult visitFileFailed(Path file, IOException exc) throws IOException;
    
        public FileVisitResult postVisitDirectory(Path dir, IOException exc) throws IOException;
    }

Files.walkFileTree()方法需要一个FileVisitor的实现类作为参数，实现FileVisitor接口就需要实现上述方法。

如果不想做特殊实现或者只想实现一部分，可以继承SimpleFileVisitor类，它其中有对FileVisitor的方法的默认实现。

示例

    Files.walkFileTree(path, new FileVisitor<Path>() {
      @Override
      public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs) throws IOException {
        System.out.println("pre visit dir:" + dir);
        return FileVisitResult.CONTINUE;
      }
    
      @Override
      public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {
        System.out.println("visit file: " + file);
        return FileVisitResult.CONTINUE;
      }
    
      @Override
      public FileVisitResult visitFileFailed(Path file, IOException exc) throws IOException {
        System.out.println("visit file failed: " + file);
        return FileVisitResult.CONTINUE;
      }
    
      @Override
      public FileVisitResult postVisitDirectory(Path dir, IOException exc) throws IOException {
        System.out.println("post visit directory: " + dir);
        return FileVisitResult.CONTINUE;
      }
    });

这些方法在遍历的不同时间被调用

• preVisitDirectory()方法在访问任何目录前被调用。
• postVisitDirectory()方法在访问任何目录后被调用。
• visitFile()方法在访问任何文件时被调用。
• visitFileFailed()在访问任何文件失败时被调用。（比如没权限）

每个方法返回一个FileVisitResult枚举，这些返回指决定了遍历如何进行。

包括

Java 面试宝典是大明哥全力打造的 Java 精品面试题，它是一份靠谱、强大、详细、经典的 Java 后端面试宝典。它不仅仅只是一道道面试题，而是一套完整的 Java 知识体系，一套你 Java 知识点的扫盲贴。

它的内容包括：

• 大厂真题：Java 面试宝典里面的题目都是最近几年的高频的大厂面试真题。
• 原创内容：Java 面试宝典内容全部都是大明哥原创，内容全面且通俗易懂，回答部分可以直接作为面试回答内容。
• 持续更新：一次购买，永久有效。大明哥会持续更新 3+ 年，累计更新 1000+，宝典会不断迭代更新，保证最新、最全面。
• 覆盖全面：本宝典累计更新 1000+，从 Java 入门到 Java 架构的高频面试题，实现 360° 全覆盖。
• 不止面试：内容包含面试题解析、内容详解、知识扩展，它不仅仅只是一份面试题，更是一套完整的 Java 知识体系。
• 宝典详情：https://www.yuque.com/chenssy/sike-java/xvlo920axlp7sf4k
• 宝典总览：https://www.yuque.com/chenssy/sike-java/yogsehzntzgp4ly1
• 宝典进展：https://www.yuque.com/chenssy/sike-java/en9ned7loo47z5aw

目前 Java 面试宝典累计更新 400+ 道，总字数 42w+。大明哥还在持续更新中，下图是大明哥在 2024-12 月份的更新情况：

想了解详情的小伙伴，扫描下面二维码加大明哥微信【daming091】咨询

同时，大明哥也整理一套目前市面最常见的热点面试题。微信搜[大明哥聊 Java]或扫描下方二维码关注大明哥的原创公众号[大明哥聊 Java] ，回复【面试题】 即可免费领取。