JAVA中的转换流OutputStreamWriter

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 块执行完毕后自动关闭这些资源。