Estensione di ContextHub extending-contexthub

Definisci nuovi tipi di store e moduli ContextHub quando quelli forniti non soddisfano i requisiti della soluzione.

Creazione di candidati per store personalizzati creating-custom-store-candidates

Gli store ContextHub vengono creati dai candidati di store registrati. Per creare un archivio personalizzato, crea e registra un candidato per lo store.

Il file JavaScript che include il codice per la creazione e la registrazione del candidato dell'archivio deve essere incluso in una cartella della libreria client. La categoria della cartella deve corrispondere al seguente pattern:

contexthub.store.[storeType]

La parte [storeType] della categoria è storeType con cui è registrato il candidato dell'archivio. (Vedi Registrazione di un candidato all'archivio ContextHub). Ad esempio, per storeType di contexthub.mystore, la categoria della cartella della libreria client deve essere contexthub.store.contexthub.mystore.

Creazione di un candidato per l’archivio ContextHub creating-a-contexthub-store-candidate

Per creare un candidato per un archivio, utilizzare la funzione ContextHub.Utils.inheritance.inherit per estendere uno degli archivi di base:

Ogni archivio di base estende l'archivio ContextHub.Store.Core.

Nell'esempio seguente viene creata l'estensione più semplice del candidato per l'archivio ContextHub.Store.PersistedStore:

myStoreCandidate = function(){};
ContextHub.Utils.inheritance.inherit(myStoreCandidate,ContextHub.Store.PersistedStore);

Realisticamente, i candidati all’archivio personalizzato definiscono funzioni aggiuntive o sovrascrivono la configurazione iniziale dell’archivio. Diversi candidati per l'archivio di esempio sono installati nell'archivio seguente /libs/granite/contexthub/components/stores. Per apprendere da questi esempi, utilizzare CRXDE Lite per aprire i file JavaScript.

Registrazione di un candidato per l’archivio ContextHub registering-a-contexthub-store-candidate

Registra un candidato per store per integrarlo con il framework ContextHub e consentirne la creazione. Per registrare un candidato dell'archivio, utilizzare la funzione registerStoreCandidate della classe ContextHub.Utils.storeCandidates.

Quando si registra un candidato per un punto vendita, è necessario specificare un nome per il tipo di punto vendita. Quando si crea un archivio dal candidato, si utilizza il tipo di archivio per identificare il candidato su cui si basa.

Quando si registra un candidato per lo store, si indica la sua priorità. Quando un candidato per lo store viene registrato utilizzando lo stesso tipo di store di un candidato per lo store già registrato, viene utilizzato il candidato con la priorità più elevata. Pertanto, puoi sostituire i candidati store esistenti con nuove implementazioni.

ContextHub.Utils.storeCandidates.registerStoreCandidate(myStoreCandidate,
                                'contexthub.mystorecandidate', 0);

In genere è necessario un solo candidato e la priorità può essere impostata su 0. Ma se sei interessato, puoi scoprire altre registrazioni avanzate, che consente di scegliere una delle poche implementazioni dello store in base alla condizione JavaScript (applies) e alla priorità del candidato.

Creazione di tipi di moduli dell’interfaccia utente ContextHub creating-contexthub-ui-module-types

Crea tipi di moduli di interfaccia utente personalizzati quando quelli installati con ContextHub non soddisfano i tuoi requisiti. Per creare un tipo di modulo dell'interfaccia utente, creare un modulo di rendering del modulo dell'interfaccia utente estendendo la classe ContextHub.UI.BaseModuleRenderer e quindi registrandola con ContextHub.UI.

Per creare un modulo di rendering dell'interfaccia utente, creare un oggetto Class contenente la logica per il rendering del modulo dell'interfaccia utente. Come minimo, la classe deve eseguire le azioni seguenti:

L'origine di ContextHub.UI.BaseModuleRenderer si trova in /libs/granite/contexthub/code/ui/container/js/ContextHub.UI.BaseModuleRenderer.js. Per registrare il renderer, utilizzare il metodo registerRenderer della classe ContextHub.UI. Specifica un nome per il tipo di modulo. Quando gli amministratori creano un modulo di interfaccia utente basato su questo renderer, specificano questo nome.

Crea e registra la classe renderer in una funzione anonima a esecuzione automatica. L’esempio seguente è basato sul codice sorgente del modulo dell’interfaccia utente contexthub.browserinfo. Questo modulo UI è una semplice estensione della classe ContextHub.UI.BaseModuleRenderer.

;(function() {

    var SurferinfoRenderer = new Class({
        extend: ContextHub.UI.BaseModuleRenderer,

        defaultConfig: {
            icon: 'coral-Icon--globe',
            title: 'Browser/OS Information',

            storeMapping: {
                surferinfo: 'surferinfo'
            },

            template:
                '<p>{{surferinfo.browser.family}} {{surferinfo.browser.version}}</p>' +
                '<p>{{surferinfo.os.name}} {{surferinfo.os.version}}</p>'
        }
    });

    ContextHub.UI.registerRenderer('contexthub.browserinfo', new SurferinfoRenderer());

}());

Il file JavaScript che include il codice che crea e registra il renderer deve essere incluso in una cartella della libreria client. La categoria della cartella deve corrispondere al seguente pattern:

contexthub.module.[moduleType]

La parte [moduleType] della categoria è moduleType con cui è registrato il modulo di rendering. Ad esempio, per moduleType di contexthub.browserinfo, la categoria della cartella della libreria client deve essere contexthub.module.contexthub.browserinfo.