跳至主要内容

Setup and Configuration

在 ChatGPT 中打开

将Webswing与webforJ集成涉及两个组件：托管您的Swing应用程序的Webswing服务器，以及您在webforJ应用程序中嵌入的WebswingConnector组件。

先决条件​

在开始之前，请确保您具备以下先决条件：

  • Java桌面应用程序：一个打包为JAR文件的Swing、JavaFX或SWT应用程序
  • Webswing服务器：从webswing.org下载
  • webforJ版本25.10或更高：需要支持WebswingConnector

架构概述​

集成架构包括：

  1. Webswing服务器：运行您的Swing应用程序，捕获GUI渲染并处理用户输入
  2. webforJ应用程序：托管带有嵌入式WebswingConnector的Web应用程序
  3. 浏览器客户端：显示webforJ UI和嵌入的Swing应用程序
端口配置

Webswing和webforJ必须在不同的端口上运行以避免冲突。通常，webforJ和Webswing都运行在端口8080上。您应该更改Webswing端口或webforJ端口。

Webswing服务器设置​

安装和启动​

  1. 从官方网站下载Webswing 官方网页
  2. 将归档文件解压到您希望的位置（例如，/opt/webswing或C:\webswing）
  3. 使用特定于平台的脚本启动服务器：
webswing.sh
  1. 通过访问http://localhost:8080来验证服务器是否正在运行

应用程序配置​

一旦服务器正在运行，通过访问http://localhost:8080/admin进入管理员控制台，添加和配置您的Swing应用程序。

在管理员控制台中配置：

  • 应用程序名称：成为URL路径的一部分（例如，myapp → http://localhost:8080/myapp/）
  • 主类：您的Swing应用程序的入口点
  • 类路径：指向您的应用JAR和依赖项的路径
  • JVM参数：内存设置、系统属性和其他JVM选项
  • 主目录：应用程序的工作目录

配置完成后，您的Swing应用将在http://localhost:8080/[app-name]/可访问。

CORS配置​

在不同端口或域中运行的webforJ应用中嵌入Webswing时，您必须在Webswing中配置跨域资源共享（CORS）。这允许浏览器在您的webforJ页面中加载Webswing内容。

在Webswing管理员控制台中，导航到您应用程序的配置并设置：

  • 允许的来源：添加您webforJ应用的来源（例如，http://localhost:8090或开发时使用*）

此设置对应于Webswing应用程序配置中的allowedCorsOrigins选项。

webforJ集成​

一旦您的Webswing服务器运行并配置了Swing应用程序且启用了CORS，您就可以将其集成到webforJ应用程序中。

添加依赖​

Webswing集成依赖于webforJ的Webswing集成模块，该模块提供了WebswingConnector组件和相关类。 将以下内容添加到您的pom.xml文件中：

<dependency>
  <groupId>com.webforj</groupId>
  <artifactId>webforj-webswing</artifactId>
  <version>${webforj.version}</version>
</dependency>

基本实现​

创建一个视图，通过WebswingConnector嵌入您的Swing应用：

SwingAppView.java
package com.example.views;

import com.webforj.annotation.Route;
import com.webforj.component.Composite;
import com.webforj.component.html.elements.Div;
import com.webforj.component.webswing.WebswingConnector;

@Route
public class SwingAppView extends Composite<Div> {
  private final Div self = getBoundComponent();
  private WebswingConnector connector;

  public SwingAppView() {
    // 使用您的Webswing应用URL初始化连接器
    connector = new WebswingConnector("http://localhost:8080/myapp/");

    // 设置显示尺寸
    connector.setSize("100%", "600px");

    // 添加到视图容器
    self.add(connector);
  }
}

当被添加到DOM时，连接器会自动与Webswing服务器建立连接。Swing应用程序的用户界面随后将在连接器组件内呈现。

配置选项​

WebswingOptions类允许您自定义连接器的行为。默认情况下，连接器在创建时自动启动，并使用标准连接设置。您可以通过创建WebswingOptions实例并将其应用于连接器来修改此行为。

例如，要在使用您webforJ应用程序管理身份验证的生产环境中隐藏注销按钮：

WebswingConnector connector = new WebswingConnector("http://localhost:8080/myapp/");

WebswingOptions options = new WebswingOptions()
  .setDisableLogout(true);  // 隐藏注销按钮

connector.setOptions(options);

或者如果您需要手动控制连接何时启动：

// 创建不自动启动的连接器
WebswingConnector connector = new WebswingConnector(url, false);

// 配置并在准备好时启动
WebswingOptions options = new WebswingOptions();
connector.setOptions(options);
connector.start();

这些选项涵盖了连接管理、身份验证、调试和监控。