Introduction

webforJ in six screens. The whole framework, start to finish.

webforJ is the full-stack Java framework for business web apps: you build the whole app, screens included, in Java. This tour walks through it in six short screens, from your first Java class to the AI tooling. It takes about five minutes.

01Ce qu’est webforJ
02Composants et thèmes
03craftforJ
04Données, formulaires et sécurité
05Votre code existant
06Outils d’IA et prochaines étapes

01Qu’est-ce que webforJ ?

Un écran est une classe Java.

webforJ est le framework Java full-stack pour les applications web métier : vous créez toute l’application, écrans compris, en Java.

Une route en fait une page. Placez @Route sur une classe pour qu’elle réponde à cette adresse dans le navigateur.
Les composants sont des champs. Créez-les avec new et gérez les clics avec une lambda.
Java ou Kotlin. Le DSL Kotlin crée le même écran avec les mêmes composants.

En savoir plus : Kotlin DSL

HelloView.java

@Route("/hello")
public class HelloView extends Composite<FlexLayout> {
  private final FlexLayout self = getBoundComponent();
  private TextField name = new TextField("What is your name?");
  private Button greet = new Button("Say hello");

  public HelloView() {
    greet.setTheme(ButtonTheme.PRIMARY)
        .addClickListener(e ->
            Toast.show("Welcome, " + name.getValue() + "!",
                Theme.SUCCESS));
    self.add(name, greet);
  }
}

@Route("hello")
class HelloView : Composite<FlexLayout>() {
  private val self = boundComponent

  init {
    self.apply {
      val name = textField("What is your name?")
      button("Say hello") {
        theme = ButtonTheme.PRIMARY
        onClick {
          Toast.show("Welcome, ${name.text}!", Theme.SUCCESS)
        }
      }
    }
  }
}

localhost:8080/helloAprès un clic

La vue d’exécution affiche un champ de texte intitulé « Quel est votre nom ? », un bouton « Dire bonjour » et, après un clic, une notification de succès indiquant « Bienvenue, Lauren ! ».

02Composants et thèmes

Composants créés pour les applications professionnelles.

Les champs, listes, boîtes de dialogue, téléversements, graphiques, arbres et mises en page sont inclus dans webforJ. Chacun est une classe Java que vous créez dans votre interface.

La création du thème part d’une couleur de base. Définissez la couleur principale : les 19 nuances de la palette sont générées pour chaque composant.

app.css

:root {
  --dwc-color-primary-seed: #6366f1;
}

En savoir plus : Composants

Le composant webforJ ComboBox — ComboBox

Le composant webforJ GoogleCharts — GoogleCharts

Le composant webforJ Terminal — Terminal

03craftforJ

Découvrez l’application que votre Java a créée. Modifiez-le pendant son exécution.

craftforJ est l’éditeur visuel intégré à votre application en mode développement. Il affiche l’arborescence des composants créés par votre code Java, vous permet de modifier leurs propriétés en direct et réécrit dans votre code source Java les modifications que vous conservez.

Inspecter les composants. Parcourez l’arborescence des composants, sélectionnez un composant en cliquant dessus dans la page et modifiez ses propriétés pendant l’exécution de l’application.
Écrire les modifications dans la source. Consultez vos modifications en direct sous forme de diff et appliquez-les au fichier Java d’origine.
L’assistant IA. Un agent de programmation intégré à l’application en cours d’exécution écrit du code Java, le compile et l’applique avec votre approbation.

En savoir plus : craftforJ

craftforJ

04Données, formulaires et sécurité

Formulaires, règles et accès, à côté de votre backend.

Liaison BindingContext associe les champs du formulaire à un bean et vérifie ses règles de validation Jakarta lors de l’enregistrement du formulaire.
Spring Boot. Les vues reçoivent vos services, dépôts et autres beans Spring par injection via le constructeur.
Sécurité. Les annotations telles que @RolesAllowed protègent une route, et les règles sont appliquées avant le rendu de tout composant.

En savoir plus : Vitrine

CustomerFormView.java

public class CustomerFormView extends Composite<FlexLayout> {
  private TextField name = new TextField("Name");
  private TextField email = new TextField("Email");
  private Customer customer = new Customer();

  private BindingContext<Customer> context =
      BindingContext.of(this, Customer.class, true);

  public CustomerFormView() {
    Button save = new Button("Save", ButtonTheme.PRIMARY, e -> {
      ValidationResult result = context.write(customer);
      if (result.isValid()) {
        Toast.show("Saved " + customer.getEmail(), Theme.SUCCESS);
      }
    });

    getBoundComponent().add(name, email, save);
  }
}

public class Customer {

  @NotEmpty(message = "Name cannot be empty")
  private String name;

  @NotEmpty(message = "Email is required")
  @Email(message = "Not a valid email address")
  private String email;

  // getters and setters
}

@Route("/dashboard")
public class DashboardView extends Composite<FlexLayout> {

  public DashboardView(RandomNumberService service) {
    Button roll = new Button("Generate random number");
    roll.setTheme(ButtonTheme.PRIMARY)
        .addClickListener(e ->
            Toast.show("The new random number is "
                + service.nextNumber(), Theme.SUCCESS));

    getBoundComponent().add(roll);
  }
}

05Votre code existant vous accompagne

Apportez le code Vous l’avez déjà.

WebswingConnector intègre une application Swing, JavaFX ou SWT en cours d’exécution dans une vue webforJ, sans avoir à tout réécrire d’un coup.

ElementComposite encapsule un élément HTML personnalisé ou un composant Web dans une classe Java, avec ses propriétés, attributs et événements en Java.

En savoir plus : Webswing

1Aujourd’huiSwing sur ordinateur de bureauDes années de logique métier à l’œuvre chaque jour.
2Étape 1La même application, dans le navigateur Webswing le diffuse dans le navigateur sans modifier le code source.
3À partir de là webforJ, écran par écranRemplacez les écrans Swing par webforJ, un par un.

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);
  }
}

06Outils d’IA et prochaines étapes

Votre assistant IA suit Conventions webforJ.

Une seule installation du plugin IA webforJ fournit à votre assistant de codage le serveur MCP webforJ et les Agent Skills.

Le serveur lui fournit des outils en temps réel. Les compétences lui indiquent quand les utiliser, dans quel ordre et comment vérifier le résultat.

En savoir plus : Outils d’IA

Terminal

claude plugin marketplace add webforj/webforj-ai
claude plugin install webforj@webforj-ai

MCP server

Sélectionnez la bonne version de webforJ.
Rechercher dans la base de connaissances
Générer le squelette d’un nouveau projet webforJ
Générer un thème DWC
Stylisez correctement les composants DWC.
Travailler avec les tokens de design DWC

Compétences de l’agent

webforj-adding-servlets
webforj-building-forms
webforj-creating-components
webforj-handling-timers-and-async
webforj-localizing-apps
webforj-securing-apps
webforj-styling-apps
webforj-upgrading-versions

Visite terminée

C'était toute la pile. Vous êtes prêt à compiler.

Vous pouvez vous considérer comme officieusement certifié : vous avez découvert comment une application webforJ est conçue, du premier écran aux outils d’IA qui vous aident à créer le suivant.

Ce qu’est webforJ
Composants et thèmes
craftforJ
Données, formulaires et sécurité
Votre code existant
Outils d’IA et prochaines étapes