Jet\DataModel_IDController

Základní abstraktní třída ID kontroleru od které musí dědit všechny ID kontrolery.

Přehled metod

Metoda Význam
public __construct(
DataModel_Definition_Model $data_model_definition,
array $options
)		 Při vytváření instance nového kontroleru se pro začátek nepočítá s jeho napojením na konkrétní instanci nějaké entity. Proto se vytváří obecná instance, která je napojená na definici entity.
public setOptions(
array $options
) : void		 Nastavuje parametry kontroleru z definice entity.
public assocDataModelInstance(
DataModel $data_model
) : void		 Napojuje ID kontroler na konkrétní instanci entity. Tedy z prázdného / obecného ID kontroleru se stává nosič konkrétní identifikace konkrétního záznamu.
public assocDataModelInstanceProperty(
string $name,
mixed& $property
) : void		 Napojuje ID kontroler na konkrétní vlastnost konkrétní instance entity. Tedy z prázdného / obecného ID kontroleru se stává nosič konkrétní identifikace konkrétního záznamu.
public getDataModelClassName(
) : string		 Vrací název třídy entity ke které instance kontroleru náleží.
public getDataModelDefinition(
) : DataModel_Definition_Model_Main|
DataModel_Definition_Model_Related		 Vrací definici entity ke které instance kontroleru náleží.
public getQuery(
) : DataModel_Query		 Vygeneruje query (WHERE část) pro práci s konkrétním záznamem (načtení, smazání, úprava).
public getValue(
string $property_name
) : mixed		 Vrátí prvek identifikace - tedy hodnotu dané vlastnosti, která slouží k identifikaci záznamu.
public setValue(
string $property_name,
mixed $value
) : void		 Nastaví prvek identifikace - tedy hodnotu dané vlastnosti, která slouží k identifikaci záznamu.
public getPropertyNames(
) : array		 Vrátí názvy vlastností entity, které slouží jako prvky identifikace záznamu.
public generate(
) : void		 Vynucené generování ID. Například je možné textový identifikátor záznamu vygenerovat ještě než dojde k uložení záznamu.

Týká se pochopitelně pouze těch ID kontrolerů, které generují identifikátor sami. Tedy netýká se to například autoincrement id, ani pasivního kontroleru - tyto kontrolery z principu nic negenerují. Ale metoda je relevantní pro ID kontroler UniqueString a jemu podobné.
public beforeSave(
) : void		 Tuto metodu vnitřně volá DataModel před ukládáním záznamu a je na logicke kontroleru aby provedla to co je v daný moment nutné provést.

Tedy například kontroler UniqueString v vygeneruje náhodný řetězec (pokud to již neudělal před tím).
public afterSave(
mixed $backend_save_result
) : void		 Tuto metodu DataModel vnitřně volá po uložení záznamu do databáze a je opět na kontroleru jak naloží s tím, co databáze po uložení záznamu vrátila.

Relevantní pro kontroler AutoIncrement a jemu podobné. Pro jiné kontrolery irelevantní.
public __toString(
) : string		 Instanci kontroleru vázanou na konkrétní záznam konkrétní instance entity je možné převádět na řetězec. Pokud je identifikace záznamu tvořena více jak jednou vlastností, pak jsou hodnoty v rámci řetězce oddělené znakem ':'.
public toString(
) : string		 Instanci kontroleru vázanou na konkrétní záznam konkrétní instance entity je možné převádět na řetězec. Pokud je identifikace záznamu tvořena více jak jednou vlastností, pak jsou hodnoty v rámci řetězce oddělené znakem ':'.
Předchozí kapitola
Jet\DataModel_Definition_Relation_Join_Condition
Další kapitola
Jet\DataModel_IDController_AutoIncrement
GitHub