DirectoryStream

Files.newDirectoryStream(Path dir)方法用于打开一个目录流，以便遍历指定目录dir下的所有文件和子目录。这个方法返回一个DirectoryStream ` 对象，可以用来逐个访问目录中的每一个条目（文件或子目录）。使用这个方法可以方便地读取目录内容，而不需要一次性将所有文件加载到内存中，有助于处理大量文件时的性能优化。

DirectoryStream 对象是 Java NIO 中用于读取目录内容的工具。它提供了一种高效的方法来遍历目录中的文件和子目录，而不需要一次性将所有内容加载到内存中。

主要特点：

1. 惰性读取：DirectoryStream 以惰性方式读取目录内容，即在遍历目录时逐个读取条目，而不是一次性加载所有条目。这对于处理包含大量文件的目录特别有用，因为它可以显著减少内存使用。
2. 自动关闭：DirectoryStream 实现了 AutoCloseable 接口，这意味着可以使用 try-with-resources 语句来确保目录流在使用完毕后自动关闭，避免资源泄漏。
3. 类型安全：DirectoryStream 是泛型的，通常与 Path 一起使用，即 DirectoryStream<Path>，以确保类型安全的目录遍历。

示例代码：

try (DirectoryStream<Path> stream = Files.newDirectoryStream(Paths.get(dirPath))) {
    for (Path entry : stream) {
        // 处理每个目录条目
    }
} catch (IOException e) {
    // 处理异常
}

使用步骤：

1. 创建 DirectoryStream 对象：通过 Files.newDirectoryStream(Path dir) 方法创建一个 DirectoryStream 对象，指定要读取的目录路径 dir。
2. 遍历目录内容：使用增强的 for 循环遍历 DirectoryStream 对象，以便逐个处理目录中的每个条目。
3. 处理条目：在循环体内，对每个 Path 对象（表示目录中的一个条目）进行处理。例如，可以检查文件名、读取文件属性等。
4. 自动关闭：使用 try-with-resources 语句确保 DirectoryStream 在使用完毕后自动关闭，释放资源。

总之，DirectoryStream 对象提供了一种高效、类型安全且易于使用的方法来遍历目录内容，特别适合处理包含大量文件的目录。