Passer au contenu principal

Setup and Configuration

Ouvrir dans ChatGPT

Intégrer Webswing avec webforJ implique deux composants : le serveur Webswing qui héberge votre application Swing, et le composant WebswingConnector dans votre application webforJ qui l'embarque.

Prérequis​

Avant de commencer, assurez-vous d'avoir les prérequis suivants :

  • Application de bureau Java : une application Swing, JavaFX ou SWT empaquetée en tant que fichier JAR
  • Serveur Webswing : à télécharger depuis webswing.org
  • Version webforJ 25.10 ou ultérieure : requise pour la prise en charge de WebswingConnector

Vue d'ensemble de l'architecture​

L'architecture d'intégration se compose de :

  1. Serveur Webswing : exécute votre application Swing, capture le rendu GUI et gère les entrées utilisateur
  2. Application webforJ : héberge votre application web avec le WebswingConnector embarqué
  3. Client navigateur : affiche à la fois l'interface utilisateur de webforJ et l'application Swing intégrée
Configuration des ports

Webswing et webforJ doivent fonctionner sur des ports différents pour éviter les conflits. Les deux webforJ et Webswing fonctionnent généralement sur le port 8080. Vous devriez changer soit le port de Webswing, soit le port de webforJ.

Configuration du serveur Webswing​

Installation et démarrage​

  1. Téléchargez Webswing depuis le site officiel
  2. Extrayez l’archive à l'emplacement de votre choix (par exemple, /opt/webswing ou C:\webswing)
  3. Démarrez le serveur en utilisant les scripts spécifiques à votre plateforme :
webswing.sh
  1. Vérifiez que le serveur fonctionne en accédant à http://localhost:8080

Configuration de l'application​

Une fois le serveur en marche, accédez à la console d'administration à http://localhost:8080/admin pour ajouter et configurer votre application Swing.

Dans la console d'administration, configurez :

  • Nom de l'application : devient une partie du chemin URL (par exemple, myapp → http://localhost:8080/myapp/)
  • Classe principale : le point d'entrée de votre application Swing
  • Classpath : chemin vers votre JAR d'application et ses dépendances
  • Arguments JVM : paramètres de mémoire, propriétés système et autres options JVM
  • Répertoire de travail : répertoire de travail pour l'application

Après la configuration, votre application Swing sera accessible à http://localhost:8080/[nom-de-l-app]/

Configuration CORS​

Lors de l'intégration de Webswing dans une application webforJ fonctionnant sur un port ou un domaine différent, vous devez configurer le partage de ressources Cross-Origin (CORS) dans Webswing. Cela permet au navigateur de charger le contenu Webswing depuis votre page webforJ.

Dans la console d'administration Webswing, accédez à la configuration de votre application et définissez :

  • Origines autorisées : Ajoutez l'origine de votre application webforJ (par exemple, http://localhost:8090 ou * pour le développement)

Ce paramètre correspond à l'option allowedCorsOrigins dans la configuration de l'application Webswing.

Intégration avec webforJ​

Une fois votre serveur Webswing en cours d'exécution avec votre application Swing configurée et CORS activé, vous pouvez l'intégrer dans votre application webforJ.

Ajouter une dépendance​

Ajoutez le module d'intégration Webswing à votre projet webforJ. Cela fournit le composant WebswingConnector et les classes connexes.

<dependency>
    <groupId>com.webforj</groupId>
    <artifactId>webforj-webswing</artifactId>
</dependency>

Implémentation de base​

Créez une vue qui embarque votre application Swing en utilisant le WebswingConnector :

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 WebswingConnector connector;

  public SwingAppView() {
    // Initialiser le connecteur avec l'URL de votre application Webswing
    connector = new WebswingConnector("http://localhost:8080/myapp/");

    // Définir les dimensions d'affichage
    connector.setSize("100%", "600px");

    // Ajouter au conteneur de vue
    getBoundComponent().add(connector);
  }
}

Le connecteur établit automatiquement une connexion au serveur Webswing lorsqu'il est ajouté au DOM. L'interface utilisateur de l'application Swing est ensuite rendue dans le composant connecteur.

Options de configuration​

La classe WebswingOptions vous permet de personnaliser le comportement du connecteur. Par défaut, le connecteur démarre automatiquement lors de sa création et utilise des paramètres de connexion standard. Vous pouvez modifier ce comportement en créant une instance de WebswingOptions et en l'appliquant au connecteur.

Par exemple, pour masquer le bouton de déconnexion dans un environnement de production où vous gérez l'authentification via votre application webforJ :

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

WebswingOptions options = new WebswingOptions()
    .setDisableLogout(true);  // Masquer le bouton de déconnexion

connector.setOptions(options);

Ou si vous avez besoin d'un contrôle manuel sur le moment où la connexion commence :

// Créer le connecteur sans démarrage automatique
WebswingConnector connector = new WebswingConnector(url, false);

// Configurer et démarrer quand prêt
WebswingOptions options = new WebswingOptions();
connector.setOptions(options);
connector.start();

Les options couvrent la gestion des connexions, l'authentification, le débogage et la surveillance.