Webswing 25.10
Webswing 可在浏览器中运行 Swing、JavaFX 或 SWT 应用,无需修改源代码。借助 webforJ,您可以将该应用嵌入 Web 应用中,并逐个屏幕地替换它。要让两者互相传递消息,您需要将 Webswing API 添加到 Swing 应用中。
Webswing 是一种 Web 服务器技术。它在服务器上渲染桌面应用,并通过 HTML5 canvas 将界面流式传输到浏览器,同时透明地处理所有用户交互。
如需了解整个流程的概览,从在浏览器中运行桌面应用到将其退役,请参阅 Swing 现代化。
Moving a desktop Java app to the web?
Send us a screenshot of one screen and we'll reply with how it moves to webforJ.
Webswing 解决的问题
许多组织在 Java 桌面应用上投入了大量资源。这些应用包含经过多年甚至数十年开发的关键业务逻辑。由于以下原因,这些应用通常难以轻易重写:
- 复杂的领域逻辑,重新实现存在风险
- 与桌面专用库或硬件集成
- 全面重写的时间和成本限制
- 需要保持与现有应用的功能一致
Webswing 可让这些应用无需修改即可通过 Web 访问,同时保留原有功能和外观。
与 webforJ 集成
webforJ 的 Webswing 集成提供了 WebswingConnector 组件,可将由 Webswing 托管的应用直接嵌入 webforJ 应用中。这为以下场景提供了可能:
渐进式现代化
无需一次性重写,您可以:
- 首先通过
WebswingConnector嵌入现有的 Swing 应用 - 围绕嵌入的应用,在 webforJ 中构建新功能
- 逐步用 webforJ 对应组件替换 Swing 组件
- 最终完全淘汰旧版应用
混合应用
将使用 webforJ 构建的现代 Web UI 与专用桌面功能相结合:
- 使用 webforJ 构建面向用户的界面、仪表板和报告
- 保留 Swing,用于复杂可视化或专用编辑器
- 维持统一集成的应用体验
请参阅 从 Swing 迁移,了解 Swing 组件与 webforJ 对应组件之间的对比。对比中还包含相关参考资料,帮助您使用各个 webforJ 对应功能。
工作原理
此集成通过以下三个层实现:
- Webswing Server:运行 Java 桌面应用,捕获其视觉输出并处理用户输入
- WebswingConnector Component:一种 webforJ 组件,用于嵌入 Webswing 客户端,并管理与服务器的连接和通信
- Communication Protocol:双向消息传递,使 webforJ 应用可以向 Swing 应用发送命令并接收其返回的事件
用户访问 webforJ 应用时,WebswingConnector 会与 Webswing 服务器建立连接。服务器会创建应用实例或重新连接到现有实例,并开始向浏览器流式传输视觉状态。用户交互(鼠标、键盘)会被捕获并发送到服务器,然后在实际的 Swing 应用中重放。
主题
安装与配置
安装 Webswing 服务器,在管理控制台注册 Swing 应用,并配置 CORS,以便 webforJ 使用 WebswingConnector 嵌入应用。
通信
通过 WebswingConnector 生命周期和自定义操作处理器,在 webforJ 应用与嵌入式 Swing 应用之间交换操作和事件。
现代化教程
通过嵌入 WebswingConnector,并逐步添加 webforJ 对话框和表单,逐步实现 Swing 客户管理应用的现代化。
继续学习
文章Modernize a Java Swing app without JavaScript: JavaOne 2026
文章Run a Java Swing Application in the Browser Without a Rewrite
文章Strangler Fig Pattern for a Java Swing App, Step by Step
文章Modernize a Java Swing application: an enterprise decision guide
文章Java Swing to web migration: pick the right path
文章Modernize an ERP UI in Java without a big-bang rewrite