Utilizzo dello schema di punti di estensione
I punti di estensione definiti dai plugin nello spazio di lavoro dell'utente sono subito disponibili per il plugin in uso e per altri plugin. Se un punto di estensione è stato definito, il PDE potrà fornire l'assistenza durante la creazione di nuove estensioni.
L'assistenza comprende:
- Opzioni del menu di scelta rapida Nuovo che consentono di aggiungere solo elementi secondari validi
- Informazioni su attributi per il foglio delle proprietà che consentono di impostare solo attributi validi
- Editor delle proprietà degli attributi corretti che corrispondono ai tipi dell'attributo (boolean, string e enumeration).
- Supporto aggiuntivo per tipi di attributo speciali ("java" e "resource").
- Utilizzo della riga di stato per visualizzare la prima frase del frammento di documentazione relativa agli attributi selezionati nel foglio delle proprietà.
Esempio: utilizzo del punto di estensione "Sample Parsers"
Prima di utilizzare il punto di estensione definito in precedenza, è necessario definire
l'interfaccia prevista. Selezionare il progetto com.example.xyz in Selezione e premere il pulsante della barra degli strumenti
per creare una nuova interfaccia Java.
Impostare il nome del pacchetto su com.example.xyz e il nome dell'interfaccia su IParser prima di premere Fine. Modificare l'interfaccia affinché si presenti in questo modo:
package com.example.xyz;
public interface IParser {
/**
* Run the parser using the provided mode
*/
public void parse(int mode);
}
A questo punto si dispone del punto di estensione, di uno schema XML e dell'interfaccia richiesta. Salvare tutti gli editor aperti. Il plugin creato e gli altri plugin possono ora contribuire al punto di estensione.
- Aprire l'editor del manifest per il plugin com.example.xyz.
- Passare alla pagina Estensioni e premere Nuovo > Estensione.
- La scelta "com.example.xyz.parsers" dovrebbe essere disponibile. Selezionarla e premere Fine.
- Selezionare il nuovo elemento aggiunto "com.example.xyz.parsers" e aprire il menu Nuovo > Programma di analisi. È stato specificato che il punto di estensione potrà accettare un numero qualsiasi di
elementi "parser".
- Selezionare il nuovo elemento del programma di analisi. La sezione Dettagli dell'elemento estensione dovrebbe mostrare quattro attributi: id, name, class e mode. Nella riga di stato sono visualizzate brevi informazioni
relative agli attributi che vengono selezionati. Tali informazioni provengono direttamente
dallo schema del punto di estensione.
- Modificare name in "Default Parser" e mode in
"manual."
- Fare clic sul collegamento ipertestuale class nella sezione Dettagli dell'elemento estensione. In questo modo si noterà che il PDE è integrato con la procedura guidata JDT "Nuova classe Java" e utilizza gli attributi di schema per implementare automaticamente l'interfaccia IParser.
Creare la classe con "com.example.xyz/src" come cartella di origine, "com.example.xyz" come pacchetto e DefaultParser come nome classe.
Scegliere Fine.
- Nell'editor Java viene visualizzata la classe DefaultParser. Notare l'implementazione della
corretta interfaccia (IParser) e la presenza dell'implementazione stub del metodo "parse".
Si noti che se si chiude l'editor e si fa clic sul collegamento ipertestuale class, l'editor riaprirà la classe DefaultParser. La procedura guidata "Nuova classe Java" verrà visualizzata solo quando la classe specificata nel campo di testo dell'attributo classe non viene trovata; in caso contrario, il collegamento aprirà la classe in un editor.
Come si può vedere, quando si fornisce uno schema XML completo per il proprio punto di estensione,
tutti i potenziali utenti potranno essere assistiti dal PDE ed evitare il verificarsi di errori.
