Použití schématu bodu rozšíření
Body rozšíření definované moduly plug-in v pracovním prostoru jsou snadno dostupné vašemu vlastnímu modulu plug-in a dalším modulům plug-in. Jestliže je definováno schéma bodu rozšíření, může prostředí PDE poskytovat pomoc při vytváření nových rozšíření.
Tato pomoc obsahuje:
- Poskytování voleb rozevírací nabídky Nový, takže je možné přidat pouze platné podřízené prvky.
- Poskytování informací o atributu listu vlastností, takže je možné nastavit pouze platné atributy.
- Poskytování správných editorů vlastností atributů, které odpovídají typům atributů (logický, řetězec a výčet).
- Poskytování další podpory pro zvláštní typy atributů ("java"
a "prostředek").
- Použití stavového řádku pro zobrazení první věty úseku dokumentace, je-li tato možnost nastavena v listu vlastností.
Příklad: Použití bodu rozšíření "Ukázkový syntaktický analyzátor"
Před pokusem o použití bodu rozšíření, který jste definovali dříve, je třeba definovat očekávané rozhraní. V Navigátoru vyberte projekt com.ukazka.xyz, klepněte na tlačítko panelu nástrojů
a vytvořte nové rozhraní v jazyce Java.Ujistěte se, že jste nastavili název balíčku na com.ukazka.xyz a název rozhraní na IParser, a potom klepněte na tlačítko Další. Upravte rozhraní tak, aby vypadalo takto:
package com.ukazka.xyz;
public interface IParser {
/**
* Spustí syntaktický analyzátor pomocí zadaného režimu.
*/
public void parse(int mode);
}
Nyní máte bod rozšíření, schéma XML a požadované rozhraní. Ujistěte se, že jste uložili všechny otevřené editory. Nyní je vše připraveno a vlastní modul plug-in nebo jiné moduly plug-in mohou přidat informace k bodu rozšíření.
- Otevřete editor manifestu pro modul plug-in com.ukazka.xyz.
- Přepněte na stránku Rozšíření a klepněte na položky Nové-> Rozšíření.
- Jako volba by měla být přístupná položka "com.ukazka.xyz.parsers". Vyberte ji a klepněte na tlačítko Dokončit.
- Vyberte nově přidaný prvek "com.ukazka.xyz.parsers" a klepněte na nabídku Nový->syntaktický analyzátor. (Zadali jste, že bod rozšíření může obsahovat libovolný počet prvků "syntaktický analyzátor".)
- Vyberte nový prvek syntaktického analyzátoru. V části Podrobnosti prvku rozšíření by měly být zobrazeny čtyři atributy: ID, název, třída a režim. Všimněte si, jak stavový řádek zobrazuje krátké informace o atributech, které vybíráte. Tyto informace pocházejí přímo ze schématu bodu rozšíření.
- Změňte název na "Výchozí syntaktický analyzátor". Změňte režim na "ruční".
- Klepněte na hypertextový odkaz třída v sekci Podrobnosti prvku rozšíření. Zde uvidíte, jak se prostředí PDE bezproblémově integruje s průvodcem novou třídou Java nástrojů JDT a využívá atributů schématu k automatické implementaci rozhraní IParser. Vytvořte třídu se zdrojovou složkou "com.ukazka.xyz/src", s balíčkem "com.ukazka.xyz" a názvem třídy DefaultParser. Stiskněte Dokončit.
- Nyní by měla být v editoru prostředí Java otevřena třída DefaultParser. Všimněte si, jak bylo implementováno správné rozhraní (IParser) a že třída již obsahuje blokovou implementaci metody "parse".
Pokud zavřete editor a klepnete znovu na hypertextový odkaz třída, editor znovu otevře třídu DefaultParser. Průvodce novou třídou Java se zobrazí pouze, pokud není možné nalézt třídu zadanou v textovém poli atributu třídy. V opačném případě otevře odkaz třídu v editoru.
Jestliže poskytnete úplné schéma XML pro bod rozšíření, usnadníte všem potenciálním uživatelům práci, protože jim prostředí PDE pomůže a zabrání chybám.
