ContextHub 확장

제공된 항목이 솔루션 요구 사항을 충족하지 못할 경우 새로운 유형의 ContextHub 저장소 및 모듈을 정의합니다.

사용자 지정 저장소 후보 만들기

ContextHub 저장소는 등록된 저장소 후보로부터 만들어집니다. 사용자 지정 스토어를 만들려면 저장소 후보자를 만들고 등록해야 합니다.

저장소 후보를 만들고 등록하는 코드가 포함된 Javascript 파일은 클라이언트 라이브러리 폴더에 포함해야 합니다. 폴더의 카테고리는 다음 패턴과 일치해야 합니다.

contexthub.store.[storeType]

카테고리의 storeType 부분은 저장소 후보가 등록된 storeType입니다. (ContextHub 저장소 후보 등록 참조). 예를 들어 contexthub.mystore storeType의 경우 클라이언트 라이브러리 폴더의 카테고리는 contexthub.store.contexthub.mystore이어야 합니다.

ContextHub 저장소 후보 만들기

저장소 후보를 만들려면 ContextHub.Utils.inheritance.inherit 함수를 사용하여 기본 저장소 중 하나를 확장합니다.

각 기본 스토어는 ContextHub.Store.Core 스토어를 확장합니다.

다음 예에서는 ContextHub.Store.PersistedStore 저장소 후보의 가장 간단한 확장을 만듭니다.

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

현실적으로, 사용자 지정 스토어 후보자는 추가 기능을 정의하거나 스토어의 초기 구성을 재정의합니다. 일부 샘플 저장소 후보/libs/granite/contexthub/components/stores 아래의 저장소에 설치됩니다.

ContextHub 저장소 후보 등록

저장소 후보를 등록하여 ContextHub 프레임워크와 통합하고 저장소 만들기를 활성화합니다. 저장소 후보를 등록하려면 ContextHub.Utils.storeCandidates 클래스의 registerStoreCandidate 함수를 사용합니다.

저장소 후보자를 등록할 때 저장소 유형의 이름을 입력합니다. 후보자로부터 저장소를 만들 때 저장소 유형을 사용하여 저장소 유형이 기반으로 하는 후보를 식별합니다.

저장소 후보자를 등록할 때 우선순위가 표시됩니다. 이미 등록한 점포후보자와 같은 타입의 상표를 사용하여 상인등록을 하면 우선순위가 높은 후보자를 사용한다. 따라서 새 구현으로 기존 저장소 후보자를 재정의할 수 있습니다.

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

대부분의 경우 한 명의 후보만 필요하며 우선 순위를 0로 설정할 수 있지만, 관심이 있는 경우에는 더 고급 등록에 대해 알 수 있습니다. 고급 등록에서는 몇 가지 스토어 구현 중 하나를 javascript 조건(applies)과 후보 우선 순위를 기준으로 선택할 수 있습니다.

ContextHub UI 모듈 유형 만들기

ContextHub🔗과 함께 설치된 이 요구 사항을 충족하지 않을 경우 사용자 지정 UI 모듈 유형을 만듭니다. UI 모듈 유형을 만들려면 ContextHub.UI.BaseModuleRenderer 클래스를 확장한 다음 ContextHub.UI에 등록하여 새 UI 모듈 렌더러를 만듭니다.

UI 모듈 렌더러를 만들려면 UI 모듈을 렌더링하는 논리를 포함하는 Class 개체를 만듭니다. 최소한 클래스는 다음 작업을 수행해야 합니다.

  • ContextHub.UI.BaseModuleRenderer 클래스를 확장합니다. 이 클래스는 모든 UI 모듈 렌더러에 대한 기본 구현입니다. Class 개체는 이 클래스의 이름을 확장되는 것으로 지정하는 데 사용하는 extend 속성을 정의합니다.
  • 기본 구성을 제공합니다. defaultConfig 속성을 만듭니다. 이 속성은 contexthub.base UI 모듈에 대해 정의된 속성과 필요한 기타 속성을 포함하는 객체입니다.

ContextHub.UI.BaseModuleRenderer의 소스가 /libs/granite/contexthub/code/ui/container/js/ContextHub.UI.BaseModuleRenderer.js에 있습니다. 렌더러를 등록하려면 ContextHub.UI 클래스의 registerRenderer 메서드를 사용합니다. 모듈 유형의 이름을 입력해야 합니다. 관리자는 이 렌더러를 기반으로 UI 모듈을 만들 때 이 이름을 지정합니다.

렌더러 클래스를 만들어 자체 실행 익명 함수에서 등록합니다. 다음 예제는 contexthub.browserinfo UI 모듈의 소스 코드를 기반으로 합니다. 이 UI 모듈은 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());

}());

렌더러를 만들고 등록하는 코드가 포함된 Javascript 파일은 클라이언트 라이브러리 폴더에 포함해야 합니다. 폴더의 카테고리는 다음 패턴과 일치해야 합니다.

contexthub.module.[moduleType]

카테고리의 [moduleType] 부분은 모듈 렌더러가 등록된 moduleType입니다. 예를 들어 contexthub.browserinfomoduleType의 경우 클라이언트 라이브러리 폴더의 카테고리는 contexthub.module.contexthub.browserinfo여야 합니다.

이 페이지에서는