Java java.nio.file.Files.newOutputStream() 方法

指定文件打开方式的选项
常用选项来自 StandardOpenOption 枚举：
- CREATE - 如果文件不存在则创建新文件
- CREATE_NEW - 创建新文件，如果文件已存在则抛出异常
- WRITE - 打开文件用于写入
- APPEND - 以追加模式打开文件（在文件末尾写入）
- TRUNCATE_EXISTING - 如果文件已存在，则清空文件内容

返回值

返回一个 OutputStream 对象，可用于向文件写入字节数据。

使用示例

示例 1：基本使用 - 创建新文件并写入内容

实例

import java.io.IOException;
import java.io.OutputStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardOpenOption;

public class FileWriteExample {
public static void main(String[] args) {
Path path = Paths.get("example.txt");

try (OutputStream outputStream = Files.newOutputStream(path,
StandardOpenOption.CREATE,
StandardOpenOption.WRITE)) {

String content = "Hello, Java NIO!";
outputStream.write(content.getBytes());

} catch (IOException e) {
e.printStackTrace();
}
}
}

示例 2：追加内容到现有文件

实例

import java.io.IOException;
import java.io.OutputStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardOpenOption;

public class FileAppendExample {
public static void main(String[] args) {
Path path = Paths.get("example.txt");

try (OutputStream outputStream = Files.newOutputStream(path,
StandardOpenOption.CREATE,
StandardOpenOption.APPEND)) {

String additionalContent = "\nAdding more content!";
outputStream.write(additionalContent.getBytes());

} catch (IOException e) {
e.printStackTrace();
}
}
}

异常处理

Files.newOutputStream() 方法可能抛出以下异常：

1、IOException

1、如果发生 I/O 错误时抛出

2、例如：没有写入权限、磁盘空间不足等

2、UnsupportedOperationException

1、如果指定了不支持的选项时抛出

3、SecurityException

1、在安全管理器存在且拒绝访问文件时抛出

最佳实践

1、使用 try-with-resources

1、如示例所示，使用 try-with-resources 语句确保流被正确关闭

2、这样可以避免资源泄漏

2、明确指定 OpenOption

1、即使不指定选项，方法也会有默认行为

但明确指定可以使代码意图更清晰

3、处理路径安全

1、验证路径是否在允许的目录范围内

2、防止路径遍历攻击

4、考虑文件锁定

1、如果需要独占访问文件，考虑使用文件锁定机制

与 FileOutputStream 的比较

1、Files.newOutputStream() 优点

1、更现代的 API，与 NIO 集成更好

2、支持更多打开选项

可以处理符号链接

2、FileOutputStream 适用场景

1、需要与遗留代码兼容时

2、只需要最基本的文件写入功能时

总结

Files.newOutputStream() 是 Java NIO 中用于文件写入的便捷方法，提供了灵活的选项来控制文件打开方式。相比传统的 FileOutputStream，它与 NIO 的其他组件集成更好，支持更多高级功能。在编写新的 Java 应用程序时，推荐使用这个方法进行文件写入操作。

通过合理使用 OpenOption 参数，可以精确控制文件的创建、覆盖或追加行为，满足不同的业务需求。

51 次浏览	1次

< 首页

< 下一页