É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 :
- JEZXmlConfig.jar
- JEZXmlConfigCtx.jar
- JEZXmlConfigEditor.jar
- Un parser XML (Xerces par exemple)
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.