Korzystanie ze schematu punktu rozszerzenia

Punkty rozszerzeń definiowane przez moduły dodatkowe w obszarze roboczym są od razu dostępne dla wszystkich modułów dodatkowych. Gdy dla punktu rozszerzenia utworzono schemat, środowisko PDE może zaoferować pomoc podczas tworzenia nowych rozszerzeń. Pomoc ta obejmuje:

Przykład: Użycie punktu rozszerzenia "Sample Parsers"

Przed próbą użycia zdefiniowanego wcześniej punktu rozszerzenia nadal pozostaje do zdefiniowania oczekiwany interfejs. W tym celu należy zaznaczyć projekt com.example.xyz w nawigatorze i kliknąć przycisk Utwórz interfejs Java, aby utworzyć nowy interfejs Java.Przed kliknięciem przycisku Zakończ należy sprawdzić, czy nazwa pakietu to com.example.xyz, a nazwa interfejsu to IParser.  Należy zmodyfikować interfejs w taki sposób, aby wyglądał następująco:

   package com.example.xyz;

   public interface IParser {
      /**
       * Uruchom analizator w udostępnionym trybie
       */
      public void parse(int mode);
   }

Teraz są już gotowe: punkt rozszerzenia, jego schemat XML i wymagany interfejs. Należy pamiętać o zapisaniu wszystkich otwartych edytorów.  Tym samym spełnione zostały już wszystkie wymagania - moduły dodatkowe mogą wnosić nowe funkcjonalności za pomocą tego punktu rozszerzenia.

  1. Otwórz edytor manifestów dla modułu dodatkowego com.example.xyz.
  2. Przejdź na stronę Rozszerzenia i kliknij kolejno opcje Nowy -> Rozszerzenie.
  3. Wśród dostępnych do wyboru pozycji powinien być widoczny element "com.example.xyz.parsers". Zaznacz go i kliknij przycisk Zakończ.
  4. Zaznacz nowo dodany element "com.example.xyz.parsers" i wywołaj menu Nowy -> parser. (Wcześniej ustalono, że ten punkt rozszerzenia może akceptować dowolną liczbę elementów  "parser").
  5. Zaznacz nowy element parser. W sekcji Szczegóły elementu rozszerzenia powinny być dostępne cztery atrybuty: id, name, class i mode. Zwróć uwagę na krótkie informacje wyświetlane w wierszu statusu dla zaznaczanych atrybutów. Informacje te pochodzą bezpośrednio ze schematu punktu rozszerzenia.
  6. Zmień wartość atrybutu name na "Default Parser". Zmień wartość atrybutu mode na "manual". 
  7. Kliknij odsyłacz hipertekstowy class w sekcji Szczegóły elementu rozszerzenia. Pozwoli to przekonać się, że środowisko PDE jest w niezauważalny sposób zintegrowane z kreatorem Nowa klasa Java z pakietu JDT i wykorzystuje atrybuty zdefiniowane w schemacie do automatycznego zaimplementowania interfejsu IParser. Utwórz klasę z folderem źródłowym "com.example.xyz/src", pakietem "com.example.xyz" i nazwą klasy DefaultParser. Kliknij przycisk Zakończ.
  8. Powinien zostać otwarty edytor Java dla klasy DefaultParser. Zauważ, że klasa ta zaimplementowała odpowiedni interfejs (IParser) oraz że został utworzony szkielet metody "parse".
    Zamknięcie edytora i ponowne kliknięcie odsyłacza hipertekstowego class spowoduje ponowne otwarcie klasy DefaultParser w edytorze. Kreator nowej klasy Java będzie widoczny tylko wtedy, gdy nie będzie można znaleźć klasy podanej w polu tekstowym atrybutu class. W przeciwnym razie kliknięcie odsyłacza spowoduje otwarcie klasy w edytorze.

Jak widać, udostępnienie kompletnego schematu XML dla punktu rozszerzenia jest użyteczne dla wszystkich potencjalnych użytkowników tego punktu, gdyż pozwala środowisku PDE zaoferować asystę i zapobiec błędom.

Opcje ograniczeń wyświetlane w edytorze komórek arkuszy właściwości