Conteneur

classe publique Container

Objet donnant accès aux valeurs de conteneur. Les objets conteneur doivent être créés via openContainer(String, Container.Callback) ou ContainerOpener. Une fois qu'un conteneur est créé, il peut être interrogé pour obtenir des valeurs de clé qui peuvent dépendre des règles établies pour le conteneur. Un conteneur est actualisé automatiquement régulièrement (toutes les 12 heures), mais peut également être actualisé manuellement avec refresh().

Récapitulatif des classes imbriquées

interface Container.Callback Le rappel sera invoqué une fois que la ressource aura été chargée. 
interface Container.FunctionCallMacroHandler Gestionnaire fourni par l'application pour calculer la valeur d'une macro personnalisée. 
interface Container.FunctionCallTagHandler Gestionnaire fourni par l'application pour exécuter une balise personnalisée. 
enum Container.RefreshFailure Problèmes pouvant entraîner l'échec d'une actualisation
enum Container.RefreshType Origine de l'actualisation du conteneur. 

Récapitulatif des méthodes publiques

synchronisée vide
close()
boolean
getBoolean(Chaîne key)
Chaîne
getContainerId()
double
getDouble(Chaîne key)
synchronisée Container.FunctionCallMacroHandler
getFunctionCallMacroHandler(Chaîne customMacroName)
synchronisée Container.FunctionCallTagHandler
getFunctionCallTagHandler(Chaîne customTagName)
long
getLastRefreshTime()
long
getLong(Chaîne key)
Chaîne
getString(Chaîne key)
boolean
isDefault()
synchronisée vide
refresh()
synchronisée vide
registerFunctionCallMacroHandler(Chaîne customMacroName, Container.FunctionCallMacroHandler customMacroHandler)
synchronisée vide
registerFunctionCallTagHandler(Chaîne customTagName, Container.FunctionCallTagHandler customTagHandler)

Méthodes publiques

public synchronisé void close ()

Ferme ce conteneur afin qu'il ne soit plus actualisé. Une fois fermé, elle ne doit plus être utilisée.

public boolean getBoolean (String key)

Renvoie une valeur booléenne représentant la valeur de configuration pour la clé donnée. Si le conteneur ne comporte aucune valeur pour cette clé, la valeur "false" est renvoyée.

public String getContainerId ()

Renvoie l'ID du conteneur.

public double getDouble (String key)

Renvoie un double représentant la valeur de configuration pour la clé donnée. Si le conteneur ne comporte aucune valeur pour cette clé, la valeur 0 s'affiche.

public synchronisé Container.FunctionCallMacroHandler getFunctionCallMacroHandler (Chaîne customMacroName)

Renvoie le gestionnaire de macros enregistré pour la macro d'appel de fonction donnée.

public synchronisé Container.FunctionCallTagHandler getFunctionCallTagHandler (Chaîne customTagName)

Renvoie le gestionnaire de tags enregistré pour le tag d'appel de fonction donné.

public long getLastRefreshTime ()

Renvoie la dernière heure (en millisecondes depuis le 1er janvier 1970 UTC) à laquelle ce conteneur a été actualisé à partir du réseau.

public long getLong (String key)

Renvoie un entier long représentant la valeur de configuration pour la clé donnée. Si le conteneur ne comporte aucune valeur pour cette clé, la valeur 0 s'affiche.

public Chaîne getString (String key)

Renvoie une chaîne représentant la valeur de configuration pour la clé donnée. Si le conteneur ne comporte aucune valeur pour cette clé, une chaîne vide est renvoyée.

public boolean isDefault ()

Indique s'il s'agit d'un conteneur par défaut ou d'un conteneur actualisé à partir du serveur.

public synchronisée void refresh ()

Demande l'actualisation de ce conteneur à partir du réseau. Cet appel étant asynchrone, l'actualisation aura lieu sur un autre thread.

Après avoir appelérefresh(), vous devez attendre au moins 15 minutes avant de réessayer d'appeler cette méthode. Sinon, l'appel suivant pourrait être une opération no-op.

public synchronisé void registerFunctionCallMacroHandler (Chaîne customMacroName, Container.FunctionCallMacroHandler customMacroHandler)

Enregistre le gestionnaire de macros donné pour gérer une macro d'appel de fonction donnée.

Paramètres
customMacroName le nom de la macro en cours d'enregistrement ;
customMacroHandler le gestionnaire. Si la valeur est nulle, annule l'enregistrement de tout gestionnaire existant pour cette macro.

public synchronisé void registerFunctionCallTagHandler (Chaîne customTagName, Container.FunctionCallTagHandler customTagHandler)

Enregistre le gestionnaire de tags pour gérer une balise d'appel de fonction donnée.

Paramètres
customTagName le nom de la balise en cours d'enregistrement ;
customTagHandler le gestionnaire. Si la valeur est nulle, annule l'enregistrement de tout gestionnaire existant pour ce tag.