Java NIO Files 类

Java NIOFiles类详细学习笔记1. 概述java.nio.file.Files是 Java NIO.2 (Java 7 引入) 中的核心工具类。它提供了一系列静态方法用于操作文件、目录和符号链接。核心特点工具类所有方法都是静态的无需实例化。基于Path操作对象是Path接口而非传统的File类。原子性与异常处理许多操作是原子的且抛出受检异常如IOException强制开发者处理错误。流式处理支持将文件内容作为Stream处理便于函数式编程。替代方案它极大地简化了传统java.io中繁琐的代码如手动创建目录、复制文件流等。注意Files类的方法通常会在底层调用操作系统原生的系统调用因此在处理大文件时性能通常优于传统的FileInputStream/FileOutputStream组合但具体取决于操作类型。2. 核心功能详解2.1 文件基本操作2.1.1 创建文件// 创建新文件如果文件已存在则抛出 FileAlreadyExistsExceptionPathpathPaths.get(example.txt);Files.createFile(path);// 创建新文件如果已存在则覆盖不推荐用于生产环境除非明确意图Files.write(path,Hello.getBytes(),StandardOpenOption.CREATE,StandardOpenOption.TRUNCATE_EXISTING);// 创建目录如果父目录不存在则抛出异常Files.createDirectory(Paths.get(dir/subdir));// 创建目录如果父目录不存在则递归创建类似 mkdirsFiles.createDirectories(Paths.get(dir/subdir));2.1.2 删除文件// 删除文件如果不存在则抛出 NoSuchFileExceptionFiles.delete(path);// 删除文件如果不存在则不抛出异常静默删除Files.deleteIfExists(path);2.1.3 移动与重命名// 移动文件重命名PathsourcePaths.get(old.txt);PathtargetPaths.get(new.txt);// 基本移动Files.move(source,target);// 移动并覆盖目标如果目标存在Files.move(source,target,StandardCopyOption.REPLACE_EXISTING);// 原子移动如果文件系统支持保证移动操作的原子性Files.move(source,target,StandardCopyOption.ATOMIC_MOVE);2.1.4 复制文件PathsourcePaths.get(source.txt);PathtargetPaths.get(dest.txt);// 基本复制Files.copy(source,target);// 复制并覆盖Files.copy(source,target,StandardCopyOption.REPLACE_EXISTING);// 复制时保留属性Files.copy(source,target,StandardCopyOption.COPY_ATTRIBUTES);2.2 文件内容读写Files类提供了极其便捷的读写方法适合中小文件。对于超大文件建议使用InputStream/OutputStream或Stream。2.2.1 读取文件PathpathPaths.get(data.txt);// 读取所有字节byte[]bytesFiles.readAllBytes(path);// 读取所有行返回 ListStringListStringlinesFiles.readAllLines(path,StandardCharsets.UTF_8);// 使用 Stream 逐行读取适合大文件惰性加载try(StreamStringstreamFiles.lines(path,StandardCharsets.UTF_8)){stream.filter(line-line.contains(error)).forEach(System.out::println);}2.2.2 写入文件PathpathPaths.get(output.txt);ListStringlinesArrays.asList(Line 1,Line 2,Line 3);// 写入所有行覆盖模式Files.write(path,lines,StandardCharsets.UTF_8);// 追加模式Files.write(path,Arrays.asList(New Line),StandardCharsets.UTF_8,StandardOpenOption.APPEND);// 写入字节Files.write(path,Hello World.getBytes(StandardCharsets.UTF_8));2.3 文件属性与元数据2.3.1 获取基本属性PathpathPaths.get(example.txt);// 文件大小longsizeFiles.size(path);// 最后修改时间FileTimelastModifiedFiles.getLastModifiedTime(path);// 最后访问时间FileTimelastAccessFiles.getLastAccessTime(path);// 创建时间取决于文件系统支持FileTimecreateTimeFiles.getAttribute(path,creationTime);// 判断是否为目录、文件、符号链接booleanisDirFiles.isDirectory(path);booleanisFileFiles.isRegularFile(path);booleanisLinkFiles.isSymbolicLink(path);booleanexistsFiles.exists(path);booleanreadableFiles.isReadable(path);booleanwritableFiles.isWritable(path);2.3.2 获取自定义属性// 获取特定属性ObjectattrFiles.getAttribute(path,basic:permission);// 设置属性Files.setAttribute(path,basic:readonly,true);2.3.3 文件权限 (POSIX 系统)// 检查权限booleancanExecuteFiles.isExecutable(path);// 设置权限 (需要导入 java.nio.file.attribute.PosixFilePermission)if(Files.getFileStore(path).supportsFileAttributeView(PosixFileAttributeView.class)){SetPosixFilePermissionpermsFiles.getPosixFilePermissions(path);perms.add(PosixFilePermission.OWNER_EXECUTE);Files.setPosixFilePermissions(path,perms);}2.4 目录遍历2.4.1 列出目录内容PathdirPaths.get(.);// 获取目录下的文件流try(StreamPathstreamFiles.list(dir)){stream.forEach(System.out::println);}// 递归遍历目录try(StreamPathstreamFiles.walk(dir)){stream.filter(Files::isRegularFile).forEach(System.out::println);}2.4.2 搜索文件PathdirPaths.get(.);// 搜索匹配特定条件的文件try(StreamPathstreamFiles.find(dir,10,// 最大深度(path,attr)-path.toString().endsWith(.java)Files.isRegularFile(path))){stream.forEach(System.out::println);}// 搜索匹配特定模式的文件 (glob)try(StreamPathstreamFiles.newDirectoryStream(dir,*.txt)){stream.forEach(System.out::println);}2.5 链接与临时文件2.5.1 符号链接PathtargetPaths.get(target.txt);PathlinkPaths.get(link.txt);// 创建符号链接Files.createSymbolicLink(link,target);// 读取符号链接指向的目标PathrealPathFiles.readSymbolicLink(link);// 解析符号链接获取最终目标PathresolvedFiles.readAllLinks(target);// 注意Files 没有直接 readAllLinks通常用 resolveSymbolicLinks 或手动遍历2.5.2 临时文件与目录// 创建临时文件PathtempFileFiles.createTempFile(myApp,.tmp);// 创建临时目录PathtempDirFiles.createTempDirectory(myApp);// 在系统默认临时目录创建PathtempFile2Files.createTempFile(null,.log);// 设置临时文件删除策略JDK 7 支持tempFile.toFile().deleteOnExit();// 传统方式// 或者使用 Files 的 deleteOnExit 包装需手动管理2.6 文件系统与路径// 获取文件所在的文件系统FileSystemfspath.getFileSystem();// 获取文件存储信息FileStorestoreFiles.getFileStore(path);System.out.println(Total Space: store.getTotalSpace());System.out.println(Usable Space: store.getUsableSpace());// 检查文件系统是否支持某些特性booleansupportsLinksstore.supportsFileAttributeView(LinkAttributeView.class);3. 最佳实践与注意事项3.1 异常处理Files类的方法大多抛出IOException。推荐使用try-with-resources语句自动关闭资源如Stream。注意区分FileAlreadyExistsException,NoSuchFileException,AccessDeniedException等具体异常类型以便进行更精细的错误处理。3.2 性能考量小文件readAllBytes和readAllLines非常便捷且性能良好。大文件避免使用readAllBytes应使用InputStream或Files.lines()流式处理防止内存溢出 (OOM)。大量文件遍历使用Files.walk()或Files.find()配合流式处理避免一次性加载所有路径到内存。3.3 编码问题读写文本文件时务必指定字符集如StandardCharsets.UTF_8避免依赖平台默认编码导致乱码。3.4 原子性在并发环境中Files.move和Files.copy的原子性取决于底层文件系统。对于关键操作建议使用StandardCopyOption.ATOMIC_MOVE但这要求目标路径所在的文件系统支持原子移动。3.5 权限与安全操作文件前建议先检查isReadable,isWritable等权限。创建临时文件时注意设置合适的权限防止敏感信息泄露。4. 代码示例综合应用以下是一个综合示例演示了如何创建一个目录结构、写入文件、读取内容、遍历目录并统计文件数量。importjava.io.IOException;importjava.nio.file.*;importjava.nio.charset.StandardCharsets;importjava.util.List;importjava.util.stream.Stream;publicclassFilesDemo{publicstaticvoidmain(String[]args){PathbaseDirPaths.get(demo_project);PathsrcDirbaseDir.resolve(src);Pathfile1srcDir.resolve(Main.java);Pathfile2srcDir.resolve(Utils.java);try{// 1. 创建目录结构 (递归)Files.createDirectories(srcDir);System.out.println(目录创建成功: srcDir);// 2. 写入文件ListStringcontent1List.of(public class Main {, public static void main(String[] args) {},});Files.write(file1,content1,StandardCharsets.UTF_8);Files.write(file2,List.of(class Utils { }),StandardCharsets.UTF_8);System.out.println(文件写入成功);// 3. 读取文件内容ListStringlinesFiles.readAllLines(file1,StandardCharsets.UTF_8);System.out.println(读取文件内容:);lines.forEach(System.out::println);// 4. 遍历目录并统计longcount0;try(StreamPathstreamFiles.walk(srcDir)){countstream.filter(Files::isRegularFile).filter(p-p.toString().endsWith(.java)).count();}System.out.println(Java 文件数量: count);// 5. 获取文件属性System.out.println(文件大小: Files.size(file1) bytes);System.out.println(最后修改时间: Files.getLastModifiedTime(file1));// 6. 移动文件PathbackupbaseDir.resolve(backup).resolve(Main.java.bak);Files.createDirectories(backup.getParent());Files.move(file1,backup,StandardCopyOption.REPLACE_EXISTING);System.out.println(文件已移动至备份目录);// 7. 删除文件Files.deleteIfExists(file2);System.out.println(文件 Utils.java 已删除);}catch(IOExceptione){e.printStackTrace();}}}5. 总结java.nio.file.Files类是 Java 文件操作的现代标准。它提供了简洁的 API一行代码完成复杂的文件操作。强大的功能支持流式处理、属性操作、目录遍历等。更好的异常处理明确的异常类型便于调试。跨平台兼容性基于Path接口屏蔽了不同操作系统的差异。掌握Files类能够显著提升 Java 应用程序在文件处理方面的开发效率和代码质量。在实际开发中应优先使用Files类替代传统的java.io文件操作方式。