Java 转换流详解

原创于 2025-08-25 09:53:37 发布 · 864 阅读

26 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#算法 #java #开发语言

一、转换流的基本概念

转换流的概念与作用

转换流（Conversion Stream）是Java I/O系统中重要的桥梁类，它实现了字节流与字符流之间的双向转换。其核心作用主要体现在以下三个方面：

编码转换：可以在字节和字符转换过程中指定特定的字符编码格式（如UTF-8、GBK等），解决因编码不一致导致的乱码问题
流类型转换：将面向字节的I/O操作转换为面向字符的I/O操作，或者反向转换
缓冲功能：内置缓冲区可提高I/O操作效率

Java中的主要转换流类

Java提供了两个核心的转换流类：

1. InputStreamReader

功能：将字节输入流转换为字符输入流的桥梁

典型应用场景：

从网络套接字读取文本数据时
读取使用特定编码保存的文件时
处理来自不同编码环境的输入源时

构造方法示例：

// 使用默认字符编码
InputStreamReader isr = new InputStreamReader(inputStream);

// 指定字符编码
InputStreamReader isr = new InputStreamReader(inputStream, "UTF-8");

2. OutputStreamWriter

功能：将字符输出流转换为字节输出流的桥梁

典型应用场景：

向网络套接字写入文本数据时
以特定编码格式保存文件时
需要确保输出内容编码一致性的场景

构造方法示例：

// 使用默认字符编码
OutputStreamWriter osw = new OutputStreamWriter(outputStream);

// 指定字符编码
OutputStreamWriter osw = new OutputStreamWriter(outputStream, "GBK");

编码处理机制

转换流在字符编码处理方面遵循以下原则：

当不显式指定编码时，使用平台默认的字符编码
可以显式指定支持的任意字符编码
遇到无法识别的字符序列时，行为取决于具体的编码实现
提供了检测编码是否被支持的方法

实际应用示例

示例1：读取不同编码的文件

try (InputStreamReader reader = 
     new InputStreamReader(
         new FileInputStream("data.txt"), 
         "ISO-8859-1")) {
    // 读取ISO-8859-1编码的文件内容
}

示例2：写入特定编码的网络数据

try (OutputStreamWriter writer = 
     new OutputStreamWriter(
         socket.getOutputStream(), 
         "UTF-8")) {
    // 以UTF-8编码向网络写入数据
}

性能考虑

转换流内置缓冲区，通常比直接使用字节流效率更高
对于频繁的小数据量操作，建议使用BufferedReader/BufferedWriter包装转换流
编码转换过程有一定性能开销，在性能敏感场景应谨慎选择编码格式

二、InputStreamReader 类

（一）类的定义与继承关系

InputStreamReader 是 Java I/O 系统中的重要类，它继承自抽象类 Reader（位于 java.io 包中）。作为字节流向字符流的转换桥梁，它专门负责解决字节流到字符流的转换问题。

工作原理

InputStreamReader 内部维护了一个字节缓冲区，它会从底层 InputStream 中读取字节数据（通常是 1-4 个字节），然后根据指定的字符编码规则（如 UTF-8、GBK 等）将这些字节解码为对应的 Unicode 字符。这个过程涉及字符编码的转换，因此正确的字符集设置至关重要。

典型应用场景

处理网络传输的字节数据（如 HTTP 响应）
读取使用特定编码的文本文件
作为 BufferedReader 的底层流使用

（二）构造方法详解

1. `InputStreamReader(InputStream in)`

使用平台默认字符集创建 InputStreamReader。

示例：

FileInputStream fis = new FileInputStream("text.txt");
InputStreamReader isr = new InputStreamReader(fis);  // 使用系统默认字符集

注意：默认字符集取决于 JVM 运行环境，可能导致跨平台兼容性问题。

2. `InputStreamReader(InputStream in, String charsetName)`

使用指定字符集名称创建 InputStreamReader。

参数说明：

charsetName：支持的字符集名称，如 "UTF-8"、"GBK"、"ISO-8859-1"等

示例：

InputStreamReader isr = new InputStreamReader(
    new FileInputStream("data.txt"), 
    "UTF-8"
);

异常处理：

try {
    InputStreamReader isr = new InputStreamReader(in, "UNKNOWN_CHARSET");
} catch (UnsupportedEncodingException e) {
    System.err.println("不支持的字符集：" + e.getMessage());
}

3. `InputStreamReader(InputStream in, Charset cs)`

使用 Charset 对象创建 InputStreamReader（Java 1.4+）。

优点：

编译时字符集有效性检查
更好的性能（字符集对象可复用）

示例：

Charset utf8 = Charset.forName("UTF-8");
InputStreamReader isr = new InputStreamReader(
    new ByteArrayInputStream(bytes),
    utf8
);

4. `InputStreamReader(InputStream in, CharsetDecoder dec)`

使用自定义字符集解码器创建 InputStreamReader（高级用法）。

适用场景：

需要自定义错误处理策略
需要特殊字符替换规则

示例：

CharsetDecoder decoder = StandardCharsets.UTF_8.newDecoder()
    .onMalformedInput(CodingErrorAction.REPLACE)
    .onUnmappableCharacter(CodingErrorAction.REPLACE);
InputStreamReader isr = new InputStreamReader(inputStream, decoder);

（三）常用方法详解

1. `int read()`

读取单个字符。

返回值：

正常情况：返回 0-65535 范围内的 Unicode 字符
流结束：返回 -1

示例：

int ch;
while ((ch = isr.read()) != -1) {
    System.out.print((char)ch);
}

注意：效率较低，适合读取少量字符。

2. `int read(char[] cbuf, int offset, int length)`

批量读取字符到数组。

参数说明：

cbuf：目标字符数组
offset：存储起始位置
length：最大读取字符数

返回值：

实际读取的字符数
流结束：返回 -1

最佳实践：

char[] buffer = new char[1024];
int charsRead;
while ((charsRead = isr.read(buffer, 0, buffer.length)) != -1) {
    String content = new String(buffer, 0, charsRead);
    System.out.print(content);
}

3. `boolean ready()`

检查流是否可读。

返回值：

true：至少有一个字符可立即读取
false：可能需要阻塞等待

典型用法：

if (isr.ready()) {
    int ch = isr.read();
    // 处理字符
}

注意：不能替代 read() 返回的 -1 来检测流结束。

4. `void close()`

关闭流并释放资源。

重要说明：

关闭后任何读取操作都会抛出 IOException
推荐使用 try-with-resources 语法

正确关闭方式：

try (InputStreamReader isr = new InputStreamReader(...)) {
    // 使用流
} // 自动关闭

手动关闭示例：

InputStreamReader isr = null;
try {
    isr = new InputStreamReader(...);
    // 使用流
} finally {
    if (isr != null) {
        try {
            isr.close();
        } catch (IOException e) {
            // 记录日志
        }
    }
}

其他重要方法

String getEncoding()：返回此流使用的字符编码名称
long skip(long n)：跳过并丢弃 n 个字符的数据

三、OutputStreamWriter 类

（一）类的定义与继承关系

OutputStreamWriter 是 Java I/O 体系中的重要桥梁类，它继承自抽象类 Writer。作为字符流到字节流的转换器，它的核心功能是将字符数据按照指定的字符编码方案转换为字节数据，然后通过底层的字节输出流写入目标位置。

工作原理

OutputStreamWriter 内部维护了一个字符编码器（CharsetEncoder），当调用 write() 方法写入字符数据时：

字符数据首先被放入缓冲区
通过指定的字符集编码器将字符转换为字节
转换后的字节被传递到底层的 OutputStream 进行实际写入

典型应用场景

将文本数据写入文件时指定特定编码（如 UTF-8、GBK）
网络通信中处理不同编码的文本传输
与旧系统交互时需要处理特殊字符编码

（二）构造方法详解

1. OutputStreamWriter(OutputStream out)

创建使用平台默认字符集的转换流。实际使用的字符集取决于系统属性"file.encoding"。

FileOutputStream fos = new FileOutputStream("output.txt");
OutputStreamWriter osw = new OutputStreamWriter(fos);  // 使用默认字符集

2. OutputStreamWriter(OutputStream out, String charsetName)

显式指定字符集名称创建转换流。支持的字符集包括：

"UTF-8"
"GBK"
"ISO-8859-1"
"US-ASCII"
等其他Java支持的字符集

try {
    OutputStreamWriter osw = new OutputStreamWriter(
        new FileOutputStream("output_utf8.txt"), 
        "UTF-8");
} catch (UnsupportedEncodingException e) {
    System.err.println("不支持的字符集: " + e.getMessage());
}

3. OutputStreamWriter(OutputStream out, Charset cs)

使用Charset对象创建转换流，这种方式更现代化且类型安全。

Charset utf8Charset = Charset.forName("UTF-8");
OutputStreamWriter osw = new OutputStreamWriter(
    new FileOutputStream("output.txt"), 
    utf8Charset);

4. OutputStreamWriter(OutputStream out, CharsetEncoder enc)

使用预配置的字符编码器创建转换流，适用于需要精细控制编码过程的场景。

CharsetEncoder encoder = StandardCharsets.UTF_8.newEncoder()
    .onMalformedInput(CodingErrorAction.REPLACE)
    .onUnmappableCharacter(CodingErrorAction.REPLACE);
OutputStreamWriter osw = new OutputStreamWriter(
    new FileOutputStream("output.txt"), 
    encoder);

（三）常用方法深入解析

1. void write(int c)

写入单个字符，实际写入的是该字符的低16位（高16位被忽略）。

OutputStreamWriter osw = ...;
osw.write('A');  // 写入大写字母A
osw.write(0x4E2D);  // 写入中文字符'中'

2. void write(char[] cbuf, int offset, int length)

写入字符数组的指定部分，更高效的大批量写入方式。

char[] data = {'H','e','l','l','o',' ','W','o','r','l','d'};
OutputStreamWriter osw = ...;
osw.write(data, 0, 5);  // 写入"Hello"
osw.write(data, 6, 5);  // 写入"World"

3. void write(String str, int offset, int length)

写入字符串的子串，处理字符串数据最常用的方法。

String text = "这是一段测试文本";
OutputStreamWriter osw = ...;
osw.write(text, 0, 2);  // 写入"这是"
osw.write(text, 2, 4);  // 写入"一段测试"

4. void flush()

强制将缓冲区中的字符编码并写入底层流。在需要确保数据立即写入时使用，如：

重要的日志记录
实时通信场景
长时间运行但需要阶段性保存结果的程序

OutputStreamWriter osw = ...;
osw.write("重要数据");
osw.flush();  // 确保数据立即写入，不留在缓冲区

5. void close()

关闭流并释放相关资源，关闭前会自动执行flush()操作。最佳实践是使用try-with-resources语句自动关闭。

try (OutputStreamWriter osw = new OutputStreamWriter(
        new FileOutputStream("output.txt"))) {
    osw.write("自动关闭示例");
}  // 此处自动调用close()

注意：关闭后再次调用任何方法都会抛出IOException。典型错误模式：

OutputStreamWriter osw = ...;
osw.close();
osw.write("test");  // 抛出IOException: Stream closed

四、转换流的使用示例

（一）使用 InputStreamReader 读取文件

下面的示例完整演示了如何使用InputStreamReader读取指定编码格式的文件内容，包括具体实现步骤和异常处理：

import java.io.*;

public class InputStreamReaderDemo {

    public static void main(String[] args) {
        // 定义文件路径 - 这里可以使用相对路径或绝对路径
        // 示例中使用的test.txt文件应放在项目根目录下
        String filePath = "test.txt";
        
        // 定义字符输入流引用，初始化为null
        InputStreamReader isr = null;

        try {
            // 第一步：创建字节输入流FileInputStream
            // 这里的FileInputStream是底层字节流，负责读取文件的原始字节
            FileInputStream fis = new FileInputStream(filePath);
            
            // 第二步：创建InputStreamReader，指定编码格式为UTF-8
            // InputStreamReader是转换流，将字节流转换为字符流
            // 指定编码格式确保正确解码文件内容，特别是处理中文等非ASCII字符
            isr = new InputStreamReader(fis, "UTF-8");
            
            // 第三步：定义字符缓冲区
            // 使用1024大小的缓冲区，这是比较常见的缓冲区大小
            // 也可以根据实际需求调整大小，如2048或4096
            char[] cbuf = new char[1024];
            int len;  // 用于记录每次实际读取的字符数
            
            // 第四步：循环读取文件内容
            // read()方法返回读取的字符数，-1表示到达文件末尾
            while ((len = isr.read(cbuf)) != -1) {
                // 将读取的字符数组转换为字符串并输出
                // 使用0到len的范围确保只处理实际读取的字符
                System.out.print(new String(cbuf, 0, len));
            }
            
        } catch (FileNotFoundException e) {
            // 文件未找到异常处理
            System.err.println("错误：找不到文件 " + filePath);
            e.printStackTrace();
        } catch (UnsupportedEncodingException e) {
            // 不支持的编码格式异常处理
            System.err.println("错误：指定的编码格式不支持");
            e.printStackTrace();
        } catch (IOException e) {
            // 其他IO异常处理
            System.err.println("错误：读取文件时发生IO异常");
            e.printStackTrace();
        } finally {
            // 第五步：在finally块中确保流被关闭
            // 这是重要的资源清理步骤
            if (isr != null) {
                try {
                    isr.close();
                } catch (IOException e) {
                    System.err.println("错误：关闭流时发生异常");
                    e.printStackTrace();
                }
            }
        }
    }
}

（二）使用 OutputStreamWriter 写入文件

下面的示例完整演示了如何使用OutputStreamWriter将内容以指定编码格式写入文件：

import java.io.*;

public class OutputStreamWriterDemo {

    public static void main(String[] args) {
        // 定义文件路径 - 将创建或覆盖该文件
        String filePath = "output.txt";
        
        // 定义字符输出流引用，初始化为null
        OutputStreamWriter osw = null;

        try {
            // 第一步：创建字节输出流FileOutputStream
            // 如果文件不存在会自动创建，存在则会被覆盖
            // 若要追加内容而不是覆盖，可使用new FileOutputStream(filePath, true)
            FileOutputStream fos = new FileOutputStream(filePath);
            
            // 第二步：创建OutputStreamWriter，指定编码格式为UTF-8
            // OutputStreamWriter是转换流，将字符流转换为字节流
            // 指定编码格式确保文本以正确的编码写入文件
            osw = new OutputStreamWriter(fos, "UTF-8");
            
            // 第三步：写入内容
            // 这里写入的是包含英文和中文的字符串
            osw.write("Hello, 世界！");
            
            // 第四步：刷新缓冲
            // 确保所有缓冲的数据都被写入文件
            // 在close()之前调用flush()是良好的编程习惯
            osw.flush();
            
            System.out.println("写入成功！文件已保存在: " + 
                new File(filePath).getAbsolutePath());
            
        } catch (FileNotFoundException e) {
            System.err.println("错误：无法创建文件 " + filePath);
            e.printStackTrace();
        } catch (UnsupportedEncodingException e) {
            System.err.println("错误：指定的编码格式不支持");
            e.printStackTrace();
        } catch (IOException e) {
            System.err.println("错误：写入文件时发生IO异常");
            e.printStackTrace();
        } finally {
            // 第五步：在finally块中确保流被关闭
            if (osw != null) {
                try {
                    osw.close();
                } catch (IOException e) {
                    System.err.println("错误：关闭流时发生异常");
                    e.printStackTrace();
                }
            }
        }
    }
}

五、注意事项

编码格式的一致性：
- 在实际开发中，编码格式不一致会导致严重的乱码问题
- 示例：使用OutputStreamWriter写入UTF-8编码的文件
```
OutputStreamWriter writer = new OutputStreamWriter(
    new FileOutputStream("output.txt"), "UTF-8");
```
- 对应的读取应使用相同的编码：
```
InputStreamReader reader = new InputStreamReader(
    new FileInputStream("output.txt"), "UTF-8");
```
- 常见的编码格式冲突：
  - 用UTF-8写入但用GBK读取
  - 用UTF-16写入但用UTF-8读取
  - 用ISO-8859-1写入但用UTF-8读取

流的关闭顺序：

正确的关闭顺序示例：

// 创建流
FileInputStream fis = new FileInputStream("input.txt");
InputStreamReader isr = new InputStreamReader(fis, "UTF-8");

// 关闭流（正确顺序）
isr.close(); // 会自动关闭fis

错误示例：

fis.close(); // 先关闭字节流
isr.close(); // 再关闭转换流（可能导致资源泄漏）

最佳实践：使用try-with-resources语法自动管理资源

异常处理：

完整的异常处理示例：

try {
    InputStreamReader reader = new InputStreamReader(
        new FileInputStream("file.txt"), "UTF-8");
    // 读写操作...
} catch (FileNotFoundException e) {
    System.err.println("文件未找到：" + e.getMessage());
} catch (UnsupportedEncodingException e) {
    System.err.println("不支持的编码格式：" + e.getMessage());
} catch (IOException e) {
    System.err.println("IO异常：" + e.getMessage());
} finally {
    // 关闭资源
}

常见异常场景：
- 文件路径错误导致FileNotFoundException
- 指定了不存在的编码格式导致UnsupportedEncodingException
- 磁盘空间不足导致IOException

缓冲的使用：

典型组合使用示例：

BufferedReader reader = new BufferedReader(
    new InputStreamReader(
        new FileInputStream("input.txt"), "UTF-8"));
        
BufferedWriter writer = new BufferedWriter(
    new OutputStreamWriter(
        new FileOutputStream("output.txt"), "UTF-8"));

性能对比：
- 无缓冲流：每次读写都是一个IO操作
- 缓冲流：默认8KB缓冲区，显著减少IO次数
适用场景：
- 大文件读写
- 高频次的小数据量读写

字符集的选择：
- 常见字符集对比：
  字符集特点适用场景
  UTF-8 可变长度，兼容ASCII 国际化的Web应用、跨平台
  GBK 固定双字节，支持中文中文Windows系统
  ISO-8859-1 单字节，仅支持西欧字符遗留系统
- 选择建议：
  - 新项目优先使用UTF-8
  - 与旧系统交互时使用系统原有编码
  - 处理中文文本时注意GBK与UTF-8的区别
flush()方法的使用：
- 典型使用场景：
```
OutputStreamWriter writer = ...;
writer.write("重要数据");
writer.flush(); // 立即将数据写入磁盘
```
- 注意事项：
  - 频繁调用flush()会影响性能
  - 在写入关键数据后建议显式调用
  - 批量写入时可在最后调用一次即可
- 自动flush场景：
  - 缓冲区满时自动flush
  - 调用close()时自动flush
  - 某些流实现可能设置自动flush模式

字符集	特点	适用场景
UTF-8	可变长度，兼容ASCII	国际化的Web应用、跨平台
GBK	固定双字节，支持中文	中文Windows系统
ISO-8859-1	单字节，仅支持西欧字符	遗留系统

Java 转换流详解

一、转换流的基本概念

转换流的概念与作用

Java中的主要转换流类

1. InputStreamReader

2. OutputStreamWriter

编码处理机制

实际应用示例

示例1：读取不同编码的文件

示例2：写入特定编码的网络数据

性能考虑

二、InputStreamReader 类

（一）类的定义与继承关系

工作原理

典型应用场景

（二）构造方法详解

1. InputStreamReader(InputStream in)

2. InputStreamReader(InputStream in, String charsetName)

3. InputStreamReader(InputStream in, Charset cs)

4. InputStreamReader(InputStream in, CharsetDecoder dec)

（三）常用方法详解

1. int read()

2. int read(char[] cbuf, int offset, int length)

3. boolean ready()

4. void close()

其他重要方法

三、OutputStreamWriter 类

（一）类的定义与继承关系

工作原理

典型应用场景

（二）构造方法详解

1. OutputStreamWriter(OutputStream out)

2. OutputStreamWriter(OutputStream out, String charsetName)

3. OutputStreamWriter(OutputStream out, Charset cs)

4. OutputStreamWriter(OutputStream out, CharsetEncoder enc)

（三）常用方法深入解析

1. void write(int c)

2. void write(char[] cbuf, int offset, int length)

3. void write(String str, int offset, int length)

4. void flush()

5. void close()

四、转换流的使用示例

（一）使用 InputStreamReader 读取文件

（二）使用 OutputStreamWriter 写入文件

五、注意事项

1. `InputStreamReader(InputStream in)`

2. `InputStreamReader(InputStream in, String charsetName)`

3. `InputStreamReader(InputStream in, Charset cs)`

4. `InputStreamReader(InputStream in, CharsetDecoder dec)`

1. `int read()`

2. `int read(char[] cbuf, int offset, int length)`

3. `boolean ready()`

4. `void close()`