Przykład: Tworzenie fragmentu German Fragment dla modułu dodatkowego XYZ Plug-in

Istnieje duże podobieństwo między kreatorami i edytorami manipulującymi modułami dodatkowymi i fragmentami w środowisku PDE.  Trzeba jednak zdawać sobie sprawę z pewnych istotnych różnic.

Zaczniemy od utworzenia nowego projektu fragmentu.  

Na pierwszej stronie kreatora Nowy projekt fragmentu wpisz nazwę projektu "com.example.german".  Zaakceptuj wartości domyślne i kliknij przycisk Dalej.

Strona Treść fragmentu zawiera trzy dodatkowe pola w stosunku do kreatora modułu dodatkowego: identyfikator modułu dodatkowego hosta, wersja nadrzędnego modułu dodatkowego i reguła dopasowania wersji.

Ponieważ pisany fragment dotyczy konkretnego modułu dodatkowego, można użyć przycisku Przeglądaj, aby wybrać moduł dodatkowy "com.example.xyz" w oknie dialogowym wyboru modułu dodatkowego. W tym oknie dialogowym można także wybrać dowolny zewnętrzny moduł dodatkowy.

Przykład fragmentu - strona treści przykładowego fragmentu

Po utworzeniu projektu zostaje otwarty edytor manifestów fragmentów.

Przykład fragmentu - przegląd manifestu

W przeciwieństwie do modułu dodatkowego fragment nie ma klasy modułu dodatkowego, ponieważ przyjmuje on cykl życia swojego modułu dodatkowego hosta.

Teraz zostanie dodany podobny zestaw akcji, jak w przykładzie modułu dodatkowego, ale tym razem w języku niemieckim.

  1. Przejdź na stronę Rozszerzenia w edytorze manifestów fragmentów. Kliknij przycisk Dodaj, aby uruchomić kreatora rozszerzeń.
  2. Z listy punktów rozszerzeń wybierz pozycję "org.eclipse.ui.actionSets". Kliknij przycisk Zakończ.
  3. Wybierz nowy zestaw akcji. Wybierz kolejno opcje: Nowy -> actionSet z menu wywoływanego.
  4. W sekcji Szczegóły elementu rozszerzenia zmień właściwość label na "Deutsche Aktionsmenge".
  5. W sekcji Wszystkie rozszerzenia kliknij prawym przyciskiem myszy nowy zestaw akcji i wybierz kolejno opcje Nowy -> menu z menu wywoływanego.
  6. Zmień właściwość label dla menu na "Beispiel Menu" i właściwość id na "beispielMenu".
  7. Ponownie zaznacz element menu i wybierz kolejno opcje Nowy -> separator z menu wywoływanego. Zmień jego nazwę na "beispielGruppe" i zapisz go.
  8. Utwórz nowy element "action" (podobnie jak w kroku 6). Zmień właściwość label na "Beispiel Aktion.", a właściwość menubarPath na "beispielMenu/beispielGruppe."
  9. Kliknij odsyłacz hipertekstowy właściwości class, aby wygenerować nową klasę dla tej akcji. Użyj nazwy folderu źródłowego "com.example.german/src", nazwę pakietu pozostaw pustą (zostanie użyty pakiet domyślny). Zmień nazwę klasy na "DeutscheBeispielAktion". Kliknij przycisk Zakończ.
  10. Po otwarciu edytora Java z nową klasą znajdź metodę "run" i dodaj następującą instrukcję:

    System.out.println("Hallo, PDE welt!");

  11. Zapisz zmiany i zamknij edytor Java i edytor manifestów fragmentów.

Po uruchomieniu fragmentu przy użyciu przycisku paska narzędzi "Uruchom" w wykonawczej instancji platformy powinien być dostępny zestaw akcji "Deutsche Aktionsmenge".  (Użyj opcji Okno -> Dostosuj perspektywę -> Inne, aby wyświetlić listę zestawów akcji). Po aktywowaniu tego zestawu akcji na pasku narzędzi powinno zostać wyświetlone menu "Beispiel Menu". Po wybraniu opcji z tego menu w konsoli powinien zostać wyświetlony tekst "Hallo, PDE welt!". Fragment German nie jest bezpośrednio widoczny dla platformy wykonawczej. Ale rejestr modułów dodatkowych rozwiązał odwołania do fragmentu w taki sposób, że zestaw akcji fragmentu wyglądał dla platformy tak, jak gdyby pochodził bezpośrednio z modułu dodatkowego XYZ Plug-in.