Utilisation du schéma des points d'extension
Les points d'extension définis par les plug-in de l'espace de travail sont disponibles pour votre plug-in et d'autres plug-in. Si un schéma de points d'extension a été défini pour le plug-in, PDE peut vous assister dans la création d'extensions.
Cette assistance comprend les opérations suivantes :
- Fournir des choix pour le menu contextuel Nouveau de sorte que seuls des éléments enfants valides puissent être définis dans l'extension
- Fournir des informations d'attribut pour la feuille de propriétés de sorte que seuls des attributs valides puissent être définis
- Fournir des éditeurs de propriétés d'attribut correspondant aux types d'attribut (booléen, chaîne et énumération)
- Assurer la prise en charge de types d'attributs spéciaux ("java" et "ressource")
- Utiliser la ligne d'état pour afficher la première phrase de l'extrait de documentation pour les attributs lorsqu'ils sont sélectionnés dans la feuille de propriétés
Exemple : Utilisation du point d'extension "Analyseurs"
Avant de pouvoir utiliser le point d'extension défini précédemment, nous devons encore définir l'interface attendue. Pour cela, sélectionnez le projet com.example.xyz dans le navigateur, puis cliquez sur le bouton "Créer une interface Java". Avant de cliquer sur vue Console, vérifiez que le package s'appelle com.example.xyz et l'interface IParser. Editez l'interface pour qu'elle ressemble à ceci :
package com.example.xyz;
public interface IParser {
/**
* Exécuter l'analyseur dans le mode indiqué
*/
public void parse(int mode);
}
Nous avons à présent le point d'extension, un schéma XML qui lui est associé et l'interface requise. Enregistrez tous les éditeurs ouverts. Tout est prêt pour que votre plug-in ou d'autres plug-in contribuent au point d'extension.
- Ouvrez l'éditeur de manifeste pour le plug-in com.example.xyz.
- Basculez dans la page Extensions, puis cliquez sur Nouveau->Extension créée en fonction du schéma.
- Le choix "Analyseurs" doit être proposé. Sélectionnez-le et cliquez sur vue Console.
- Sélectionnez le nouvel élément "Analyseurs" et ouvrez le menu contextuel Nouveau->parser. (Nous avons indiqué que le point d'extension pouvait accepter un nombre quelconque d'éléments "parser".)
- Sélectionnez le nouvel élément, puis allez dans la vue Propriétés. Elle doit comporter quatre attributs : id, name, class et mode. Notez que, lorsque vous sélectionnez un attribut, le descriptif qui lui est associé apparaît dans la ligne d'état. L'information est directement extraite du schéma des points d'extension.
- Changez le nom (name) en "Analyseur par défaut". Changez le mode en "manual".
- Sélectionnez l'attribut class. Cette propriété n'est pas modifiable directement. Ouvrez la boîte de dialogue des propriétés.
- Créez une classe. Sélectionnez "Plug-in XYZ" comme dossier source, com.example.xyz comme package, et DefaultParser comme nom de la classe.
Cliquez sur vue Console.
- La classe DefaultParser doit s'afficher dans l'éditeur Java. Notez qu'elle a implémenté l'interface adéquate (IParser) et comporte déjà l'implémentation raccord de la méthode "parse".
Comme vous pouvez le constater, quand vous fournissez un schéma XML complet pour le point d'extension, il active les fonctions PDE d'assistance pour guider les utilisateurs dans leurs procédures et les empêcher de faire des erreurs.
