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:
- Udostępnienie opcji w menu wywoływanym Nowy, dzięki którym będą
dodawane tylko poprawne elementy potomne.
- Udostępnienie informacji o atrybutach na arkuszu właściwości,
dzięki czemu ustawiane będą tylko poprawne atrybuty.
- Udostępnienie edytorów właściwości atrybutów odpowiednich do typów
atrybutów (boolean, string i enumeration).
- Udostępnienie dodatkowej obsługi dla specjalnych typów atrybutów ("java"
i "resource").
- Wyświetlanie w wierszu statusu pierwszego zdania fragmentu kodu
dokumentacji dla atrybutów zaznaczanych w arkuszu właściwości.
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
, 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.
- Otwórz edytor manifestów dla modułu dodatkowego com.example.xyz.
- Przejdź na stronę Rozszerzenia i kliknij kolejno opcje Nowy -> Rozszerzenie.
- Wśród dostępnych do wyboru pozycji powinien być widoczny element
"com.example.xyz.parsers". Zaznacz go i kliknij przycisk
Zakończ.
- 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").
- 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.
- Zmień wartość atrybutu name na "Default Parser". Zmień
wartość atrybutu mode na "manual".
- 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.
- 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.
