ContextHub 확장

마지막 업데이트: 2025년 2월 6일

작성 대상:

  • 관리자
  • 개발자

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

사용자 지정 스토어 후보 생성

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

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

contexthub.store.[storeType]

범주의 storeType 부분은 저장소 후보가 등록된 storeType입니다. ContextHub 저장소 후보 등록을 참조하세요. 예를 들어 storeType이 contexthub.mystore인 경우 클라이언트 라이브러리 폴더의 범주는 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.browserinfo의 moduleType에 대해 클라이언트 라이브러리 폴더의 범주는 contexthub.module.contexthub.browserinfo이어야 합니다.

Experience Manager