Editor schématu bodu rozšíření je možné otevřít dvěma způsoby: jako spoluprodukt při vytvoření nového bodu rozšíření nebo otevřením stávajícího schématu bodu rozšíření. Podle konvencí mají nová schémata stejný název jako ID bodu rozšíření s příponou souboru .exsd. Jsou umístěna v adresáři schéma v adresářovém stromě v modulu plug-in.
Po vytvoření nového bodu rozšíření v prostředí PDE je vytvořen také soubor původního schématu a otevře se editor schématu pro úpravy. Schéma můžete definovat okamžitě, nebo jej zavřít a definovat později. Vytvoření úplného schématu bodu rozšíření umožňuje prostředí PDE nabídnout automatizovanou pomoc uživatelům bodu rozšíření.
Editor schématu bodu rozšíření prostředí PDE je založeno na stejných konceptech jako editor manifestu modulu plug-in. Obsahuje dvě formulářové stránky a jednu stránku zdroje. Vzhledem k tomu, že schéma XML obsahuje komentáře a v podobě zdroje je obtížně čitelné, měli byste provádět úpravy především na formulářových stránkách. Stránka zdroje je užitečná pro čtení výsledného zdrojového kódu.
Bod rozšíření "Ukázkové syntaktické analyzátory" a původní schéma již byly vytvořeny dříve. Nyní otevřete schéma v projektové složce schéma a poklepejte na soubor parsers.exsd. Otevře se editor schématu.
Cílem je:
Každé schéma bodu rozšíření začíná deklarací prvku "rozšíření". Přidáte nový prvek XML s názvem "syntaktický analyzátor".
Editor schématu by měl dosud vypadat takto:
Nyní přidáme další atribut, který přebírá hodnoty z krátkého seznamu voleb. To znamená, že je třeba vytvořit omezení výčtu základního typu řetězec. Také nastavíte výchozí hodnotu atributu.
Dialogové okno omezení by mělo vypadat takto:
Po zavření dialogového okna změňte atribut "použití" na hodnotu "výchozí" a "hodnotu" atributu na "vždy". Tím nastavíte výchozí hodnotu. Všimněte si, že stavový řádek zobrazuje při zadávání hodnoty chybovou zprávu, protože omezuje platné hodnoty na tyto tři volby výčtu. Jakmile dokončíte zadávání, měla by chybová zprávy zmizet, protože "vždy" je platná hodnota.
Po nadefinování všech prvků a atributů je třeba definovat gramatiku. Cílem je nadefinovat prvek "rozšíření" tak, aby mohl obsahovat libovolný počet podřízených prvků "syntaktický analyzátor".
Po definování gramatiky zobrazuje přibližný odhad DTD v gramatické části, jak bude vypadat gramatika vybraného prvku v DTD. Tyto informace jsou určeny vývojářům, kteří pracují s definicemi DTD raději než se schématy XML.
Po nadefinování platných prvků, atributů a gramatiky je třeba zadat informace o bodu rozšíření. Existují dva typy úseků dokumentace schématu:
První typ úseku je uveden na stránce Definice v manifestu schématu. Při výběru prvků a atributů k nim můžete přidat krátký popis v části "Popis". Očekávaný formát je přímý kód HTML (jako u dokumentace Javadoc) a text bude do konečného referenčního dokumentu zkopírován tak, jak je.
Krátký textový popis samotného bodu rozšíření není třeba uvádět. Chcete-li popis zadat, je třeba přepnout na stránku Dokumentace:
Tento bod rozšíření slouží k zapojení dalších syntaktických analyzátorů.
Syntaktické analyzátory nejsou ve skutečnosti funkční - jsou použity pouze jako příklad schématu bodu rozšíření.
Následuje příklad užití bodu rozšíření:
<p>
<pre>
<extension point="com.example.xyz.parsers">
<parser
id="com.example.xyz.parser1"
name="Sample Parser 1"
class="com.example.xyz.SampleParser1">
</parser>
</extension>
</pre>
</p>
Klepněte na tlačítko Použít.
Moduly plug-in, které mají rozšířit tento bod rozšíření, musí implementovat rozhraní <samp>com.ukazka.xyz.IParser</samp>.
Modul plug-in XYZ poskytuje výchozí implementaci syntaktického analyzátoru.
Klepněte na tlačítko Použít.Poznámka: Při poskytování příkladů je třeba vzít v potaz zvláštní okolnosti. Obvykle prostředí PDE považuje text za přímý kód HTML a nebere ohled na nový řádek a mezeru větší než jeden znak (tj. přehlížené neviditelné znaky). To je v pořádku u běžného textu, ale nesmírně obtěžující v ukázkách, kdy je třeba text zformátovat pomocí tabulátoru a svislého zarovnání, aby ukázka vypadala dobře. Prostředí PDE nabízí pro tuto situaci řešení: jakmile zjistí značku HTML <pre>, přebere obsah až po značku </pre> tak, jak je (zachová všechny znaky bez úprav). Díky tomu je možné poskytnout ukázku v takové podobě, v jaké je uvedena výše, a spolehnout se na to, že bude vypadat stejně dobře i v konečném referenčním dokumentu.
Možná jste si již všimli, že postupně, jak vytváříte dokumentaci, je čím dál více prvků v pohledu Osnova v editoru překryto obrázkem "pera". Tento malý indikátor označuje, že k danému prvku je přidružen text. Tímto způsobem můžete rychle zjistit, zda někde v dokumentu nechybí část dokumentace.
Po dokončení dokumentace můžete obrátit pozornost k referenční dokumentaci. Existují dva způsoby. Po celou dobu práce můžete zobrazit náhled referenčního dokumentu tak, že vyberete položku Zobrazit náhled referenčního dokumentu z rozevírací nabídky. Také můžete nastavit předvolby prostředí PDE (Předvolby>Vývoj modulu plug-in>Kompilátory - na kartě Schéma) pro automatické vytvoření referenční dokumentace při každé změně souboru schématu. Bez ohledu na metodu, kterou zvolíte, bude výsledný dokument ukázky vypadat takto.