Prostředky a pracovní prostor

Hlavní centrum pro vaše uživatelské datové soubory se nazývá pracovní prostor. Pracovní plochu platformy si můžete představit jako nástroj umožňující uživateli přejít do pracovního prostoru a manipulovat s ním. Modul plug-in prostředků poskytuje rozhraní API pro vytváření, vyhledávání, přístup a manipulaci s prostředky v pracovním prostoru. Pracovní plocha poskytuje tuto funkcionalitu uživateli pomocí těchto rozhraní API. Také vaše moduly plug-in mohou využívat tato rozhraní API.

Z hlediska modulu plug-in založeného na prostředcích existuje přesně jeden pracovní prostor a ten je vždy k dispozici, pokud je modul plug-in spuštěný. Pracovní prostor se otevírá automaticky při aktivování modulu plug-in prostředků a zavírá se při vypnutí platformy. Pokud váš modul plug-in potřebuje modul plug-in prostředků, bude takový modul plug-in prostředků spuštěn ještě před vaším modulem a pracovní prostor vám bude k dispozici.

Pracovní prostor obsahuje kolekci prostředků. Z pohledu uživatele existují tři různé typy prostředků: projekty, složky a soubory. Projekt je kolekcí libovolného počtu souborů a složek. Je to pořadač pro organizaci ostatních prostředků, které se týkají určité oblasti. Soubory a složky jsou úplně stejné jako soubory a adresáře v běžném systému souborů. Složka obsahuje jiné složky nebo soubory. Soubor obsahuje libovolnou posloupnost bajtů. Jeho obsah není interpretován platformou.

Prostředky pracovního prostoru jsou uspořádány do stromové struktury, kde projekty jsou nejvýše, zatímco složky a soubory jsou na nižších úrovních. Zvláštní prostředek, kterým je prostředek typu kořen pracovního prostoru, slouží jako kořenová složka stromu prostředků. Kořen pracovního prostoru se vytváří interně při vytváření pracovního prostoru a existuje tak dlouho, dokud existuje pracovní prostor.

Pracovní prostor může mít jakýkoli počet projektů a kterýkoli z nich může být uložen na libovolném umístění na disku.

Obor názvů prostředků pracovního prostoru vždy odlišuje a zachovává velká a malá písmena. Z tohoto důvodu pracovní prostor umožňuje uchovávání více příbuzných prostředků, jejichž jména se odlišují pouze velikostí písmen. Pracovní prostor rovněž neomezuje platnost znaků názvů prostředků, délku názvů prostředků ani velikost prostředků na disku. Pokud uložíte prostředky na disk, který neodlišuje velikost písmen nebo který určitým způsobem omezuje názvy prostředků, samozřejmě se takováto omezení uplatní při pokusu o vytvoření nebo úpravu prostředku.

Ukázka stromu prostředků

Níže uvedený strom (znázorněný v pohledu pracovní plochy s navigátorem) ilustruje typickou hierarchii prostředků v pracovním prostoru. (Implikovaným) kořenem stromu je kořen pracovního prostoru. Projekty jsou bezprostředně podřízenými prvky kořene pracovního prostoru. Každý uzel (vyjma kořene) je jedním ze tří druhů prostředků a každý má název odlišný od názvu uzlů shodné úrovně.

Pohled navigátoru s ukázkou pracovního prostoru

Názvy prostředků jsou libovolné řetězce (lépe řečeno téměř libovolné - musí to být povolené názvy souborů). Samotná platforma nepředepisuje názvy prostředků ani nespecifikuje žádné názvy zvláštního významu.  (Jedinou výjimkou je, že nemůžete projekt pojmenovat názvem ".metadata" jelikož tento název se využívá interně.)

Projekty obsahují soubory a složky, nikoli však jiné projekty. Projekty a složky jsou jako adresáře v systému souborů. Když odstraňujete projekt, objeví se dotaz, zda chcete odstranit všechny soubory a složky, které obsahuje.  Odstraněním složky z projektu dojde k odstranění složky jako takové i všech jejích podřízených prvků. Odstranění souboru je analogické k odstranění běžného souboru v systému souborů.