Show Menu
ARGOMENTI×

Riferimento API ContextHub Javascript

L'API ContextHub Javascript è disponibile per gli script quando il componente ContextHub è stato aggiunto alla pagina .

Costanti ContextHub

Valori costanti definiti dall'API ContextHub Javascript.

Costanti evento

Nella tabella seguente sono elencati i nomi degli eventi che si verificano per gli store ContextHub. Vedere anche ContextHub.Utils.Eventing .
Costante
Descrizione
Valore
ContextHub.Constants.EVENT_NAMESPACE
Spazio dei nomi evento di ContextHub
ch
ContextHub.Constants.EVENT_ALL_STORES_READY
Indica che tutti gli store richiesti sono registrati, inizializzati e pronti per essere consumati
all-stores-ready
ContextHub.Constants.EVENT_STORES_PARTIALLY_READY
Indica che non tutti gli store sono stati inizializzati entro un determinato timeout
magazzini parzialmente pronti
ContextHub.Constants.EVENT_STORE_REGISTERED
Generato quando un negozio è registrato
registrato nel negozio
ContextHub.Constants.EVENT_STORE_READY
Indica che i negozi sono pronti per funzionare. Viene attivato immediatamente dopo la registrazione, ad eccezione degli store JSONP, dove viene attivato quando vengono estratti i dati.
pronto per il negozio
ContextHub.Constants.EVENT_STORE_UPDATED
Generato quando uno store aggiorna la sua persistenza
aggiornamento store
ContextHub.Constants.PERSISTENCE_CONTAINER_NAME
Nome contenitore persistenza
ContextHubPersistenza
ContextHub.Constants.SERVICE_RAW_RESPONSE_KEY
Memorizza il nome della chiave di persistenza specifica in cui è memorizzato il risultato JSON non elaborato
/_/raw-response
ContextHub.Constants.SERVICE_RESPONSE_TIME_KEY
Memorizza la marca temporale specifica che indica quando sono stati estratti i dati JSON
/_/tempo di risposta
ContextHub.Constants.SERVICE_LAST_URL_KEY
Memorizza l’URL specifico del servizio JSON utilizzato durante l’ultima chiamata
/_/url
ContextHub.Constants.IS_CONTAINER_EXPANDED
Indica se l'interfaccia utente di ContextHub è espansa
/_/container-espanso

Costanti evento interfaccia utente

Nella tabella seguente sono elencati i nomi degli eventi che si verificano per l’interfaccia utente ContextHub.
Costante
Descrizione
Valore
ContextHub.Constants.EVENT_UI_MODE_REGISTERED
Generato quando una modalità viene registrata
in modalità automatica
ContextHub.Constants.EVENT_UI_MODE_UNREGISTERED
Generato quando una modalità non è registrata
ui-mode non registrato
ContextHub.Constants.EVENT_UI_MODE_RENDERER_REGISTERED
Generato quando viene registrato un renderer di modalità
modalità automatica, con rendering registrato
ContextHub.Constants.EVENT_UI_MODE_RENDERER_UNREGISTERED
Generato quando un renderer di modalità non è registrato
renderer in modalità automatica non registrato
ContextHub.Constants.EVENT_UI_MODE_ADDED
Generato quando viene aggiunta una nuova modalità
in modalità automatica
ContextHub.Constants.EVENT_UI_MODE_REMOVED
Generato quando una modalità viene rimossa
rimosso in modalità automatica
ContextHub.Constants.EVENT_UI_MODE_SELECTED
Generato quando l’utente seleziona una modalità
modalità di selezione automatica
ContextHub.Constants.EVENT_UI_MODULE_REGISTERED
Generato quando viene registrato un nuovo modulo
modulo-utente registrato
ContextHub.Constants.EVENT_UI_MODULE_UNREGISTERED
Generato quando un modulo non è registrato
modulo-ui non registrato
ContextHub.Constants.EVENT_UI_MODULE_RENDERER_REGISTERED
Generato quando viene registrato un renderer di moduli
modulo-modulo-renderer registrato
ContextHub.Constants.EVENT_UI_MODULE_RENDERER_UNREGISTERED
Generato quando un renderer di modulo non è registrato
Modulo-ui-renderer-unregistered
ContextHub.Constants.EVENT_UI_MODULE_ADDED
Generato quando viene aggiunto un nuovo modulo
modulo-aggiunto
ContextHub.Constants.EVENT_UI_MODULE_REMOVED
Generato quando un modulo viene rimosso
rimosso da un modulo
ContextHub.Constants.EVENT_UI_CONTAINER_ADDED
Generato quando il contenitore dell’interfaccia utente viene aggiunto alla pagina
contenitore-aggiunto
ContextHub.Constants.EVENT_UI_CONTAINER_OPENED
Generato all’apertura dell’interfaccia utente ContextHub
contenitore-ui aperto
ContextHub.Constants.EVENT_UI_CONTAINER_CLOSED
Generato quando l’interfaccia utente ContextHub viene compressa
ui-container-closed
ContextHub.Constants.EVENT_UI_PROPERTY_MODIFIED
Generato quando una proprietà viene modificata
ui-property-modified
ContextHub.Constants.EVENT_UI_RENDERED
Generato ogni volta che viene eseguito il rendering dell’interfaccia utente ContextHub (ad esempio dopo una modifica di proprietà)
con riproduzione automatica
ContextHub.Constants.EVENT_UI_INITIALIZED
Generato quando il contenitore dell'interfaccia utente viene inizializzato
inizializzato dall'utente
ContextHub.Constants.ACTIVE_UI_MODE
Indica la modalità interfaccia attiva
/_/active-ui-mode

Riferimento API ContextHub Javascript

L'oggetto ContextHub consente l'accesso a tutti gli store.

Funzioni (ContextHub)

getAllStores()

Restituisce tutti gli store ContextHub registrati.
Questa funzione non ha parametri.
Valore restituito
Un oggetto che contiene tutti gli store ContextHub. Ogni store è un oggetto che utilizza lo stesso nome dello store.
Esempio
L'esempio seguente recupera tutti gli store e recupera lo store di geolocalizzazione:
var allStores = ContextHub.getAllStores();
var geoloc = allStores.geolocation

getStore(name)

Recupera uno store come oggetto Javascript.
Parametri
  • name: Nome con cui è stato registrato lo store.
Valore restituito
Un oggetto che rappresenta lo store.
Esempio
L'esempio seguente recupera l'archivio di geolocalizzazione:
var geoloc = ContextHub.getStore("geolocation");

ContextHub.SegmentEngine.Segment

Rappresenta un segmento ContextHub. Utilizzate ContextHub.SegmentEngine.SegmentManager per ottenere i segmenti.

Funzioni (ContextHub.ContextEngine.Segment)

getName()

Restituisce il nome del segmento come valore String.

getPath()

Restituisce il percorso di repository della definizione del segmento come valore String.

ContextHub.SegmentEngine.SegmentManager

Fornisce l'accesso ai segmenti ContextHub.

Funzioni (ContextHub.SegmentEngine.SegmentManager)

getResolvedSegments()

Restituisce i segmenti risolti nel contesto corrente. Questa funzione non ha parametri.
Valore restituito
Un array di oggetti ContextHub.SegmentEngine.Segment.

ContextHub.Store.Core

La classe base per gli store ContextHub.

Proprietà (ContextHub.Store.Core)

evento

Un oggetto ContextHub.Utils.Eventing . Utilizzare questo oggetto per eseguire il binding delle funzioni per memorizzare gli eventi. Per informazioni sul valore predefinito e sull'inizializzazione, vedere init(name,config) .

name

Il nome dello store.

persistenza

Un oggetto ContextHub.Utils.Persistenza. Per informazioni sul valore predefinito e sull'inizializzazione, vedete [init(name,config)](/help/sites-developing/contexthub-api.md#init-name-config).

Funzioni (ContextHub.Store.Core)

addAllItems(struttura ad albero, opzioni)

Unisce un oggetto dati o una matrice ai dati dello store. Ogni coppia chiave/valore nell'oggetto o nella matrice viene aggiunta allo store (tramite la setItem funzione):
  • Oggetto: Le chiavi sono i nomi delle proprietà.
  • Array: Le chiavi sono gli indici degli array.
I valori possono essere oggetti.
Parametri
  • struttura: (Oggetto o array) I dati da aggiungere allo store.
  • opzioni: (Oggetto) Un oggetto facoltativo di opzioni passato alla funzione setItem. Per informazioni, vedi il options parametro di setItem(key,value,options) .
Valore restituito
Un boolean valore:
  • Il valore di true indica che l'oggetto dati è stato memorizzato.
  • Il valore di false indica che l'archivio dati è invariato.

addReference(key, anotherKey)

Crea un riferimento da una chiave a un'altra chiave. Una chiave non può fare riferimento a se stessa.
Parametri
  • key: La chiave a cui fa riferimento anotherKey .
  • altra chiave: Chiave a cui fa riferimento key .
Valore restituito
Un boolean valore:
  • Un valore di true indica che il riferimento è stato aggiunto.
  • Un valore di false indica che non è stato aggiunto alcun riferimento.

announceReadiness()

Attiva l’ ready evento per lo store. Questa funzione non ha parametri e non restituisce alcun valore.

clean()

Rimuove tutti i dati dallo store. La funzione non ha parametri e non restituisce valori.

getItem(key)

Restituisce il valore associato a una chiave.
Parametri
  • key: (String) La chiave per la quale restituire il valore.
Valore restituito
Un oggetto che rappresenta il valore della chiave.

getKeys(includeInternali)

Recupera le chiavi dallo store. Facoltativamente potete recuperare le chiavi utilizzate internamente dal framework ContextHub.
Parametri
  • includeInternali: Un valore di true include le chiavi utilizzate internamente nei risultati. Queste chiavi iniziano con il carattere di sottolineatura ("_"). Il valore predefinito è false .
Valore restituito
Un array di nomi chiave ( string valori).

getReferences()

Recupera i riferimenti dallo store.
Valore restituito
Un array che utilizza chiavi di riferimento come indici per le chiavi di riferimento:
  • Le chiavi di riferimento corrispondono al key parametro della addReference funzione.
  • Le chiavi di riferimento corrispondono al anotherKey parametro della addReference funzione.

getTree(includeInterni)

Recupera la struttura dati dallo store. Facoltativamente potete includere le coppie chiave/valore utilizzate internamente dal framework ContextHub.
Parametri
  • includeInternals: Un valore di true include nei risultati coppie chiave/valore utilizzate internamente. Le chiavi di questi dati iniziano con il carattere di sottolineatura ("_"). Il valore predefinito è false .
Valore restituito
Un oggetto che rappresenta la struttura dei dati. Le chiavi sono i nomi delle proprietà dell'oggetto.

init(name, config)

Inizializza lo store.
  • Imposta i dati dello store su un oggetto vuoto.
  • Imposta i riferimenti dell'archivio su un oggetto vuoto.
  • eventChannel è data: name , dove name è il nome dell'archivio.
  • StoreDataKey è /store/ name , dove name è il nome dello store.
Parametri
  • name: Il nome dello store.
  • config: Un oggetto che contiene le proprietà di configurazione:
    • eventDeferring: Il valore predefinito è 32.
    • evento: L'oggetto ContextHub.Utils.Eventing per questo store. Il valore predefinito è l'oggetto ContextHub.eventing utilizzato.
    • persistenza: L'oggetto ContextHub.Utils.Persistenza per lo store. Il valore predefinito è l'oggetto ContextHub.persistence.

isEventingPaused()

Determina se l'evento viene messo in pausa per lo store.
Valore restituito
Un valore booleano:
  • true : Eventing viene messo in pausa in modo che non venga attivato alcun evento per lo store.
  • false : Eventing non viene messo in pausa in modo che gli eventi vengano attivati per lo store.

pauseEventing()

Sospende l'evento per lo store in modo da non attivare eventi. Questa funzione non richiede parametri e non restituisce alcun valore.

removeItem(key, options)

Rimuove una coppia chiave/valore dallo store.
Quando una chiave viene rimossa, la funzione attiva l' data evento. I dati dell'evento includono il nome dell'archivio, il nome della chiave che è stata rimossa, il valore rimosso, il nuovo valore per la chiave (null) e il tipo di azione "remove".
Facoltativamente, potete impedire l'attivazione dell' data evento.
Parametri
  • key: (Stringa) Il nome della chiave da rimuovere.
  • opzioni: (Oggetto) Un oggetto di opzioni. Le seguenti proprietà dell'oggetto sono valide:
    • silenzioso: Un valore di true impedisce l'attivazione dell' data evento. Il valore predefinito è false .
Valore restituito
Un boolean valore:
  • Un valore di true indica che la coppia chiave/valore è stata rimossa.
  • Il valore di false indica che l'archivio dati è invariato perché la chiave non è stata trovata nello store.

removeReference(key)

Rimuove un riferimento dallo store.
Parametri
  • key: Il riferimento chiave da rimuovere. Questo parametro corrisponde al key parametro della addReference funzione.
Valore restituito
Un boolean valore:
  • Un valore di true indica che il riferimento è stato rimosso.
  • Il valore di false indica che la chiave non era valida e che lo store non è cambiato.

reset(keepRemainData)

Ripristina i valori iniziali dei dati persistenti dello store. Facoltativamente, puoi rimuovere tutti gli altri dati dallo store. L'evento viene messo in pausa per lo store mentre lo store viene reimpostato. Questa funzione non restituisce alcun valore.
I valori iniziali sono forniti nella proprietà initialValues dell'oggetto config utilizzato per creare l'istanza dell'oggetto store.
Parametri
  • keepRestainData: (Booleano) Un valore true causa la persistenza dei dati non iniziali. Se si imposta il valore false, tutti i dati vengono rimossi, ad eccezione dei valori iniziali.
Ripristina i valori iniziali dei dati persistenti dello store. Facoltativamente, puoi rimuovere tutti gli altri dati dallo store. L'evento viene messo in pausa per lo store mentre lo store viene reimpostato. Questa funzione non restituisce alcun valore.
I valori iniziali sono forniti nella proprietà initialValues dell'oggetto config utilizzato per creare l'istanza dell'oggetto store.
Parametri
  • keepRestainData: (Booleano) Un valore true causa la persistenza dei dati non iniziali. Se si imposta il valore false, tutti i dati vengono rimossi, ad eccezione dei valori iniziali.

resolveReference(key, try)

Recupera una chiave di riferimento. Facoltativamente, è possibile specificare il numero di iterazioni da utilizzare per risolvere la corrispondenza migliore.
Parametri
  • key: (String) La chiave per la quale risolvere il riferimento. Questo key parametro corrisponde al key parametro della addReference funzione.
  • try: (Numero) Il numero di iterazioni da utilizzare.
Valore restituito
Un string valore che rappresenta la chiave di riferimento. Se non viene risolto alcun riferimento, viene restituito il valore del key parametro.

curriculumEventing()

Riprende l'evento per lo store in modo da attivare gli eventi. Questa funzione non definisce alcun parametro e non restituisce alcun valore.

setItem(key, value, options)

Aggiunge una coppia chiave/valore allo store.
Attiva l' data evento solo se il valore della chiave è diverso dal valore attualmente memorizzato per la chiave. Facoltativamente, potete impedire l'attivazione dell' data evento.
I dati dell'evento includono il nome dello store, la chiave, il valore precedente, il nuovo valore e il tipo di azione di set .
Parametri
  • key: (String) Il nome della chiave.
  • opzioni: (Oggetto) Un oggetto di opzioni. Le seguenti proprietà dell'oggetto sono valide:
    • silenzioso: Un valore di true impedisce l'attivazione dell' data evento. Il valore predefinito è false .
  • value: (Oggetto) Il valore da associare alla chiave.
Valore restituito
Un boolean valore:
  • Il valore di true indica che l'oggetto dati è stato memorizzato.
  • Il valore di false indica che l'archivio dati è invariato.

ContextHub.Store.JSONPStore

Uno store che contiene dati JSON. I dati vengono recuperati da un servizio JSONP esterno o, facoltativamente, da un servizio che restituisce dati JSON. Specificate i dettagli del servizio utilizzando la init funzione al momento della creazione di un'istanza di questa classe.
Lo store utilizza la persistenza in memoria (variabile Javascript). I dati dello store sono disponibili solo per tutta la durata della pagina.
ContextHub.Store.JSONPStore estende ContextHub.Store.Core ed eredita le funzioni di tale classe.

Funzioni (ContextHub.Store.JSONPStore)

configureService(serviceConfig, override)

Configura i dettagli per la connessione al servizio JSONP utilizzato da questo oggetto. Potete aggiornare o sostituire la configurazione esistente. La funzione non restituisce alcun valore.
Parametri
  • serviceConfig: Un oggetto che contiene le proprietà seguenti:
    • host: (String) Il nome del server o l'indirizzo IP.
    • jsonp: (Booleano) Il valore true indica che il servizio è un servizio JSONP, false in caso contrario. Se true, il callback {callback: "ContextHub.Callback. L'oggetto Object.name } viene aggiunto all'oggetto service.params.
    • params: (Oggetto) Parametri URL rappresentati come proprietà dell'oggetto. I nomi dei parametri sono nomi di proprietà e i valori dei parametri sono valori di proprietà.
    • percorso: (String) Il percorso del servizio.
    • porta: (Numero) Il numero di porta del servizio.
    • secure: (String o Boolean) Determina il protocollo da utilizzare per l'URL del servizio:
      • auto: //
      • true: https://
      • false: https://
  • override: (Boolean). Un valore di true determina la sostituzione della configurazione del servizio esistente con le proprietà di serviceConfig . Un valore di false determina l'unione delle proprietà di configurazione del servizio esistenti con quelle di serviceConfig .

getRawResponse()

Restituisce la risposta non elaborata memorizzata nella cache dall'ultima chiamata al servizio JSONP. La funzione non richiede parametri.
Valore restituito
Un oggetto che rappresenta la risposta non elaborata.

getServiceDetails()

Recupera l'oggetto del servizio per questo oggetto ContextHub.Store.JSONPStore. L'oggetto service contiene tutte le informazioni necessarie per creare l'URL del servizio.
Valore restituito
Un oggetto con le seguenti proprietà:
  • host: (String) Il nome del server o l'indirizzo IP.
  • jsonp: (Booleano) Il valore true indica che il servizio è un servizio JSONP, false in caso contrario. Se true, il callback {callback: "ContextHub.Callback. L'oggetto Object.name } viene aggiunto all'oggetto service.params.
  • params: (Oggetto) Parametri URL rappresentati come proprietà dell'oggetto. I nomi dei parametri sono nomi di proprietà e i valori dei parametri sono valori di proprietà.
  • percorso: (String) Il percorso del servizio.
  • porta: (Numero) Il numero di porta del servizio.
  • secure: (String o Boolean) Determina il protocollo da utilizzare per l'URL del servizio:
    • auto: //
    • true: https://
    • false: https://

getServiceURL(resolve)

Recupera l'URL del servizio JSONP.
Parametri
  • resolve: (Booleano) Determina se includere nell'URL i parametri risolti. Un valore di true risolve i parametri e false non lo è.
Valore restituito
Un string valore che rappresenta l'URL del servizio.

init(name, config)

inizializza l'oggetto ContextHub.Store.JSONPStore.
Parametri
  • name: (String) Il nome dello store.
  • config: (Oggetto) Un oggetto che contiene la proprietà service. L'oggetto JSONPStore utilizza le proprietà dell' service oggetto per creare l'URL del servizio JSONP:
    • eventDeferring: 32.
    • evento: L'oggetto ContextHub.Utils.Eventing per lo store. Il valore predefinito è l' ContextHub.eventing oggetto.
    • persistenza: L'oggetto ContextHub.Utils.Persistenza per lo store. Per impostazione predefinita, viene utilizzata la persistenza della memoria (oggetto Javascript).
    • service: (Oggetto)
      • host: (String) Il nome del server o l'indirizzo IP.
      • jsonp: (Booleano) Il valore true indica che il servizio è un servizio JSONP, false in caso contrario. Quando è true, l' {callback: "ContextHub.Callbacks.*Object.name*} oggetto viene aggiunto a service.params .
      • params: (Oggetto) Parametri URL rappresentati come proprietà dell'oggetto. I nomi e i valori dei parametri sono rispettivamente i nomi e i valori delle proprietà dell'oggetto.
      • percorso: (String) Il percorso del servizio.
      • porta: (Numero) Il numero di porta del servizio.
      • secure: (String o Boolean) Determina il protocollo da utilizzare per l'URL del servizio:
        • auto: //
        • true: https://
        • false: https://
      • timeout: (Numero) Il tempo di attesa che il servizio JSONP risponda prima del timeout, in millisecondi.
      • ttl: Il tempo minimo in millisecondi che trascorre tra le chiamate al servizio JSONP. (Vedere la funzione queryService ).

queryService(reload)

Interrompe il servizio JSONP remoto e memorizza nella cache la risposta. Se il tempo trascorso dalla precedente chiamata a questa funzione è inferiore al valore di config.service.ttl , il servizio non viene chiamato e la risposta nella cache non viene modificata. Facoltativamente, puoi forzare la chiamata al servizio. La config.service.ttl proprietà viene impostata quando si chiama la funzione init per inizializzare lo store.
Attiva l’evento ready al termine della query. Se l'URL del servizio JSONP non è impostato, la funzione non esegue alcuna operazione.
Parametri
  • ricaricare: (Booleano) Il valore true rimuove la risposta memorizzata nella cache e forza la chiamata al servizio JSONP.

reset

Ripristina i valori iniziali dei dati persistenti dello store e chiama il servizio JSONP. Facoltativamente, puoi rimuovere tutti gli altri dati dallo store. L'evento viene messo in pausa per lo store mentre i valori iniziali vengono reimpostati. Questa funzione non restituisce alcun valore.
I valori iniziali sono forniti nella proprietà initialValues dell'oggetto config utilizzato per creare l'istanza dell'oggetto store.
Parametri
  • keepRestainData: (Booleano) Un valore true causa la persistenza dei dati non iniziali. Se si imposta il valore false, tutti i dati vengono rimossi, ad eccezione dei valori iniziali.

resolveParameter(f)

Risolve il parametro specificato.

ContextHub.Store.PersistedJSONPStore

ContextHub.Store.PersistedJSONPStore estende ContextHub.Store.JSONPStore in modo da ereditare tutte le funzioni di tale classe. Tuttavia, i dati recuperati dal servizio JSONP vengono memorizzati in base alla configurazione della persistenza ContextHub. (Vedere Modalità di persistenza .)

ContextHub.Store.PersistedStore

ContextHub.Store.PersistedStore estende ContextHub.Store.Core in modo da ereditare tutte le funzioni di tale classe. I dati in questo archivio sono persistenti in base alla configurazione della persistenza ContextHub.

ContextHub.Store.SessionStore

ContextHub.Store.SessionStore estende ContextHub.Store.Core in modo da ereditare tutte le funzioni di tale classe. I dati in questo archivio sono persistenti utilizzando la persistenza in memoria (oggetto Javascript).

ContextHub.UI

Gestisce i moduli dell’interfaccia utente e i renderer dei moduli dell’interfaccia utente.

Funzioni (ContextHub.UI)

registerRenderer(moduleType, renderer, DontRender)

Registra un renderer di moduli dell'interfaccia utente con ContextHub. Dopo la registrazione del renderer, può essere utilizzato per creare moduli di interfaccia utente. Utilizzate questa funzione quando estendete ContextHub.UI.BaseModuleRenderer per creare un renderer di moduli interfaccia utente personalizzato.
Parametri
  • moduleType: (String) Identificatore per il renderer del modulo dell'interfaccia utente. Se un renderer è già registrato utilizzando il valore specificato, il renderer esistente non viene registrato prima della registrazione del renderer.
  • renderer: (String) Il nome della classe che esegue il rendering del modulo dell'interfaccia utente.
  • dontRender: (Booleano) Impostato true per impedire il rendering dell'interfaccia utente ContextHub dopo la registrazione del renderer. Il valore predefinito è false .
Esempio
Nell'esempio seguente, un renderer viene registrato come tipo di modulo contestexthub.browserinfo.
ContextHub.UI.registerRenderer('contexthub.browserinfo', new SurferinfoRenderer());

ContextHub.Utils.Eventing

Consente di eseguire il binding e la disassociazione delle funzioni agli eventi dell'archivio ContextHub. Accedere agli oggetti ContextHub.Utils.Eventing per uno store utilizzando la proprietà eventing dello store.

Funzioni (ContextHub.Utils.Eventing)

off(name, selector)

Separa una funzione da un evento.
Parametri
  • name: Il nome dell'evento per il quale si desidera annullare il binding della funzione.
  • selettore: Selettore che identifica il binding. (Vedere il selector parametro per le funzioni on e once ).
Valore restituito
Questa funzione non restituisce alcun valore.

on(nome, gestore, selettore, triggerForPastEvents)

Collega una funzione a un evento. La funzione viene chiamata ogni volta che si verifica l'evento. Facoltativamente, è possibile chiamare la funzione per gli eventi che si sono verificati in passato, prima che venga stabilito il binding.
Parametri
  • name: (Stringa) Il nome dell'evento a cui si sta effettuando il binding della funzione.
  • handler: (Funzione) La funzione da associare all'evento.
  • selettore: (String) Un identificatore univoco per il binding. È necessario che il selettore identifichi il binding se si desidera utilizzare la off funzione per rimuovere il binding.
  • triggerForPastEvents: (Boolean) Indica se il gestore deve essere eseguito per gli eventi che si sono verificati in passato. Un valore di true chiama il gestore per gli eventi passati. Un valore che false richiama il gestore per gli eventi futuri. Il valore predefinito è true .
Valore restituito
Quando l' triggerForPastEvents argomento è true , questa funzione restituisce un boolean valore che indica se l'evento si è verificato in passato:
  • true : L'evento si è verificato in passato e il gestore verrà chiamato.
  • false : L'evento non si è verificato in passato.
Se triggerForPastEvents è false , questa funzione non restituisce alcun valore.
Esempio
Nell'esempio seguente viene associata una funzione all'evento data dell'archivio di geolocalizzazione. La funzione compila un elemento sulla pagina con il valore per l'elemento di dati di latitudine dallo store.
<div class="location">
    <p>latitude: <span id="lat"></span></p>
</div>

<script>
    var geostore = ContextHub.getStore("geolocation");
    geostore.eventing.on(ContextHub.Constants.EVENT_DATA_UPDATE,getlat,"getlat");

    function getlat(){
       latitude = geostore.getItem("latitude");
       $("#lat").html(latitude);
    }
</script>

once(nome, gestore, selettore, triggerForPastEvents)

Collega una funzione a un evento. La funzione viene chiamata una sola volta, per la prima occorrenza dell'evento. Facoltativamente, è possibile chiamare la funzione per l'evento che si è verificato in passato, prima che venga stabilito il binding.
Parametri
  • name: (Stringa) Il nome dell'evento a cui si sta effettuando il binding della funzione.
  • handler: (Funzione) La funzione da associare all'evento.
  • selettore: (String) Un identificatore univoco per il binding. È necessario che il selettore identifichi il binding se si desidera utilizzare la off funzione per rimuovere il binding.
  • triggerForPastEvents: (Boolean) Indica se il gestore deve essere eseguito per gli eventi che si sono verificati in passato. Un valore di true chiama il gestore per gli eventi passati. Un valore che false richiama il gestore per gli eventi futuri. Il valore predefinito è true .
Valore restituito
Quando l' triggerForPastEvents argomento è true , questa funzione restituisce un boolean valore che indica se l'evento si è verificato in passato:
  • true : L'evento si è verificato in passato e il gestore verrà chiamato.
  • false : L'evento non si è verificato in passato.
Se triggerForPastEvents è false , questa funzione non restituisce alcun valore.

ContextHub.Utils.inheritance

Una classe di utilità che consente a un oggetto di ereditare le proprietà e i metodi di un altro oggetto.

Funzioni (ContextHub.Utils.inheritance)

inherit(child, parent)

Fa sì che un oggetto erediti le proprietà e i metodi di un altro oggetto.
Parametri
  • bambino: (Oggetto) L'oggetto che eredita.
  • parent: (Oggetto) L'oggetto che definisce le proprietà e i metodi ereditati.

ContextHub.Utils.JSON

Fornisce funzioni per la serializzazione di oggetti in formato JSON e la deserializzazione di stringhe JSON in oggetti.

Funzioni (ContextHub.Utils.JSON)

parse(data)

Analizza un valore di stringa come JSON e lo converte in un oggetto javascript.
Parametri
  • data: Un valore stringa in formato JSON.
Valore restituito
Un oggetto Javascript.
Esempio
Il codice ContextHub.Utils.JSON.parse("{'city':'Basel','country':'Switzerland','population':'173330'}"); restituisce il seguente oggetto:
Object {
   city: "Basel",
   country: "Switzerland",
   population: 173330
}

stringify(data)

Serializza i valori e gli oggetti JavaScript in valori stringa del formato JSON.
Parametri
  • data: Il valore o l'oggetto da serializzare. Questa funzione supporta valori booleani, array, numero, stringa e data.
Valore restituito
Il valore di stringa serializzato. Quando data egExp è un valore R, questa funzione restituisce un oggetto vuoto. Quando data è una funzione, restituisce undefined .
Esempio
Il codice seguente restituisce "{'city':'Basel','country':'Switzerland','population':'173330'}":
ContextHub.Utils.JSON.stringify({
   city: "Basel",
   country: "Switzerland",
   population: 173330
});

ContextHub.Utils.JSON.tree

Questa classe semplifica la manipolazione degli oggetti dati da memorizzare o da recuperare dagli store ContextHub.

Funzioni (ContextHub.Utils.JSON.tree)

addAllItems()

Crea una copia di un oggetto dati e vi aggiunge la struttura dati da un secondo oggetto. La funzione restituisce la copia e non modifica nessuno degli oggetti originali. Quando le strutture ad albero dati dei due oggetti contengono chiavi identiche, il valore del secondo oggetto sovrascrive il valore del primo oggetto.
Parametri
  • struttura: L'oggetto copiato.
  • SecondTree: L'oggetto unito alla copia dell' tree oggetto.
Valore restituito
Un oggetto che contiene i dati uniti.

cleanup()

Crea una copia di un oggetto, trova e rimuove elementi nella struttura dati che non contengono valori, valori null o valori non definiti e restituisce la copia.
Parametri
  • struttura: L'oggetto da pulire.
Valore restituito
Una copia della struttura ad albero che viene pulita.

getItem()

Recupera il valore da un oggetto per la chiave.
Parametri
  • struttura: L'oggetto data.
  • key: Chiave per il valore da recuperare.
Valore restituito
Il valore corrispondente alla chiave. Quando la chiave dispone di chiavi figlio, questa funzione restituisce un oggetto complesso. Quando il tipo del valore della chiave è undefined , null viene restituito.
Esempio
Considerare il seguente oggetto Javascript:
myObject {
  user: {
    location: {
      city: "Basel",
        details: {
          population: 173330,
          elevation: 260
        }
      }
    }
  }

Il seguente codice di esempio restituisce il valore 260 :
ContextHub.Utils.JSON.tree.getItem(myObject, "/user/location/details/elevation");

Il codice di esempio seguente recupera il valore per una chiave con chiavi figlio:
ContextHub.Utils.JSON.tree.getItem(myObject, "/user");

La funzione restituisce l'oggetto seguente:
Object {
  location: {
    city: "Basel",
    details: {
      population: 173330,
      elevation: 260
    }
  }
}

getKeys()

Recupera tutte le chiavi dalla struttura dati di un oggetto. Facoltativamente, è possibile recuperare solo le chiavi degli elementi secondari di una chiave specifica. Facoltativamente, potete anche specificare un ordinamento delle chiavi recuperate.
Parametri
  • struttura: L'oggetto da cui recuperare le chiavi della struttura dati.
  • parent: (Facoltativo) Chiave di un elemento nella struttura dei dati per la quale si desidera recuperare le chiavi degli elementi secondari.
  • ordine: (Facoltativo) Funzione che determina l'ordine delle chiavi restituite. (Vedere Array.prototype.sort in Mozilla Developer Network.)
Valore restituito
Un array di chiavi.
Esempio
Considerare il seguente oggetto:
myObject {
  location: {
    weather: {
      temperature: "28C",
      humidity: "77%",
      precipitation: "10%",
      wind: "8km/h"
    },
    city: "Basel",
    country: "Switzerland",
    longitude: 7.5925727,
    latitude: 47.557421
  }
}

Lo ContextHub.Utils.JSON.tree.getKeys(myObject); script restituisce la seguente matrice:
["/location", "/location/city", "/location/country", "/location/latitude", "/location/longitude", "/location/weather", "/location/weather/humidity", "/location/weather/precipitation", "/location/weather/temperature", "/location/weather/wind"]

removeItem()

Crea una copia di un dato oggetto, rimuove il ramo specificato dalla struttura dei dati e restituisce la copia modificata.
Parametri
  • struttura: Un oggetto dati.
  • key: La chiave da rimuovere.
Valore restituito
Una copia dell'oggetto dati originale con la chiave rimossa.
Esempio
Considerare il seguente oggetto:
myObject {
  one: {
    foo: "bar",
    two: {
      three: {
        four: {
          five: 5,
          six: 6
        }
      }
    }
  }
}

Lo script di esempio seguente rimuove il ramo /uno/due/tre/quattro dalla struttura dei dati:
myObject = ContextHub.Utils.JSON.tree.removeItem(myObject, "/one/two/three/four");

La funzione restituisce l'oggetto seguente:
myObject {
  one: {
    foo: "bar"
  }
}

sanizeKey(key)

Rimuove i valori stringa per renderli utilizzabili come chiavi. Per eliminare una stringa, questa funzione esegue le azioni seguenti:
  • Riduce più barre consecutive a una singola barra.
  • Rimuove gli spazi bianchi dall'inizio e dalla fine della stringa.
  • Divide il risultato in un array di stringhe delimitate da barre.
Utilizzare l'array risultante per creare una chiave utilizzabile. Parametri
  • key: La string pulizia.
Valore restituito
Un array di string valori in cui ogni stringa è la porzione di key cui sono state delimitate le barre. rappresenta la chiave sanizzata. Se la matrice sanizzata ha una lunghezza pari a zero, questa funzione restituisce null .
Esempio
Il codice seguente rimuove una stringa per generare l'array ["this", "is", "a", "path"] e genera quindi la chiave "/this/is/a/path" dall'array:
var key = " / this////is/a/path ";
ContextHub.Utils.JSON.tree.sanitizeKey(key)
"/" + ContextHub.Utils.JSON.tree.sanitizeKey(key).join("/");

setItem(tree, key, value)

Aggiunge una coppia chiave/valore alla struttura dati di una copia di un oggetto. Per informazioni sulle strutture ad albero dei dati, vedere Persistenza .
Parametri
  • struttura: Un oggetto dati.
  • key: Chiave da associare al valore che si sta aggiungendo. La chiave è il percorso dell'elemento nella struttura dei dati. Questa funzione richiede ContextHub.Utils.JSON.tree.sanitize di rimuovere completamente la chiave prima di aggiungerla.
  • value: Valore da aggiungere alla struttura dati.
Valore restituito
Una copia dell' tree oggetto che include la coppia key / value .
Esempio
Considerate il seguente codice JavaScript:
var myObject = {
     user: {
        location: {
           city: "Basel"
           }
        }
     };

var myKey = "/user/location/details";

var myValue = {
      population: 173330,
      elevation: 260
     };

myObject = ContextHub.Utils.JSON.tree.setItem(myObject, myKey, myValue);

L'oggetto myObject ha il valore seguente:

ContextHub.Utils.storeCandidate

Consente di registrare i candidati allo store e di ottenere i candidati allo store registrati.

Funzioni (ContextHub.Utils.storeCandidate)

getRegisteredCandiates(storeType)

Restituisce i tipi di store registrati come candidati store. Recuperare i candicati registrati di un tipo di archivio specifico o di tutti i tipi di store.
Parametri
  • storeType: (String) Il nome del tipo di store. Vedere il storeType parametro della funzione .
Valore restituito
Un oggetto di tipi di store. Le proprietà dell'oggetto sono i nomi dei tipi di archivio e i valori delle proprietà sono un array di candidati store registrati.

getStoreFromCandidate(storeType)

Restituisce un tipo di archivio dai candidati registrati. Se viene registrato più di un tipo di store con lo stesso nome, la funzione restituisce il tipo di store con la priorità più alta.
Parametri
  • storeType: (String) Il nome del candidato dello store. Vedere il storeType parametro della funzione .
Valore restituito
Un oggetto che rappresenta il candidato dello store registrato. Se il tipo di archivio richiesto non è registrato, viene generato un errore.

getSupportedStoreTypes()

Restituisce i nomi dei tipi di store registrati come candidati store. Questa funzione non richiede parametri.
Valore restituito
Un array di valori stringa, in cui ogni stringa è il tipo di storetype con cui è stato registrato un candidato all'archiviazione. Vedere il storeType parametro della funzione .

registerStoreCandidate(store, storeType, priority, apply)

Registra un oggetto store come candidato allo store utilizzando un nome e una priorità.
La priorità è un numero che indica l'importanza degli store con lo stesso nome. Quando un candidato del negozio viene registrato con lo stesso nome di un candidato del negozio già registrato, viene utilizzato il candidato con la priorità più alta. Quando si registra un candidato per un negozio, lo store viene registrato solo se la priorità è superiore ai candidati dello store registrato dello stesso nome.
Parametri
  • store: (Oggetto) L'oggetto store da registrare come candidato store.
  • storeType: (String) Il nome del candidato dello store. Questo valore è richiesto quando si crea un'istanza del candidato store.
  • priorità: (Numero) La priorità del candidato del negozio.
  • si applica: (Funzione) La funzione da richiamare che valuta l'applicabilità dello store nell'ambiente corrente. La funzione deve restituire true se lo store è applicabile e false in caso contrario. Il valore predefinito è una funzione che restituisce true: function() {return true;}
Esempio
ContextHub.Utils.storeCandidates.registerStoreCandidate(myStoreCandidate,
                                'contexthub.mystorecandiate', 0);