diff --git a/docs/book/17-Files.md b/docs/book/17-Files.md index 4ed54b6..ae32b90 100644 --- a/docs/book/17-Files.md +++ b/docs/book/17-Files.md @@ -644,15 +644,210 @@ evt.kind(): ENTRY_DELETE ## 文件查找 +到目前为止，为了找到文件，我们一直使用相当粗糙的方法，在 `path` 上调用 `toString()`，然后使用 `string` 操作查看结果。事实证明，`java.nio.file` 有更好的解决方案：通过在 `FileSystem` 对象上调用 `getPathMatcher()` 获得一个 `PathMatcher`，然后传入您感兴趣的模式。模式有两个选项：`glob` 和 `regex`。`glob` 比较简单，实际上功能非常强大，因此您可以使用 `glob` 解决许多问题。如果您的问题更复杂，可以使用 `regex`，这将在接下来的 `Strings` 一章中解释。 +在这里，我们使用 `glob` 查找以 `.tmp` 或 `.txt` 结尾的所有 `Path`： + +```java +// files/Find.java +// {ExcludeFromGradle} +import java.nio.file.*; + +public class Find { + public static void + main(String[] args) throws Exception { + Path test = Paths.get("test"); + Directories.refreshTestDir(); + Directories.populateTestDir(); + // Creating a *directory*, not a file: + Files.createDirectory(test.resolve("dir.tmp")); + + PathMatcher matcher = FileSystems.getDefault() + .getPathMatcher("glob:**/*.{tmp,txt}"); + Files.walk(test) + .filter(matcher::matches) + .forEach(System.out::println); + System.out.println("***************"); + + PathMatcher matcher2 = FileSystems.getDefault() + .getPathMatcher("glob:*.tmp"); + Files.walk(test) + .map(Path::getFileName) + .filter(matcher2::matches) + .forEach(System.out::println); + System.out.println("***************"); + + Files.walk(test) // Only look for files + .filter(Files::isRegularFile) + .map(Path::getFileName) + .filter(matcher2::matches) + .forEach(System.out::println); + } +} +/* Output: +test\bag\foo\bar\baz\5208762845883213974.tmp +test\bag\foo\bar\baz\File.txt +test\bar\baz\bag\foo\7918367201207778677.tmp +test\bar\baz\bag\foo\File.txt +test\baz\bag\foo\bar\8016595521026696632.tmp +test\baz\bag\foo\bar\File.txt +test\dir.tmp +test\foo\bar\baz\bag\5832319279813617280.tmp +test\foo\bar\baz\bag\File.txt +*************** +5208762845883213974.tmp +7918367201207778677.tmp +8016595521026696632.tmp +dir.tmp +5832319279813617280.tmp +*************** +5208762845883213974.tmp +7918367201207778677.tmp +8016595521026696632.tmp +5832319279813617280.tmp +*/ +``` + +在 `matcher` 中，`glob` 表达式开头的 `**/` 表示“当前目录及所有子目录”，这在当你不仅仅要匹配当前目录下特定结尾的 `Path` 时非常有用。单 `*` 表示“任何东西”，然后是一个点，然后大括号表示一系列的可能性---我们正在寻找以`.tmp` 或 `.txt` 结尾的东西。您可以在 `getPathMatcher()` 文档中找到更多详细信息。 + +`matcher2` 只使用 `*.tmp`，通常不匹配任何内容，但是添加 `map()` 操作会将完整路径减少到末尾的名称。 + +注意，在这两种情况下，输出中都会出现 `dir.tmp`，即使它是一个目录而不是一个文件。要只查找文件，必须像在最后 `files.walk()` 中那样对其进行筛选。 ## 文件读写 +此时，我们可以对路径和目录做任何事情。 现在让我们看一下操纵文件本身的内容。 +如果一个文件很“小”，也就是说“它运行得足够快且占用内存小”，那么 `java.nio.file.Files` 类中的实用程序将帮助你轻松读写文本和二进制文件。 + +`Files.readAllLines()` 一次读取整个文件（因此，“小”文件很有必要），产生一个`List`。 对于示例文件，我们将重用`streams/Cheese.dat`： + +```java +// files/ListOfLines.java +import java.util.*; +import java.nio.file.*; + +public class ListOfLines { + public static void + main(String[] args) throws Exception { + Files.readAllLines( + Paths.get("../streams/Cheese.dat")) + .stream() + .filter(line -> !line.startsWith("//")) + .map(line -> + line.substring(0, line.length()/2)) + .forEach(System.out::println); + } +} +/* Output: +Not much of a cheese +Finest in the +And what leads you +Well, it's +It's certainly uncon +*/ +``` + +跳过注释行，其余的内容每行只打印一半。 这实现起来很简单：你只需将 `Path` 传递给 `readAllLines()` （以前的 java 实现这个功能很复杂）。 有一个 `readAllLines()` 的重载版本，它包含一个 `Charset` 参数来存储文件的Unicode编码。 + +`Files.write()` 被重载以写入 `byte` 数组或任何 `Iterable` 对象（它也有 `Charset` 选项）： + +```java +// files/Writing.java +import java.util.*; +import java.nio.file.*; + +public class Writing { + static Random rand = new Random(47); + static final int SIZE = 1000; + public static void + main(String[] args) throws Exception { + // Write bytes to a file: + byte[] bytes = new byte[SIZE]; + rand.nextBytes(bytes); + Files.write(Paths.get("bytes.dat"), bytes); + System.out.println("bytes.dat: " + + Files.size(Paths.get("bytes.dat"))); + + // Write an iterable to a file: + List lines = Files.readAllLines( + Paths.get("../streams/Cheese.dat")); + Files.write(Paths.get("Cheese.txt"), lines); + System.out.println("Cheese.txt: " + + Files.size(Paths.get("Cheese.txt"))); + } +} +/* Output: +bytes.dat: 1000 +Cheese.txt: 199 +*/ +``` + +我们使用 `Random` 来创建一个随机的 `byte` 数组; 你可以看到生成的文件大小是1000。 + +一个 `List` 被写入文件，任何 `Iterable` 对象也可以这么做。 + +如果文件大小有问题怎么办？ 比如说： + +1.文件太大，如果你一次读完整个文件，你可能会耗尽内存。 + +2.您只需要在文件的中途工作以获得所需的结果，因此读取整个文件会浪费时间。 + +`Files.lines()` 方便地将文件转换为行的 `Stream`： + +```java +// files/ReadLineStream.java +import java.nio.file.*; + +public class ReadLineStream { + public static void + main(String[] args) throws Exception { + Files.lines(Paths.get("PathInfo.java")) + .skip(13) + .findFirst() + .ifPresent(System.out::println); + } +} +/* Output: + show("RegularFile", Files.isRegularFile(p)); +*/ +``` + +这本章中的第一个流式传输的示例，跳过13行，然后选择下一行并将其打印出来。 + +`Files.lines()` 对于处理行作为 *incoming* `Stream` 非常有用，但是如果你想在 `Stream` 中读，操作或写怎么办？这就需要稍微复杂的代码： + +```java +// files/StreamInAndOut.java +import java.io.*; +import java.nio.file.*; +import java.util.stream.*; + +public class StreamInAndOut { + public static void main(String[] args) { + try( + Stream input = + Files.lines(Paths.get("StreamInAndOut.java")); + PrintWriter output = + new PrintWriter("StreamInAndOut.txt") + ) { + input + .map(String::toUpperCase) + .forEachOrdered(output::println); + } catch(Exception e) { + throw new RuntimeException(e); + } + } +} +``` + +因为我们在同一个块中执行所有操作，所以这两个文件都可以在相同的try-with-resources语句中打开。`PrintWriter` 是一个旧式的`java.io` 类，允许你“打印”到一个文件，所以它是这个应用程序的理想选择。如果你看一下 `StreamInAndOut.txt`，你会发现它确实是大写的。 ## 本章小结 +虽然这是对文件和目录操作的相当全面的介绍，但是库中仍然有没被介绍的功能 - 一定要研究 `java.nio.file` 的Javadocs，尤其是`java.nio.file.Files` 的。 +Java 7和8对于处理文件和目录的库中做了大量改进。如果您刚刚开始使用Java，那么您很幸运。在过去，它非常令人不愉快，我确信Java 设计者以前对于文件操作不够重视才没做简化。对于初学者来说这是一件很棒的事，对于教学者来说也一样。我不明白为什么花了这么长时间来解决这个明显的问题，但不过它被解决了，我很高兴。使用文件现在很简单，甚至很有趣，这是以前你永远想不到的。