Jet\Application_Service_List

Základ třídy, která spravuje služby v rámci subsystému aplikačních služeb.

Třída se stará o rutinní práci se seznamem služeb, načtení konfigurace, správu seznamu a získávání instancí služeb samotných. Nejedná se však o konečnou třídu, která by sama o sobě měla být používána. Od této třídy v rámci aplikace vždy dědí další třídy (jako například JetApplication\Application_Service_Admin), které již zabezpečují konečnou správu služeb pro aplikaci – respektive část aplikace.

Metoda	Význam
public __construct( string $cfg_file_path, string $group )	Parametry: $cfg_file_path Cesta ke konfiguračnímu souboru, ze kterého bude načteno nastavení služeb (tedy který aplikační modul / moduly zabezpečují danou službu). $group Textová identifikace skupiny služeb. (Například: 'Admin')
public getServicesMetaInfo( ) : [string=>Application_Service_MetaInfo]	Vrací již připravený seznam metainformací služeb.
public loadCfg( ) : void	Nahrává konfigurační soubor.
public saveCfg( ) : void	Ukládá konfigurační soubor.
public getConfig( ) : array	Nahraje konfiguraci a vrací surová konfigurační data.
public setServiceConfig( string $interface_class_name, string\|array $module_class_name ) : void	Nastavuje konfiguraci pro konkrétní službu. Tedy ke konkrétnímu rozhraní přiřazuje konkrétní aplikační modul (nebo moduly).
public getServiceMetaInfo( string $interface_class_name ) : null\|Application_Service_MetaInfo	Vrací metainformace aplikační služby na základě názvu rozhraní (nebo abstraktní třídy) služby. Pokud v aplikaci není žádný modul, který by službu zabezpečoval, pak buď vrací null v situaci, kdy služba není mandatorní, nebo vyhodí výjimku o neexistenci mandatorní služby v systému a běh aplikace tím ukončí.
public get( string $interface_class_name ) : null\|Application_Module	Vrací instanci aplikačního modulu, který má zabezpečovat danou službu. Pokud v aplikaci není žádný modul, který by službu zabezpečoval, pak buď vrací null v situaci, kdy služba není mandatorní, nebo vyhodí výjimku o neexistenci mandatorní služby v systému a běh aplikace tím ukončí.
public getList( string $interface_class_name ) : [Application_Module]	Vrací instance aplikačních modulů, které mají zabezpečovat danou službu. Pokud v aplikaci není žádný modul, který by službu zabezpečoval, pak buď vrací prázdné pole v situaci, kdy služba není mandatorní, nebo vyhodí výjimku o neexistenci mandatorní služby v systému a běh aplikace tím ukončí.
public static findPossibleModules( string $interface_class_name, ?string $name_prefix=null ) : [Application_Module]	Najde v systému všechny aplikační moduly, které by mohly zabezpečovat danou službu, a vrátí jejich instance. Užitečné například pro vytváření konfiguračních nástrojů.
public static getServiceMetaInfos( ) : [Application_Service_MetaInfo]	Najde v aplikaci všechny možné aplikační služby a vrátí jejich seznam – respektive vrátí seznam metainformací těchto služeb.