L’éditeur visuel de webforJ

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

craftforJ s’exécute dans votre application en mode développement. Il affiche l’arborescence des composants créée par votre code, vous permet de modifier leurs propriétés en direct et écrit les modifications conservées dans le fichier Java qui les a créés.

Commencer Lire la documentation

Quatre raccourcis couvrent toute la boucle.

Ouvrir ou fermerAltShiftD
Choisir un composantAltShiftC
Examiner les modificationsCmd/CtrlS
Annuler une modificationCmd/CtrlZ

Comment ça marche ?

Il lit votre application. via webforJ lui-même

C’est pourquoi il décrit l’application avec les termes que vous avez utilisés pour l’écrire. L’arborescence répertorie vos composants, les propriétés sont celles que vos composants déclarent, et les routes sont celles enregistrées par votre routeur, avec les règles d’accès que vous y avez annotées.

01
Ouvrir
Cliquez sur le bouton de déclenchement dans votre application ou appuyez sur Alt+Maj+D depuis n’importe où dans celle-ci.
02
Choisir
Appuyez sur Alt+Maj+C, survolez un composant puis cliquez dessus. L’arborescence le sélectionne et la barre latérale affiche ses propriétés.
03
Modifier
Modifiez une propriété. L’application en cours d’exécution se met à jour immédiatement, sans toucher à vos fichiers.
04
Conserver
Examiner la modification sous forme de diff et l’appliquer au fichier Java d’origine.

Présentation des panneaux

Les panneaux, sur une application réelle

Vidéo

1 sur 2

L’arborescence des composants créée par votre Java

L’inspecteur répertorie vos composants, et non le balisage rendu par le navigateur. Un Composite apparaît sous la forme de la classe que vous avez écrite, avec ses enfants dans l’ordre dans lequel webforJ les conserve.

Documentation Inspection des composants

Appuyez sur Alt+Maj+C, puis cliquez sur un élément de la page pour le sélectionner dans l’arborescence.
Modifiez une propriété dans la barre latérale : l’application s’actualise immédiatement.
Remonter d’un composant à la ligne Java qui l’a créé.

VidéoEnregistrer dans la source

Examinez le diff, puis écrivez-le en Java

Chaque propriété que vous modifiez est enregistrée comme modification en attente. Appuyez sur Cmd/Ctrl+S pour les consulter, regroupées par fichier concerné, avec leur ancienne et nouvelle valeur ainsi que le diff du fichier. Rien n’est écrit tant que vous n’avez pas appliqué les modifications.

Documentation Application des modifications

Les modifications en attente sont conservées après le rechargement de la page et un changement de route.
Modifiez l’utilisation pour un seul écran, ou la définition pour tous les écrans qui l’utilisent.
Cmd/Ctrl+Z annule une modification, même si elle a déjà été enregistrée dans vos fichiers.

Vidéo

1 sur 2

Table de routage en direct

L’onglet Routes affiche la table de routage selon la hiérarchie utilisée par le routeur, avec la route active indiquée. Les routes enregistrées dynamiquement apparaissent aux côtés des routes annotées.

Documentation Itinéraires

Accédez à n’importe quelle route de craftforJ. Vos observateurs du cycle de vie s’exécutent comme pour un utilisateur.
Chaque route affiche un badge correspondant à l’annotation de sécurité qui y est déclarée.
Modifiez une règle d’accès et craftforJ insère l’annotation dans la classe de route.

VidéoCommandes de thème

Changer le thème de l’application en temps réel

L’onglet Thème utilise les jetons de conception DWC déjà employés par votre application : une seule modification s’applique à tous les composants qui utilisent ce jeton. Les commandes couvrent la palette, les surfaces, les bordures et les coins, la typographie et l’espacement.

Documentation Thème

Modifiez le mode clair, le mode sombre ou les deux, et basculez l’application de l’un à l’autre.
Commencez avec un préréglage comme App Default ou Portico.
L’enregistrement intègre le thème à votre feuille de style, qui sera fourni avec votre application.

VidéoUne conversation

Un agent qui compile avant même que vous ne le voyiez.

L’assistant est un agent de programmation intégré à votre application en cours d’exécution. Il écrit du Java, soumet chaque modification préparée à un véritable compilateur Java et corrige ses erreurs à partir des diagnostics : le code soumis à votre examen compile donc déjà.

Documentation Assistant IA

Choisissez son niveau d’autonomie : demander avant d’agir, appliquer automatiquement les modifications ou fonctionner de façon autonome.
Utilisez une clé API d’un fournisseur compatible ou un modèle exécuté localement.
Il communique avec votre fournisseur depuis le navigateur, sans relais ni proxy.

Capture d’écranInfos sur l’application

Panneau d’informations sur l’application affichant la version de webforJ, la racine du projet, l’environnement d’exécution Java et le système d’exploitation

Ce qui fait vraiment tourner votre application

Les informations sur l’application indiquent les versions utilisées par l’application, qui ne correspondent pas toujours à ce qu’indique votre pom.xml. Elles couvrent webforJ et BBj Services, l’environnement d’exécution Java, le système d’exploitation et la racine du projet.

Documentation Infos sur l’application

La racine du projet est l’emplacement où craftforJ recherche vos sources.
L’environnement d’exécution Java détermine le niveau de validation des modifications de l’assistant. Une validation complète nécessite un JDK.

Retour à la source

Il modifie le Java, n’en est pas une copie

Prenez un formulaire avec les boutons Enregistrer et Annuler. Sélectionnez Enregistrer, faites un clic droit dessus dans l’arborescence et choisissez Supprimer de la source. La déclaration, le thème, l’écouteur, sa place dans l’appel add() et l’importation de ButtonTheme, qui n’est utilisée nulle part ailleurs, sont supprimés. Annuler reste.

Avant

ContactFormView.java
import com.webforj.component.button.Button;
import com.webforj.component.button.ButtonTheme;
import com.webforj.component.layout.flexlayout.FlexLayout;

public class ContactFormView {
  public ContactFormView(FlexLayout layout) {
    layout.setSpacing("1em");
    Button save = new Button("Save");
    save.setTheme(ButtonTheme.PRIMARY);
    save.onClick(event -> {
      save.setEnabled(false);
    });
    Button cancel = new Button("Cancel");
    layout.add(save, cancel);
  }
}

Après suppression de la source

ContactFormView.java
import com.webforj.component.button.Button;
import com.webforj.component.layout.flexlayout.FlexLayout;

public class ContactFormView {
  public ContactFormView(FlexLayout layout) {
    layout.setSpacing("1em");
    Button cancel = new Button("Cancel");
    layout.add(cancel);
  }
}

Deux paramètres, tous deux obligatoires
craftforJ nécessite webforj.debug et webforj.devtools.craftforj.enabled. Aucun des deux ne fonctionne seul.
Accès local par défaut
Seul un navigateur sur la machine qui exécute l’application peut y accéder, jusqu’à ce que vous indiquiez une autre machine dans hosts-allowed.
Aucun point d’accès HTTP supplémentaire
Il n’ajoute aucun endpoint, servlet ni filtre. Il utilise la connexion déjà établie par votre application.
N’écrit que ce qui compile.
Une suppression du code source n’est enregistrée que si le résultat compile toujours, et les fichiers ne sont jamais supprimés.

Pour commencer

Activez-le en trois étapes

craftforJ est fourni avec webforJ : rien à télécharger séparément. Les projets créés avec startforJ ou à partir d’un archétype webforJ l’ont déjà activé. Lancez l’application et passez directement à l’étape trois.

Ajouter la dépendance

Ajoutez webforj-devtools à votre projet s’il n’y figure pas déjà.

pom.xml
<dependency>
  <groupId>com.webforj</groupId>
  <artifactId>webforj-devtools</artifactId>
  <version>${webforj.version}</version>
</dependency>

2
Activer le mode débogage et craftforJ
Définissez les deux propriétés dans webforj.conf ou dans application.properties pour un projet Spring. craftforJ ne fonctionne que si les deux sont activées.
```
webforj.debug = true
webforj.devtools.craftforj.enabled = true
```
3
Redémarrer, recharger et l’ouvrir.
Ouvrez l’application sur la machine où elle s’exécute. Un bouton de déclenchement apparaît au-dessus de l’application. Cliquez dessus ou appuyez sur AltShiftD depuis n’importe où dans l’application. Le même raccourci ferme craftforJ.
craftforJ flotte au-dessus de votre application par défaut. Faites-le glisser vers un bord pour l’y ancrer, ou placez-le dans sa propre fenêtre ou son propre onglet de navigateur pour l’afficher sur un second écran.

Où aller ensuite ?

Chaque panneau a sa propre page dans la documentation

webforJ est le framework Java full-stack pour les applications web métier : vous créez toute l’application, écrans compris, en Java. craftforJ est fourni avec lui et fonctionne sur l’application que vous exécutez.

L’assistant craftforJ Retour à l’accueil de la documentation

Il lit votre application. via webforJ lui-même

Ouvrir

Choisir

Modifier

Conserver

Les panneaux, sur une application réelle

L’arborescence des composants créée par votre Java

Il modifie le Java, n’en est pas une copie

Deux paramètres, tous deux obligatoires

Accès local par défaut

Aucun point d’accès HTTP supplémentaire

N’écrit que ce qui compile.

Activez-le en trois étapes

Ajouter la dépendance

Activer le mode débogage et craftforJ

Redémarrer, recharger et l’ouvrir.

Chaque panneau a sa propre page dans la documentation