OutputStreamWriter是字符流到字节流的桥接器,通过指定编码将字符转换为字节并委托底层OutputStream写入;配合ByteArrayOutputStream可动态获取编码后的字节数组,需显式flush确保转换完整。

OutputStreamWriter 本身不直接“写入字节”,而是将字符按指定编码**转换为字节**,再委托给底层 OutputStream(比如 ByteArrayOutputStream)真正写入。所以,用它配合 ByteArrayOutputStream 动态构建编码后的字节,本质是:先写字符,再从流中提取编码完成的原始字节数组。
核心步骤:构造链式写入流
你需要把 ByteArrayOutputStream 包装成 OutputStreamWriter 的目标输出流,并指定编码(如 UTF-8、GBK)。这样每次调用 write() 写字符串或字符时,都会自动按该编码转成字节并追加到 ByteArrayOutputStream 的内部缓冲区中。
- 创建 ByteArrayOutputStream 实例(无需预设大小,它会自动扩容)
- 用它构造 OutputStreamWriter,显式传入编码名(推荐用 StandardCharsets.UTF_8 等常量,避免字符串拼写错误)
- 调用 write(String)、write(char[]) 或 write(int) 写入内容
- 务必调用 flush()(确保缓冲的字符全部转字节写出),close() 也可触发 flush,但显式 flush 更清晰
- 最后调用 toByteArray() 获取最终编码后的字节数组
完整示例(UTF-8 编码)
注意:不要用 writer.toString() —— 那是 OutputStreamWriter 自己的字符串表示,不是内容!
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
ByteArrayOutputStream baos = new ByteArrayOutputStream();
try (OutputStreamWriter osw = new OutputStreamWriter(baos, StandardCharsets.UTF_8)) {
osw.write("你好");
osw.write("\n");
osw.write("world");
osw.flush(); // 关键:确保所有字符都转成字节写入 baos
}
byte[] encodedBytes = baos.toByteArray(); // ✅ 这才是 UTF-8 编码后的字节
// encodedBytes 现在包含: [0xE4, 0xBD, 0xA0, 0xE5, 0xA5, 0xBD, 0x0A, 0x77, 0x6F, 0x72, 0x6C, 0x64]
为什么不能跳过 OutputStreamWriter 直接用 ByteArrayOutputStream?
ByteArrayOutputStream 只接受 byte 或 byte[],它不知道字符编码。如果你直接写字符串的 getBytes(),就得自己控制编码一致性(比如每次都用 "中文".getBytes(StandardCharsets.UTF_8)),容易出错;而 OutputStreamWriter 把编码逻辑封装好了,后续 write 调用都自动复用同一套规则,更安全、更语义清晰。
立即学习“Java免费学习笔记(深入)”;
常见注意事项
- 编码名必须准确匹配(如 "UTF-8"、"GBK"),否则抛 UnsupportedEncodingException;用 StandardCharsets 常量可彻底避免此问题
- OutputStreamWriter 有内部字符缓冲区,不 flush 可能导致部分字符未转字节,toByteArray() 就不完整
- 如果需要多次写入、中间获取字节,可以反复调用 baos.toByteArray()(它返回当前快照),但注意这会创建新数组,频繁调用影响性能
- 不需要手动处理 BOM(如 UTF-8 BOM),OutputStreamWriter 默认不写 BOM;如需 BOM,得自己在开头写入 new byte[]{(byte)0xEF, (byte)0xBB, (byte)0xBF}

















