OutputStreamWriter 是 Java IO 流体系中的一个重要类,它属于字符输出流,用于将写入的字符编码成字节,并将其写入底层字节输出流。这种转换流在处理文本数据时非常有用,尤其是在需要处理不同字符编码的场景下。
1. OutputStreamWriter 简介
OutputStreamWriter 是一个桥梁类,用于在字符流和字节流之间转换。它使用指定的字符集将写入的字符编码成字节,然后写入底层的字节输出流。当需要写入文本数据时,OutputStreamWriter 能够确保数据以正确的编码格式写入。
2. OutputStreamWriter 构造方法
OutputStreamWriter 提供了以下两个构造方法:
- (1)OutputStreamWriter(OutputStream out) 使用默认字符集创建一个 OutputStreamWriter 实例。
- (2)OutputStreamWriter(OutputStream out, Charset cs) 使用指定的字符集创建一个 OutputStreamWriter 实例。
3. OutputStreamWriter 常用方法
以下是 OutputStreamWriter 的一些常用方法:
- (1)void write(int c) 写入单个字符。
- (2)void write(char[] cbuf, int off, int len) 写入字符数组的一部分。
- (3)void write(String str, int off, int len) 写入字符串的一部分。
- (4)void flush() 刷新该流的缓冲。
- (5)void close() 关闭此流,但要先刷新它。
4. 代码示例及运行结果
以下是一个简单的示例,演示如何使用 OutputStreamWriter 将文本写入文件:
import java.io.FileOutputStream;
import java.io.OutputStreamWriter;
import java.io.IOException;
public class OutputStreamWriterExample {
public static void main(String[] args) {
try {
// 创建 FileOutputStream 实例
FileOutputStream fos = new FileOutputStream("output.txt");
// 创建 OutputStreamWriter 实例,使用默认字符集
OutputStreamWriter osw = new OutputStreamWriter(fos);
// 写入文本内容
String text = "Hello, World!";
osw.write(text);
// 刷新缓冲区并关闭流
osw.flush();
osw.close();
fos.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
运行上述代码后,会在当前目录下创建一个名为 output.txt
的文件,文件内容为:
Hello, World!
接下来,我们使用指定字符集将文本写入文件:
import java.io.FileOutputStream;
import java.io.OutputStreamWriter;
import java.io.IOException;
import java.nio.charset.Charset;
public class OutputStreamWriterExample2 {
public static void main(String[] args) {
try {
// 创建 FileOutputStream 实例
FileOutputStream fos = new FileOutputStream("output_utf8.txt");
// 创建 OutputStreamWriter 实例,指定字符集为 UTF-8
OutputStreamWriter osw = new OutputStreamWriter(fos, Charset.forName("UTF-8"));
// 写入文本内容,包含非ASCII字符
String text = "Hello, 世界!";
osw.write(text);
// 刷新缓冲区并关闭流
osw.flush();
osw.close();
fos.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
运行上述代码后,会在当前目录下创建一个名为 output_utf8.txt
的文件,文件内容为:
Hello, 世界!
使用文本编辑器打开 output_utf8.txt
文件,并确保编辑器使用 UTF-8 编码,可以看到正确的文本内容。
5. 使用 BufferedWriter 包装 OutputStreamWriter
在实际应用中,我们经常将 OutputStreamWriter 与 BufferedWriter 结合使用,以提供缓冲功能,从而提高写入效率。以下是一个使用 BufferedWriter 包装 OutputStreamWriter 的示例:
import java.io.BufferedWriter;
import java.io.FileOutputStream;
import java.io.OutputStreamWriter;
import java.io.IOException;
import java.nio.charset.Charset;
public class BufferedWriterExample {
public static void main(String[] args) {
try {
// 创建 FileOutputStream 实例
FileOutputStream fos = new FileOutputStream("buffered_output.txt");
// 创建 OutputStreamWriter 实例,指定字符集为 UTF-8
OutputStreamWriter osw = new OutputStreamWriter(fos, Charset.forName("UTF-8"));
// 使用 BufferedWriter 包装 OutputStreamWriter
BufferedWriter bw = new BufferedWriter(osw);
// 写入文本内容
String text = "使用 BufferedWriter 提高写入效率。\n这是第二行。";
bw.write(text);
// 刷新缓冲区并关闭流
bw.flush();
bw.close();
osw.close();
fos.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
运行上述代码后,会在当前目录下创建一个名为 buffered_output.txt
的文件,文件内容为:
使用 BufferedWriter 提高写入效率。
这是第二行。
使用文本编辑器打开 buffered_output.txt
文件,并确保编辑器使用 UTF-8 编码,可以看到正确的文本内容,并且两行之间有换行符。
6. 处理异常和资源管理
在上面的例子中,我们直接在 catch 块中处理了 IOException。然而,更好的做法是使用 try-with-resources 语句来自动管理资源,这样可以确保每个资源在使用后都能被正确关闭,即使在发生异常的情况下也是如此。以下是使用 try-with-resources 的示例:
import java.io.BufferedWriter;
import java.io.FileOutputStream;
import java.io.OutputStreamWriter;
import java.io.IOException;
import java.nio.charset.Charset;
public class BufferedWriterExampleWithTryWithResources {
public static void main(String[] args) {
// 指定字符集为 UTF-8
Charset utf8Charset = Charset.forName("UTF-8");
// 使用 try-with-resources 自动管理资源
try (FileOutputStream fos = new FileOutputStream("buffered_output.txt");
OutputStreamWriter osw = new OutputStreamWriter(fos, utf8Charset);
BufferedWriter bw = new BufferedWriter(osw)) {
// 写入文本内容
String text = "使用 try-with-resources 自动管理资源。\n这是第二行。";
bw.write(text);
// BufferedWriter 的 flush 方法在 close 时自动调用
} catch (IOException e) {
e.printStackTrace();
}
}
}
在这个例子中,我们不需要显式调用 flush()
和 close()
方法,因为 try-with-resources 语句会在 try 块执行完毕后自动关闭这些资源。