Obiekt zapewniający dostęp do wartości kontenera.
Obiekty kontenerów należy tworzyć za pomocą openContainer(String, Container.Callback) lub ContainerOpener.
Po utworzeniu kontenera można wysyłać do niego zapytania o wartości kluczy, które mogą zależeć od utworzonych dla niego reguł.
Kontener jest odświeżany automatycznie co 12 godzin, ale można go też odświeżać ręcznie za pomocą refresh().
Podsumowanie zagnieżdżonych zajęć
| interfejs, | Container.Callback | Wywołanie zwrotne zostanie wykonane po wczytaniu zasobu. | |
| interfejs, | Container.FunctionCallMacroHandler | Moduł obsługi udostępniany przez aplikację do obliczania wartości niestandardowego makra. | |
| interfejs, | Container.FunctionCallTagHandler | Moduł obsługi udostępniany przez aplikację do uruchamiania niestandardowego tagu. | |
| enum | typ wyliczeniowy | Container.RefreshFailure | Sposoby, w których odświeżanie może się nie powieść. | |
| enum | typ wyliczeniowy | Container.RefreshType | Źródło odświeżania kontenera. | |
Podsumowanie metod publicznych
| zsynchronizowane void |
close()
|
| boolean |
getBoolean(ciąg znaków klucz)
|
| Ciąg znaków | |
| liczba zmiennoprzecinkowa |
getDouble(klucz ciągu znaków)
|
| zsynchronizowano Container.FunctionCallMacroHandler |
getFunctionCallMacroHandler(Ciąg znaków customMacroName)
|
| zsynchronizowano Container.FunctionCallTagHandler |
getFunctionCallTagHandler(ciąg znaków customTagName)
|
| długi | |
| długi |
getLong(klucz)
|
| Ciąg znaków |
getString(ciąg znaków klucz)
|
| boolean | |
| zsynchronizowane void |
refresh()
|
| zsynchronizowane void |
registerFunctionCallMacroHandler(ciąg znaków customMacroName, Container.FunctionCallMacroHandler customMacroHandler)
|
| zsynchronizowane void |
registerFunctionCallTagHandler(ciąg znaków customTagName, Container.FunctionCallTagHandler customTagHandler)
|
Metody publiczne
public zsynchronizowane void close ()
Zamyka ten kontener, aby nie był już odświeżany. Po zamknięciu nie należy z niego korzystać.
public boolean getBoolean (ciąg klucz)
Zwraca wartość logiczną reprezentującą wartość konfiguracji danego klucza. Jeśli kontener nie ma wartości dla tego klucza, zwracana jest wartość false (fałsz).
public Ciąg getContainerId ()
Zwraca identyfikator kontenera.
public getDouble (ciąg klucz)
Zwraca liczbę zmiennoprzecinkową reprezentującą wartość konfiguracji danego klucza. Jeśli kontener nie ma wartości dla tego klucza, zwracana jest wartość 0.
publiczna zsynchronizowana Container.FunctionCallMacroHandler getFunctionCallMacroHandler (Ciąg customMacroName)
Zwraca moduł obsługi makra zarejestrowany dla danego makra wywołania funkcji.
public zsynchronizowany Container.FunctionCallTagHandler getFunctionCallTagHandler (Ciąg znaków customTagName)
Zwraca moduł obsługi tagu zarejestrowany dla danego tagu wywołania funkcji.
public long getLastRefreshTime ()
Zwraca czas ostatniego odświeżania tego kontenera z sieci (w milisekundach od północy 1 stycznia 1970 r. czasu UTC).
public long getLong (ciąg klucz)
Zwraca ciąg znaków reprezentujący wartość konfiguracji dla danego klucza. Jeśli kontener nie ma wartości dla tego klucza, zwracana jest wartość 0.
public Ciąg getString (Ciąg klucz)
Zwraca ciąg znaków reprezentujący wartość konfiguracji danego klucza. Jeśli kontener nie ma wartości dla tego klucza, zwrócony zostanie pusty ciąg znaków.
public boolean isDefault ()
Zwraca, czy jest to kontener domyślny, czy odświeżony przez serwer.
public sync void refresh ()
Żądania odświeżania tego kontenera z sieci. To wywołanie jest asynchroniczne, więc odświeżanie nastąpi w innym wątku.
Po wywołaniu funkcjirefresh() musisz odczekać co najmniej 15 minut, zanim spróbujesz ponownie wywołać tę metodę. W przeciwnym razie kolejne wywołanie może nie być wykonywane.
public zsynchronizowana void registerFunctionCallMacroHandler (ciąg znaków customMacroName, Container.FunctionCallMacroHandler customMacroHandler)
Rejestruje dany moduł obsługi makra do obsługi danego makra wywołania funkcji.
Parametry
| customMacroName | nazwa rejestrowanego makra |
| customMacroHandler | . Jeśli ma wartość null, wyrejestrowuje istniejący moduł obsługi tego makra. |
public zsynchronizowany void registerFunctionCallTagHandler (Ciąg znaków customTagName, Container.FunctionCallTagHandler customTagHandler)
Rejestruje moduł obsługi tagów do obsługi danego tagu wywołania funkcji.
Parametry
| customTagName | nazwa rejestrowanego tagu |
| customTagHandler | . Jeśli ma wartość null, wyrejestrowuje istniejący moduł obsługi tego tagu. |