Beispiel: Deutsches Fragment für Plug-in "XYZ" schreiben

Die Assistenten und Editoren von PDE, die Plug-ins und Fragmente bearbeiten, sind nahezu identisch. Einige wichtige Unterschiede müssen jedoch beachtet werden.

Zunächst erstellen Sie ein neues Fragmentprojekt.  

Auf der ersten Seite des Assistenten für neue Fragmente geben Sie den Projektnamen com.example.german ein. Klicken Sie auf Weiter, und übernehmen Sie auf der zweiten Seite die Standardwerte (Klicken Sie noch einmal auf Weiter.) Wählen Sie auf der Seite des Fragmentcodegenerators das Optionsfeld für die Erstellung eines Fragments aus einer Schablone aus, und wählen Sie den Assistenten "Fragmentstandardgenerator" aus. Nachdem Sie auf Weiter geklickt haben, sollte die Seite für den einfachen Fragmentinhalt angezeigt werden.

Diese Seite unterscheidet sich etwas vom Plug-in-Assistenten, da sie zwei zusätzliche Felder (für die ID und die Version des Ziel-Plug-ins) enthält. Da Sie ein Fragment für ein spezifisches Plug-in schreiben, können Sie nach Klicken auf die Schaltfläche Durchsuchen den Eintrag "XYZ-Plug-in" in der Gruppe "Arbeitsbereich-Plug-ins" auswählen (natürlich könnten Sie auch einen beliebigen Eintrag unter den externen Plug-ins verwenden).

Seite 'Fragmentbeispiel - Beispielfragmentinhalt'

Sobald das Projekt erstellt wurde, wird der Editor für Fragmentmanifeste geöffnet.

Fragmentbeispiel - Übersicht über Manifeste

Abgesehen von den folgenden Ausnahmen ist der mit dem Editor für Plug-in-Manifeste identisch:

  1. Auf der Seite "Übersicht" wird das Attribut "Klasse" nicht angezeigt. Fragmente haben keine Plug-in-Klasse, weil sie dem Lebenszyklus ihres Ziel-Plug-ins folgen. Stattdessen werden Felder für die ID und die Version des Ziel-Plug-ins angezeigt.
  2. In einem kombinierten Dropdown-Feld können Sie den Plug-in-Verweis genau definieren (perfect, compatible, equivalent usw.).

Als Nächstes wird ein ähnliches Aktionsset wie im Plug-in-Beispiel (in deutscher Sprache) hinzugefügt.

  1. Wechseln Sie im Editor für Fragmentmanifeste auf die Seite "Erweiterungen". Klicken Sie auf Hinzufügen, um den Assistenten für Erweiterungen zu starten.
  2. Wählen Sie die Optionen "Generische Assistenten" und "Schemabasierte Erweiterung" aus. Klicken Sie auf Weiter.
  3. Wählen Sie in der Liste der Erweiterungspunkte den Eintrag "Aktionssets" aus. Klicken Sie auf Fertig stellen.
  4. Wählen Sie das neue Aktionsset aus. Wählen Sie dann im Kontextmenü die Optionen Neu > Aktionsset aus.
  5. Wechseln Sie auf die Eigenschaftenseite, und ändern Sie die Eigenschaft Bezeichnung in "Deutsches Aktionsset".
  6. Wechseln Sie zum Abschnitt "Untergeordnete Elemente des Erweiterungselements", und wählen Sie im Kontextmenü die Optionen Neu > Menü aus.
  7. Ändern Sie die Eigenschaft Bezeichnung für das Menü in "Beispielmenü". Geben Sie für die Eigenschaft ID den Wert "beispielMenu." an.
  8. Wählen Sie das Menüelement erneut aus, und wählen Sie im Kontextmenü die Optionen Neu > Trennzeichen aus. Ändern Sie dessen Namen in den Eigenschaften in "beispielGruppe", und speichern Sie den Wert.
  9. Erstellen Sie ein neues Aktionselement (wie in Schritt 6). Geben Sie für die Eigenschaft Bezeichnung den Wert "Beispielaktion" an. Setzen Sie menubarPath auf den Wert "beispielMenu/beispielGruppe."
  10. Wählen Sie die Eigenschaft class zur Bearbeitung aus, und rufen Sie den Dialog für den Zelleneditor auf. Wählen Sie das Optionsfeld "Neue Klasse generieren" aus.
  11. Durchsuchen Sie den Klassencontainer, und wählen Sie den Ordner "DEUTSCHES Fragment" im Projekt "com.example.german" aus.
  12. Ändern Sie den Klassennamen in "DeutscheBeispielAktion". Klicken Sie auf Fertig stellen.
  13. Wenn der Java-Editor mit der neuen Klasse geöffnet wird, suchen Sie nach der Methode "run", und fügen Sie Folgendes hinzu:
   System.out.println("Hallo, PDE welt!");

Speichern und schließen Sie den Java-Editor und den Editor für Fragmentmanifeste.

Wenn Sie das Fragment über die Schaltfläche "Ausführen" in der Symbolleiste starten, sollte im Laufzeitexemplar der Plattform das Aktionsset "Deutsches Aktionsset" verfügbar sein. (Die Liste der Aktionssets rufen Sie mit den Optionen Fenster > Perspektive anpassen... > Andere auf.) Wenn Sie das Aktionsset aktivieren, sollte das Menü "Beispielmenü" in der Symbolleiste angezeigt werden. Bei Auswahl dieser Menüoption sollte in der Konsole der Wert "Hallo PDE-Welt!" ausgegeben werden. Für die Laufzeitplattform war das deutsche Fragment nicht direkt erkennbar. Die Plug-in-Registrierung hat stattdessen Fragmentverweise so aufgelöst, dass das Aktionsset des Fragments so in der Plattform ausgegeben wurde, als ob es direkt aus dem XYZ-Plug-in stammen würde.

 
Copyright IBM Corporation und Andere 2000, 2003