Vous pouvez utiliser l'éditeur du schéma des points d'extension de deux façons : pour créer un point d'extension ou pour ouvrir un schéma des points d'extension existant. Par convention, tout nouveau schéma se voit attribuer le nom de l'id du point d'extension, ainsi que l'extension .exsd. Il est placé dans le répertoire schema de l'arborescence des plug-in.
Lors de la création d'un point d'extension dans PDE, le fichier de schéma initial est également créé, et l'éditeur de schéma s'ouvre en modification. Vous pouvez définir le schéma à ce moment-là ou le fermer pour l'éditer ultérieurement. La création d'un schéma des points d'extension complet permet à PDE de proposer une assistance automatisée aux utilisateurs du point d'extension.
L'éditeur de schémas PDE s'appuie sur les mêmes concepts que l'éditeur de manifeste de plug-in. Il comporte deux pages de formulaire et une page source. Comme le schéma XML est prolixe et peut être difficile à lire dans sa forme source, vous devez passer par les pages de formulaire pour effectuer la plupart des modifications. La page source est utile pour la lecture du code source ainsi obtenu.
Précédemment, nous avons créé le point d'extension "Analyseurs" et le schéma initial. Nous pouvons à présent ouvrir le schéma résidant dans le dossier schema du projet, puis cliquer deux fois sur le fichier parsers.exsd. L'éditeur de schémas s'exécute.
Nous allons :
Un schéma de point d'extensions commence par la déclaration de l'élément "extension". Nous allons ajouter un nouvel élément XML appelé "parser".
L'éditeur de schémas doit alors ressembler à ceci :
Nous allons à présent ajouter un attribut acceptant des valeurs d'une liste discrète de choix. Ceci signifie que nous devons créer une restriction d'énumération du type de base string. En outre, nous allons définir une valeur par défaut pour l'attribut.
La boîte de dialogue doit ressembler à ceci :
Après avoir refermé la boîte de dialogue, changez l'attribut "use" en "default", et l'attribut "value" en "always". Vous définissez ainsi la valeur par défaut. Notez que la ligne d'état affiche un message d'erreur lors de la saisie de la valeur, car les valeurs valides se résument alors à trois choix d'énumération. A la fin de la saisie, le message d'erreur doit disparaître, car "always" est une valeur valide.
Nous devons à présent définir la grammaire. Notre objectif est d'indiquer que l'élément "extension" peut posséder autant d'éléments "parser" enfants que nécessaire.
Une fois la grammaire définie, l'approximation DTD figurant sous la section grammaire indique à quoi doit ressembler la grammaire de l'élément dans la DTD. Ces informations permettent d'aider les développeurs qui sont plus à l'aise avec les DTD qu'avec les schémas XML.
Maintenant que nous avons défini des éléments, des attributs et une grammaire valides, nous allons fournir un certain nombre d'informations sur le point d'extension. On distingue les deux types d'extraits de documentation de schéma suivants :
Le premier type d'extrait est fourni dans la page de définition du manifeste de schéma. Durant la sélection des éléments et des attributs, vous avez la possibilité d'ajouter de courts descriptifs dans la section "Description". Le format attendu est de type HTML brut (comme avec Javadoc) et le texte sera copié tel quel dans le document de référence final.
Saisissez à présent un court descriptif du point d'extension lui-même. Pour cela, affichez la page Documentation :
L'exemple ci-dessous illustre la syntaxe du point d'extension : <p> <pre> <extension point="com.example.xyz.parsers"> <parser id="com.example.xyz.parser1" name="Analyseur syntaxique 1" class="com.example.xyz.SampleParser1"> </parser> </extension> </pre> </p>
Cliquez sur Appliquer.
Remarque : Un certain de points importants sont à prendre en compte lors de la définition d'exemples. En principe, PDE traite le texte fourni comme du code HTML brut sans respecter les sauts de ligne et les espaces d'une longueur supérieure à un caractère (c'est-à-dire les espaces blancs non significatifs). Ce comportement convient à du texte standard mais se révèle ennuyeux avec des exemples, dans lesquels l'espacement horizontal et vertical est important pour la disposition du texte. PDE offre un compromis : s'il détecte la balise HTML <pre>, il considère le contenu en l'état (en préservant tous les caractères) jusqu'à la balise de fermeture </pre> suivante. Ceci explique pourquoi nous pouvons fournir un exemple tel que le précédent en étant certains que sa disposition ne sera pas modifiée dans le document de référence final.
Vous avez pu également noter que, à mesure de la saisie de la documentation, le pictogramme "stylo" est associé à un nombre croissant d'éléments dans la vue de l'aperçu de l'éditeur. Le pictogramme indique que ces éléments possèdent du texte et constitue un moyen rapide de vérifier si les éléments sont correctement documentés.
Vous pouvez ensuite consulter la documentation de référence, accessible de deux manières. Pendant toute votre session de travail, vous pouvez visualiser le document de référence en sélectionnant Aperçu du document de référence dans le menu en incrustation. Vous pouvez aussi définir des préférences PDE (Préférences>Développement de plug-in>Compilateurs, sous l'onglet Schéma) pour créer automatiquement une documentation de référence sur chaque modification de fichier de schéma. Quelle que soit la méthode employée pour le créer, le document obtenu pour cet exemple devrait se présenter ainsi.