如何在 Web 浏览器中运行 Java Swing 应用

将现有 Java Swing 应用带入浏览器。了解如何启动 Webswing、配置应用，并验证用户日常工作依赖的业务流程。

通过 Webswing 托管，您可以在 Web 浏览器中使用 Java Swing 应用。应用仍在服务器上的 JVM 中执行，用户则通过浏览器操作其界面。用户设备无需安装 Java 运行时或浏览器插件。Webswing 架构概述解释了应用与浏览器之间如何传递界面渲染内容和用户输入。

本指南从现有 Swing 应用的构建文件开始，逐步完成首次浏览器会话，并介绍扩大部署范围前需要测试的内容。配置以 Windows 上的 Webswing 26.1 标准发行包为例。对于其他部署环境，请先阅读安装指南中的对应章节。

Java Swing 如何在浏览器中运行

Webswing 通过 HTML5 显示应用，并将键盘和鼠标输入发送回 Java 进程。Java 在服务器上执行。 因此，浏览器交付保留了应用原有的 Java 实现，并不会将项目转换成 JavaScript，也不会自动重新设计其界面。

第一步准备应用及其依赖

从已经能够在 Webswing 之外正常运行的构建版本开始。将应用 JAR、所需库和配置文件放在一起。记录桌面环境中成功启动应用所用的主类、Java 运行时和启动参数。

为试用选择一项具有代表性的任务，例如打开记录、修改一个值、保存并导出报表。记录预期结果，以及对本地文件、打印机、原生库或外部服务的依赖。这样，配置完成后就有一个明确的流程可供验证。

第二步在本地启动 Webswing

从 Webswing 下载页面获取评估发行包。本示例将其解压到 C:\webswing。安装所选版本支持的 Java 运行时，并对照安装要求进行检查。

在 Windows 上，于解压目录中打开命令提示符，执行以下命令。Windows 启动说明中列出了该脚本名称：

java -version
webswing.bat

在浏览器中打开 http://localhost:8080，使用为该发行包配置的凭据登录。对于未修改的本地评估环境，快速入门指南说明了初始登录方式。这些凭据仅用于本地试用；向其他用户开放服务前，应配置好访问权限。

选择 Manage，打开 Admin Console。如果评估包包含示例应用，可以先启动其中一个，以确认基础安装能够正常启动。

第三步添加并配置 Swing 应用

在 Admin Console 中打开 Applications，选择加号图标，再选择 Create New。输入应用名称和 URL 路径，例如 /myapp，然后提交。快速入门指南也提供向导方式；手动配置有助于逐项了解关键设置。

打开应用的 App Config。根据 Swing 配置说明和配置参考填写以下字段：

字段	填写内容
Launcher Type	Swing 应用选择 Desktop。
Home Folder	用于解析相对 classpath 条目的目录。
JRE Executable 和 Java Version	主机上的 Java 可执行文件及其对应版本。
Class Path	应用 JAR 或类目录，以及所需的库。
Main Class	包含包名的完整入口类名。
Main Arguments	应用需要的参数；如无需求则无需填写。

在文档中的 CelsiusConverter 示例里，JAR 文件为 CelsiusConverter.jar，主类为 learn.CelsiusConverterGUI。如果 JAR 位于 C:/webswing，并使用相对 JAR 文件名，请将该目录设为 Home Folder。实际配置时，将这些示例值替换为您自己的应用信息。

Webswing Admin Console 中 CelsiusConverter 的 Class Path、Desktop 启动器和主类配置。 — *配置示例来自* *Webswing 快速入门指南*。

选择 Apply，然后选择 Enable。打开配置好的路径，例如 http://localhost:8080/myapp。首先确认应用窗口可以正常操作，然后执行第一步选定的代表性任务。

第四步验证关键业务流程

使用具有代表性的测试数据，将浏览器中的结果与桌面环境中的结果进行比较。根据实际情况进行以下检查：

导航与数据：完成整项任务，触发一条校验消息，并检查保存、取消和键盘快捷键是否按预期工作。
文件：测试一次真实导入和导出。Java 应用使用服务器文件系统；文件处理集成通过 JFileChooser 提供浏览器上传和下载。自定义文件流程需单独检查。
打印：生成并检查真实报表。文档中的打印集成会为浏览器生成 PDF。应专门测试特殊打印机及所需的直接打印行为。
会话与负载：测试第二个用户、预期权限和重连行为。在预期并发用户数下重复代表性任务，同时观察响应时间和服务器资源使用情况。