AgE 2.4 : DostepDoWlasciwosci

Dostęp do właściwości

Klasą, która umożliwia odczyt, modyfikację oraz monitorowanie pojedynczej właściwości jest klasa Property, której metody przedstawione są w poniższej tabeli:

Metoda

Opis

getValue

Zwraca wartość właściwości.

setValue

Ustawia nową wartość właściwości.

getMetaProperty

Zwraca metadane opisujące właściwość. Metadane przechowują informacje o typie oraz o tym, czy jest ona zapisywalna i monitorowalna.

addMonitor

Dodaje nowy monitor do właściwości. Monitorowanie jest opisane w dalszej części dokumentacji.

removeMonitor

Usuwa monitor właściwości.

notifyMonitors

Informuje monitory o zmianie właściwości.

objectDeleted

Metoda wywoływana, gdy usuwany jest obiekt przechowujący tą właściwość. Informuje ona wszystkie monitory o usunięciu obiektu, który obserwują.

Uzyskiwanie obiektów klasy Property

Obiekty klasy Property są zwracane przez metodę getProperty(String propertyPath), zdefiniowaną w interfejsie IPropertyContainer. W najprostszym przypadku, ścieżka (argument propertyPath) jest nazwą pojedynczej właściwości - wówczas metoda zwróci właściwość zdefiniowaną w tym kontenerze, z którego jest wywoływana. Możliwe jest jednak użycie ścieżek złożonych, dzięki którym możemy uzyskać dostęp do zagnieżdżonych właściwości.