Esempio: Scrittura di un frammento tedesco per XYZ Plug-in

Gli editor e le procedure guidate PDE che modificano i plug-in e i frammenti sono pressappoco simili.  Tuttavia, è bene avere presente alcune importanti differenze.

Si comincerà creando un nuovo progetto di frammento.  

Sulla prima pagina della procedura guidata Nuovo frammento, immettere il nome del progetto "com.example.german."  Premere Avanti e accettare i valori predefiniti presenti sulla seconda pagina.  Quindi, premere nuovamente Avanti.  Sulla pagina "Generatori di codice del frammento", scegliere il pulsante di opzione per la creazione di un frammento da un modello e selezionare la procedura guidata "Generatore di frammento predefinito".  Dopo aver premuto Avanti, verrà visualizzata la pagina "Contenuto di frammento semplice".

Questa pagina differisce in parte rispetto alla procedura guidata dei plug-in poiché contiene due ulteriori campi: id e versione del plug-in di destinazione. Dato che si sta scrivendo un frammento per un plug-in specifico, è possibile utilizzare il pulsante Sfoglia per selezionare "Plug-in XYZ" dal gruppo "Plug-in dell'area di lavoro" (è anche possibile scegliere uno qualsiasi dei plug-in esterni).

Esempio di frammento - pagina del contenuto del frammento di esempio

Una volta creato il progetto, viene aperto l'editor del manifest del frammento.

Esempio di frammento - panoramica del manifesto

Questo editor è abbastanza simile all'editor del manifest di plug-in, ad eccezione di quanto riportato di seguito:

  1. Nella pagina Panoramica, l'attributo "class" non è più presente.  I frammenti non hanno una classe di plug-in poiché seguono il ciclo di vita del rispettivo plug-in di destinazione.  Invece, vengono visualizzati i campi dell'id e della versione del plug-in di destinazione.
  2. Una casella combinata a discesa consente una definizione precisa del riferimento di plug-in (perfetta, compatibile, equivalente, etc.).

Verrà aggiunta una serie di azioni simili come nel plug-in di esempio, ma questa volta in tedesco.

  1. Passare alla pagina   Estensioni nell'editor del manifest di frammento. Fare clic su Aggiungi per avviare la procedura guidata dell'estensione.
  2. Selezionare "Procedure guidate generiche" e "Estensione basata su schema". Fare clic su Avanti.
  3. Selezionare "Serie di azioni" dall'elenco dei punti di estensione. Fare clic su Fine.
  4. Selezionare la nuova serie di azioni. Selezionare Nuovo > actionSet dal menu di scelta rapida.
  5. Passare al foglio delle proprietà e modificare la proprietà label in "Deutsche Aktionsmenge."
  6. Passare alla sezione "Elementi secondari dell'estensione" e selezionare Nuovo > menu dal menu di scelta rapida.
  7. Modificare la proprietà label del menu in "Beispiel Menu" e la proprietà id in "beispielMenu."
  8. Selezionare nuovamente l'elemento menu e scegliere Nuovo > separatore dal menu di scelta rapida. Modificarne il nome nelle proprietà in "beispielGruppe" e salvarlo.
  9. Creare un nuovo elemento "action" (come al passo 6). Impostare la proprietà label su "Beispiel Aktion." Impostare menubarPath su "beispielMenu/beispielGruppe."
  10. Selezionare per la modifica la proprietà class e visualizzare la finestra dell'editor di cella. Selezionare il pulsante di opzione "Genera una nuova classe".
  11. Ricercare il contenitore di classe e selezionare la cartella "GERMAN Fragment" nel progetto "com.example.german".
  12. Cambiare il nome della classe in "DeutscheBeispielAktion". Fare clic su Fine.
  13. Quando viene aperto l'editor Java con la nuova classe, localizzare il metodo "run" e aggiungere quanto segue:
   System.out.println("Hallo, PDE welt!");

Salvare e chiudere l'editor Java e l'editor del manifest del frammento.

Quando si esegue il frammento utilizzando il pulsante della barra degli strumenti "Esegui", è necessario che l'istanza della piattaforma di run-time presenti la serie di azioni "Deutsche Aktionsmenge" disponibili.  (UtilizzareFinestra>Personalizza prospettiva ...->Altro per ottenere l'elenco della serie di azioni). Quando si attiva la serie di azioni, il menu "Beispiel Menu" deve apparire sulla barra degli strumenti. Quando si seleziona la relativa voce di menu, "Hallo, PDE welt!" dovrebbe essere visibile nella Console. La piattaforma run-time non visualizzava direttamente il frammento Tedesco. Invece, il registro plug-in ha risolto i riferimenti di frammento in modo tale che la serie di azioni di frammento sia visualizzata alla piattaforma come se derivasse direttamente da XYZ Plug-in.

Copyright IBM Corporation and others 2000, 2002