Éditeur

Cette page donne accès à la documentation sur l'éditeur de fichiers XML de configuration.

L'éditeur permet de modifier et/ou visualiser les fichiers de configuration XML qui respectent le DTD JEZXmlConfig.

Comment lancer l'éditeur

Afin de lancer l'éditeur, vous devez inclure les librairies (JAR) suivantes dans votre CLASSPATH :

Ligne de commande pour afficher l'aide sur les paramètres
java net.sourceforge.jezxmlconfig.gui.editor.ConfigEditor -? | -h | -help

Ligne de commande pour lancer l'éditeur

java net.sourceforge.jezxmlconfig.gui.editor.ConfigEditor [ -look ] [ file ]
    look Peut être CrossPlatform, System, Metal, Windows, CDE/Motif, ou le nom complet (avec package absolu) d'une classe qui implémente un look&feel.
D'autres look&feel peuvent être disponible (GTK par exemple) en fonction du JRE et de la plate-forme. Utilisez l'option -? pour plus d'information.
Le look&feel par défaut est System.
    file Un fichier de configuration à éditer (Le fichier est créé s'il n'existe pas).
L'éditeur s'exécutera en mode "lecture seule" si le fichier est protégé en écriture.

Chargement d'un fichier

La boîte de dialogue de chargement d'un fichier permet de demander ou non une validation avec le DTD (Case "XML validation").
Il est aussi possible d'accéder directement au source XML en cochant la case "Text format".
L'utilisateur a ensuite le choix entre éditer le fichier (bouton [Edit]) ou le visualiser sans possibilité d'altération (bouton [View]).
Le bouton [Close] permet de fermer la boîte de dialogue sans rien faire (Annulation du chargement d'un fichier).

Après le chargement, les sections sont affichées dans l'arbre hiérarchique de la partie gauche de l'éditeur, et les paramètres de la section sélectionnée sont automatiquement affichés dans la partie droite de l'éditeur.
Remarque : Si on sélectionne la racine (qui contient le nom du fichier), les constantes générales définies sont affichées de la même façon que pour les paramètres d'une section.

Il est aussi possible de charger une configuration avec JNDI (Option File->JNDI access...).
Dans ce cas, vous devez sélectionner un des noms JNDI affichés qui correspondent aux configurations disponibles dans le fournisseur de service JNDI spécifique à JEZXmlConfig:

Vous pouvez alors éditer la configuration chargée depuis JNDI.
Si vous utilisez l'option File->Save par la suite, la configuration sera mise à jour dans la zone de stockage du fournisseur de service JNDI spécifique à JEZXmlConfig.

Modification des paramètres d'une section

Les paramètres des sections (ainsi que les constantes générales) sont édités à partir de la partie droite de l'éditeur.
Pour afficher les paramètres d'une section, il suffit de la sélectionner dans l'arbre situé à gauche de l'éditeur.

Après modifications, les boutons [Apply] et [Restore] deviennent actifs en bas à droite. Le bouton [Apply] valide les modifications dans la configuration, tandis que le bouton [Restore] remet les paramètres exactement comme ils étaient avant tout changement. Bien sûr, après avoir activé [Apply] il n'est plus possible d'activer [Restore].

Pour modifier simplement la valeur d'un paramètre, il suffit de changer sa valeur dans la partie droite, puis valider la modification avec le bouton [Apply].

Pour ajouter, ou supprimer un paramètre d'une section, il faut utiliser les boutons [Delete all], [Delete] et [Insert].
Vous pouvez changer l'ordre des paramètres avec les boutons , , et .

Si dans la valeur d'un paramètre vous voulez ajouter une référence à une constante ou à une propriété système, vous pouvez directement l'entrer en utilisant le format ${key}.
Les boutons et permettent de faire la même chose en sélectionnant la référence à insérer plutôt que de la taper au clavier. Positionnez d'abord le curseur clavier dans le champ de la valeur à modifier et à l'emplacement où vous voulez insérer une référence puis cliquez sur le bouton désiré.
Ceci est surtout utile pour les propriétés systèmes qui sont souvant nombreuses et dont on ne se rapelle pas toujours la syntaxe exact.

Modification de la structure des sections

Le clic droit de la souris dans l'arbre hiérarchique de la partie gauche fait apparaître un menu contextuel qui contient les commandes nécessaires à la modification de la structure des sections.

Add new subsection...
Ajoute une nouvelle sous-section à la fin de la section courante.

Insert section...
Insère une section juste avant celle qui est sélectionnée.

Rename section...
Renomme la section sélectionnée.

Delete
Supprime la section courante, y compris toutes les sous-sections récursivement. Une confirmation sera demandée.

Copy
Copie la section courante dans le presse-papier, incluant ses sous-sections récursivement.

Cut
Supprime la section courante et la met dans le presse-papier, incluant toutes ses sous-sections récursivement. Cette commande est équivalante à un Copy suivi d'un Delete.

Paste as last subsection
Colle la section du presse-papier à la fin de la section courante.

Paste before
Colle la section du presse-papier juste avant le section courante.

Empty
Supprime le contenu de la section, y compris les paramètres et sous-sections. Une confirmation sera demandée.