讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在 Java 中利用 PrintWriter 简化向网络输出流写入格式化文本的逻辑

陌枫酱_1443

陌枫酱_1443

发布时间:2026-04-28 20:10:26

|

772人浏览过

|

来源于php中文网

原创

不能直接 new PrintWriter(socket.getOutputStream()),因为未启用自动刷新(autoFlush=false)时,println() 等方法不会调用 flush(),数据滞留在缓冲区导致对方收不到;且未指定字符编码易乱码,正确做法是 new PrintWriter(new OutputStreamWriter(out, UTF_8), true)。

如何在 java 中利用 printwriter 简化向网络输出流写入格式化文本的逻辑

PrintWriter 本身不处理网络连接,它只负责格式化写入;直接包装 Socket.getOutputStream() 是常见但易出错的做法。

为什么不能直接 new PrintWriter(socket.getOutputStream())

Socket 的 OutputStream 默认不带缓冲,且 PrintWriter 的 println() 等方法在底层调用 write() + flush() 时,若未启用自动刷新(autoFlush=true),数据可能卡在缓冲区里发不出去——对方收不到任何内容,调试时看似“没反应”。

常见错误现象:socket.getOutputStream().write("HELLO\n".getBytes()) 能通,但换成 pw.println("HELLO") 就收不到。

  • 必须显式传入 true 启用自动刷新:new PrintWriter(socket.getOutputStream(), true)
  • 更稳妥的做法是:先套一层 BufferedOutputStream(尤其在高吞吐场景),再交给 PrintWriter
  • 字符编码必须明确指定,否则依赖平台默认编码(如 Windows 的 GBK),和服务端不一致就乱码

正确构造支持 UTF-8 的 PrintWriter 实例

绕过平台默认编码、避免字节流与字符流转换失真,关键在用 OutputStreamWriter 桥接,并指定 UTF-8:

立即学习“Java免费学习笔记(深入)”;

Java 接口排错助手
Java 接口排错助手

在调试 Java 后端 API 故障时使用此技能,尤其适用于以下任务:分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转,以及生成简洁的诊断结论与修复方案。

下载
OutputStream out = socket.getOutputStream();
PrintWriter pw = new PrintWriter(
    new OutputStreamWriter(out, StandardCharsets.UTF_8),
    true // autoFlush
);

注意:StandardCharsets.UTF_8 是 Java 7+ 推荐写法;若用字符串 "UTF-8",需捕获 UnsupportedEncodingException(虽实际不会抛)。

  • 不要用 new PrintWriter(out, "UTF-8", true) —— 这个构造器在 Java 11+ 已被标记为 @Deprecated
  • 如果服务端协议要求换行符为 \r\n(如 HTTP、SMTP),println() 在 Windows 上输出 \r\n,Linux/macOS 输出 \n,此时应改用 print("xxx\r\n") + flush()

写入时哪些操作会触发 flush

PrintWriter 的自动刷新只对 println()、printf()、format() 生效,不包括 print() 或 write()。

  • pw.print("DATA"); → 不 flush,数据滞留
  • pw.println("DATA"); → 自动 flush(前提是构造时设了 true)
  • pw.printf("ID: %d", 123); → 自动 flush
  • 手动调用 pw.flush() 总是安全的,适合批量写入后统一刷出

典型陷阱:循环中混用 print() 和 println(),结果只有最后一行被刷出,前面全卡住。

关闭顺序和异常风险

PrintWriter 关闭时会调用底层 Writer 的 close(),进而关闭 OutputStream —— 也就是关闭 Socket。但若在写入中途异常(如网络中断),checkError() 才能发现底层流已失效。

  • 务必在 finally 或 try-with-resources 中关闭 PrintWriter
  • 调用 pw.checkError() 可检测是否发生 I/O 错误(例如远端断连后继续写入),返回 true 表示出错,但不会抛异常
  • 不要在 PrintWriter 关闭后还调用 socket.close(),会抛 IOException

真正容易被忽略的是:PrintWriter 对异常“静默”——写失败不会立即抛 IOException,得靠 checkError() 主动查;而很多业务逻辑只看 println() 是否返回,就以为成功了。

热门AI工具

更多
PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

11997

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

9102

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

7772

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1264

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1008

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

1516

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

3149

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

20391

2023.08.03

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

0

2026.11.05

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn