Modernisation de Swing

Du Swing au Web, Un écran à la fois

Votre application Swing, JavaFX ou SWT s’exécute dans un navigateur web sans modifier son code source. Vous créez ensuite de nouveaux écrans avec webforJ et remplacez les anciens à votre rythme. L’équipe Java et le code restent en place.

Suivez le tutoriel Configurer Webswing

Bibliothèques d’interface de bureau : Swing, JavaFX et SWT: 3
Modifications du code source pour l’exécution dans un navigateur: 0

Clients

ClientsSwing
CommandeswebforJ
RapportsSwing

Appli Swing en streaming

Tableau des clients

FichierModifierAfficher

NomÉquipeVille

Hyyan Abo FakherVentesBerlin

Matthew HawkinsAssistanceBoston

Eric HandtkeFinanceHamburg

Ben BrennanVentesDenver

Garrison OsteenAssistanceAustin

Lauren AlamoFinancePhoenix

Modifier le client

NomEric HandtkeÉquipeFinanceVilleHamburg

AnnulerEnregistrer

Boîte de dialogue webforJ

Un double-clic dans le tableau Swing ouvre une boîte de dialogue webforJ au lieu de l’ancienne boîte de dialogue Swing. Les deux s’affichent dans le même onglet du navigateur.

Ce qui reste inchangé

Uniquement les écrans Modifier

webforJ est le framework Java full-stack dédié aux applications web métier : vous créez toute l’application, écrans compris, en Java. Migrer une application Swing revient donc à migrer ses écrans, et tout ce qui les sous-tend est conservé.

Quels changements ?

Les écrans. Vous les déplacez un par un, selon l’ordre qui compte pour votre activité, tandis que le reste de l’application Swing continue de fonctionner dans le même onglet du navigateur.

01
L’équipe
Les personnes qui maintiennent aujourd’hui l’application Swing créent les interfaces web en Java. Pas besoin d’une deuxième équipe ni d’apprendre une chaîne d’outils front-end.
02
Le code
Webswing exécute l’application telle quelle. Le même code continue de fonctionner comme application de bureau et dans le navigateur : vous ne maintenez qu’une seule application, pas deux.
03
La logique
Les classes de domaine, les services et les règles de validation sans rapport avec javax.swing sont appelés directement depuis les nouveaux écrans. Ils ne deviennent pas d’abord des points de terminaison.
04
La chaîne d’outils
Maven, votre IDE, votre débogueur et vos tests existants continuent de s’appliquer.

Le déplacement en trois phases

Suivre le déplacement pas à pas Du bureau au web

Chaque phase apporte un élément visible par les utilisateurs. Choisissez une phase pour voir l’écran correspondant et le code qui le fait fonctionner.

Tableau des clients

FichierModifierAfficher

NomÉquipeVille

Hyyan Abo FakherVentesBerlin

Matthew HawkinsAssistanceBoston

Eric HandtkeFinanceHamburg

Ben BrennanVentesDenver

Garrison OsteenAssistanceAustin

Lauren AlamoFinancePhoenix

Lancer l’application de bureau dans le navigateur

Webswing exécute votre application Swing, JavaFX ou SWT sur le serveur et diffuse son interface dans le navigateur sous forme de canevas HTML5. Les entrées de la souris et du clavier sont transmises à l’application réelle. Le code source reste inchangé.

Intégrez-le dans une vue webforJ avec WebswingConnector. Le connecteur se connecte au serveur Webswing lorsqu’il est ajouté à la page.

SwingAppView.java

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

  public SwingAppView() {
    // Initialize the connector with your Webswing application URL
    connector = new WebswingConnector("http://localhost:8080/myapp/");

    // Set the display dimensions
    connector.setSize("100%", "600px");

    // Add to the view container
    self.add(connector);
  }
}

Clients

ClientsSwing
CommandeswebforJ
RapportsSwing

WebswingConnector

Tableau des clients

FichierModifierAfficher

NomÉquipeVille

Hyyan Abo FakherVentesBerlin

Matthew HawkinsAssistanceBoston

Eric HandtkeFinanceHamburg

Ben BrennanVentesDenver

Garrison OsteenAssistanceAustin

Lauren AlamoFinancePhoenix

Modifier le client

NomEric HandtkeÉquipeFinanceVilleHamburg

AnnulerEnregistrer

webforJ

Créez de nouveaux écrans autour de celui-ci.

Les nouveaux écrans sont développés en webforJ et cohabitent avec l’application intégrée. Les deux côtés s’échangent des actions : un clic dans Swing peut ouvrir un formulaire web, et une sauvegarde sur le web met à jour le tableau Swing. Les utilisateurs travaillent dans les anciens et les nouveaux écrans dans le même onglet du navigateur.

Swing signale un double-clic sous le nom select-customer. webforJ ouvre son propre formulaire et renvoie update-customer à l’enregistrement.

CustomerTableView.java

connector.onAction(event -> {
  switch (event.getActionName()) {
    case "select-customer":
      event.getActionData().ifPresent(data -> {
        JsonObject customer = JsonParser.parseString(data).getAsJsonObject();
        CustomerForm dialog = new CustomerForm(customer);
        self.add(dialog);
        dialog.onSave(() -> {
          Gson gson = new Gson();
          connector.performAction("update-customer", gson.toJson(customer));
        });
      });
      break;
  }
});

Clients

ClientswebforJ
CommandeswebforJ
RapportswebforJ

NomÉquipeVille

Hyyan Abo FakherVentesBerlin

Matthew HawkinsAssistanceBoston

Eric HandtkeFinanceHamburg

Ben BrennanVentesDenver

Garrison OsteenAssistanceAustin

Lauren AlamoFinancePhoenix

Modifier le client

NomEric HandtkeÉquipeFinanceVilleHamburg

AnnulerEnregistrer

Retirer le client de bureau

Remplacez les écrans Swing un par un, selon les priorités de votre entreprise. Lorsqu’un écran dispose d’un équivalent webforJ, supprimez ses actions. Une fois le dernier remplacé, la couche Webswing et le client de bureau disparaissent.

Vous pouvez vous arrêter après n’importe quelle phase et avoir tout de même obtenu quelque chose. La phase 2 peut durer aussi longtemps que le budget le permet.

Qu’est-ce qui s’exécute ?: Une application Java dans le navigateur, chaque écran développé avec webforJ.
Qu'est-ce qui va ?: Le serveur Webswing, l’interface de bureau diffusée en continu et le client installé.
Ce qui reste: Vos classes de domaine, services et règles de validation, accessibles depuis les nouveaux écrans via des méthodes Java.

Phase 1 sur 3

Communication bidirectionnelle

Anciens et nouveaux écrans Parler entre eux

Un message est une action : un nom, une charge utile textuelle facultative et une charge utile binaire facultative. Le nom est libre. Les deux extrémités étant en Java pur, personne n’a besoin d’écrire de script pour le navigateur.

Swing annonce

Un double-clic envoie select-customer avec la ligne au format JSON. Sur ordinateur, le même clic ouvre toujours la boîte de dialogue Swing.

Application.java (Swing)

private void handleDoubleClick(MouseEvent e) {
  int row = table.rowAtPoint(e.getPoint());
  if (row >= 0 && row < customers.size()) {
    Customer customer = customers.get(row);

    if (isWebswing) {
      api.sendActionEvent("select-customer", gson.toJson(customer), null);
    } else {
      showEditDialog(customer);
    }
  }
}

CustomerBridgeView.java (webforJ)

connector.onAction(e -> {
  switch (e.getActionName()) {
    case "select-customer" -> e.getActionData().ifPresent(this::openEditor);
    case "export-ready" -> e.getActionBinaryData()
        .ifPresent(d -> status.setText("Got " + d.length() + " characters"));
    default -> { }
  }
});

Réponses de webforJ

Lors de l’enregistrement, le formulaire web renvoie update-customer et l’application Swing actualise son tableau. Aucun des deux ne fait appel aux mécanismes internes de l’autre.

Application.java (Swing)

private void setupWebswingListeners() {
  api.addBrowserActionListener(event -> {
    if ("update-customer".equals(event.getActionName())) {
      Customer updated = gson.fromJson(event.getData(), Customer.class);
      updateCustomer(updated);
    }
  });
}

CustomerTableView.java (webforJ)

dialog.onSave(() -> {
  // Send updated customer back to Swing
  connector.performAction("update-customer", gson.toJson(customer));
});

Envoyer des commandes à Swing

performAction() envoie un nom seul ou accompagné de données. L’application Swing détermine la signification de chaque nom.

Envoi d’actions

// Trigger a refresh in the Swing application from webforJ
connector.performAction("refresh");

// Send a command with data from webforJ
connector.performAction("selectRecord", "12345");

Savoir quand Swing est prêt

onInitialize est appelé lorsque la connexion est prête. onStart est appelé lorsque l’application Swing est entièrement chargée. Envoyez votre première action depuis onStart.

Événements du cycle de vie

connector.onInitialize(e -> status.setText("Connected"));
connector.onStart(e -> status.setText("Swing app running"));

Porter avec un assistant IA

Laissez un assistant le porter, écran par écran

Passer d’un écran à l’autre est une tâche répétitive, idéale pour un assistant de programmation IA. Le plug-in IA webforJ le connecte au serveur MCP webforJ et aux Agent Skills, des workflows structurés qui lui indiquent quand utiliser ces outils, dans quel ordre et comment valider le résultat.

Installer le plug-in d’IA En savoir plus sur les compétences des agents

1
Donnez-lui un écran Swing.
Demandez l’équivalent webforJ qui appelle vos services existants.
2
Cela vérifie l’API réelle.
Le serveur MCP consulte à la demande la documentation et les détails de l’API de webforJ, plutôt que de deviner.
3
Vous relisez et testez
Comparez le comportement avec la version Swing d’origine, puis passez à l’écran suivant.

Comment démarrer

À partir d’un fichier JAR vers une page dans le navigateur

Vous avez besoin d’une application Swing, JavaFX ou SWT empaquetée dans un fichier JAR, du serveur Webswing et de webforJ 25.10 ou version ultérieure.

1
Télécharger et lancer Webswing
Téléchargez Webswing, extrayez l’archive, puis démarrez le serveur avec le script correspondant à votre plateforme. Il est accessible à l’adresse http://localhost:8080.
```
webswing.sh
```
2
Enregistrez votre application
Dans la console d’administration de http://localhost:8080/admin, définissez le nom de l’application, la classe principale, le classpath, les arguments JVM et le répertoire de base. L’application est ensuite accessible à l’adresse http://localhost:8080/[app-name]/.
CORS
Ajoutez l’origine de votre application webforJ aux origines autorisées, par exemple http://localhost:8090.
Ports
Les deux utilisent généralement le port 8080. Modifiez-en un pour éviter tout conflit.

Ajouter la dépendance

Le module webforj-webswing fournit WebswingConnector et les classes associées.

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

4
Intégrer et configurer
Ajoutez un WebswingConnector à une vue, comme lors de la phase 1. WebswingOptions modifie son comportement, par exemple en masquant le bouton de déconnexion lorsque votre application webforJ gère la connexion.
```
WebswingConnector connector = new WebswingConnector("http://localhost:8080/myapp/");

WebswingOptions options = new WebswingOptions()
  .setDisableLogout(true);  // Hide the logout button

connector.setOptions(options);
```

Choisissez votre Premier écran

Commencez par une simple liste et un formulaire de modification. Intégrez l’application, migrez cet écran vers webforJ et voyez comment il fonctionne aux côtés du reste.

Uniquement les écrans Modifier

L’équipe

Le code

La logique

La chaîne d’outils

Suivre le déplacement pas à pas Du bureau au web

Lancer l’application de bureau dans le navigateur

Anciens et nouveaux écrans Parler entre eux

Swing annonce

Réponses de webforJ

Envoyer des commandes à Swing

Savoir quand Swing est prêt

Laissez un assistant le porter, écran par écran

À partir d’un fichier JAR vers une page dans le navigateur

Télécharger et lancer Webswing

Enregistrez votre application

Ajouter la dépendance

Intégrer et configurer

Choisissez votre Premier écran