ContextHub コンポーネントをページに追加すると、ContextHub JavaScript API がスクリプトで使用できるようになります。
ContextHub JavaScript API によって定義される定数値です。
ContextHub ストアに対して発生する名前付きイベントを次の表に示します。ContextHub.Utils.Eventing も参照してください。
定数 | 説明 | 値 |
---|---|---|
ContextHub.Constants.EVENT_NAMESPACE | ContextHub のイベント名前空間 | ch |
ContextHub.Constants.EVENT_ALL_STORES_READY | 必要なすべてのストアが登録、初期化され、使用可能な状態であることを示します | all-stores-ready |
ContextHub.Constants.EVENT_STORES_PARTIALLY_READY | 指定されたタイムアウト内に一部のストアが初期化されなかったことを示します | stores-partially-ready |
ContextHub.Constants.EVENT_STORE_REGISTERED | ストアの登録時に実行されます | store-registered |
ContextHub.Constants.EVENT_STORE_READY | ストアの動作準備ができていることを示します。データが取得されると実行される JSONP ストアを除いて、登録後すぐにトリガーされます。 | store-ready |
ContextHub.Constants.EVENT_STORE_UPDATED | ストアが永続性を更新した場合に実行されます | store-updated |
ContextHub.Constants.PERSISTENCE_CONTAINER_NAME | 永続コンテナ名 | ContextHubPersistence |
ContextHub.Constants.SERVICE_RAW_RESPONSE_KEY | 未加工の JSON 結果が格納される特定の永続キー名を格納します | /_/raw-response |
ContextHub.Constants.SERVICE_RESPONSE_TIME_KEY | JSON データがフェッチされた日時を示す特定のタイムスタンプを格納します | /_/response-time |
ContextHub.Constants.SERVICE_LAST_URL_KEY | 前回の呼び出しで使用された JSON サービスの特定の URL を格納 | /_/URL |
ContextHub.Constants.IS_CONTAINER_EXPANDED | ContextHub の UI が展開されているかどうかを示します | /_/container-expanded |
次の表に、ContextHub UI に関して発生するイベントの名前を示します。
定数 | 説明 | 値 |
---|---|---|
ContextHub.Constants.EVENT_UI_MODE_REGISTERED | モードが登録されると実行されます | ui-mode-registered |
ContextHub.Constants.EVENT_UI_MODE_UNREGISTERED | モードが未登録の場合に実行されます | ui-mode-unregistered |
ContextHub.Constants.EVENT_UI_MODE_RENDERER_REGISTERED | モードレンダラーが登録されると実行されます | ui-mode-renderer-registered |
ContextHub.Constants.EVENT_UI_MODE_RENDERER_UNREGISTERED | モードレンダラーの登録が解除されると実行されます | ui-mode-renderer-unregistered |
ContextHub.Constants.EVENT_UI_MODE_ADDED | 新しいモードが追加されると実行されます | ui-mode-added |
ContextHub.Constants.EVENT_UI_MODE_REMOVED | モードが削除されると実行されます | ui-mode-removed |
ContextHub.Constants.EVENT_UI_MODE_SELECTED | ユーザーがモードを選択した場合に実行されます | ui-mode-selected |
ContextHub.Constants.EVENT_UI_MODULE_REGISTERED | 新しいモジュールが登録されると実行されます | ui-module-registered |
ContextHub.Constants.EVENT_UI_MODULE_UNREGISTERED | モジュールの登録が解除されると実行されます | ui-module-unregistered |
ContextHub.Constants.EVENT_UI_MODULE_RENDERER_REGISTERED | モジュールレンダラーが登録されると実行されます | ui-module-renderer-registered |
ContextHub.Constants.EVENT_UI_MODULE_RENDERER_UNREGISTERED | モジュールレンダラーの登録が解除されると実行されます | ui-module-renderer-unregistered |
ContextHub.Constants.EVENT_UI_MODULE_ADDED | 新しいモジュールが追加されると実行されます | ui-module-added |
ContextHub.Constants.EVENT_UI_MODULE_REMOVED | モジュールが削除されると実行されます | ui-module-removed |
ContextHub.Constants.EVENT_UI_CONTAINER_ADDED | UI コンテナがページに追加されると実行されます | ui-container-added |
ContextHub.Constants.EVENT_UI_CONTAINER_OPENED | ContextHub UI が開かれると実行されます | ui-container-opened |
ContextHub.Constants.EVENT_UI_CONTAINER_CLOSED | ContextHub UI が折りたたまれると実行されます | ui-container-closed |
ContextHub.Constants.EVENT_UI_PROPERTY_MODIFIED | プロパティが変更されると実行されます | ui-property-modified |
ContextHub.Constants.EVENT_UI_RENDERED | ContextHub UI がレンダリングされるたび(例:プロパティの変更後)に実行されます | ui-rendered |
ContextHub.Constants.EVENT_UI_INITIALIZED | UI コンテナが初期化されると実行されます | ui-initialized |
ContextHub.Constants.ACTIVE_UI_MODE | アクティブな UI モードを示します。 | /_/active-ui-mode |
ContextHub オブジェクトを使用して、すべてのストアにアクセスできます。
登録されている ContextHub ストアをすべて返します。
この関数にパラメーターはありません。
戻り値
すべての ContextHub ストアを格納したオブジェクト。各ストアは、ストアと同じ名前を使用するオブジェクトです。
例
次の例では、すべてのストアを取得してから、geolocation ストアを取得しています。
var allStores = ContextHub.getAllStores();
var geoloc = allStores.geolocation
ストアを JavaScript オブジェクトとして取得します。
パラメーター
戻り値
ストアを表すオブジェクト。
例
次の例では、geolocation ストアを取得します。
var geoloc = ContextHub.getStore("geolocation");
ContextHub セグメントを表します。ContextHub.SegmentEngine.SegmentManager を使用して、セグメントを取得します。
セグメント名を String 値として返します。
セグメント定義のリポジトリパスを String 値として返します。
ContextHub セグメントへのアクセスを提供します。
現在のコンテキストで解決されたセグメントを返します。この関数にパラメーターはありません。
戻り値
ContextHub.SegmentEngine.Segment オブジェクトの配列。
ContextHub ストアのベースクラス。
ContextHub.Utils.Eventing オブジェクト。このオブジェクトを使用して、関数をストアイベントにバインドします。デフォルト値と初期化については、init(name,config) を参照してください。
ストアの名前。
ContextHub.Utils.Persistence オブジェクト。デフォルト値と初期化については、[init(name,config)](/docs/experience-manager-65/developing/personlization/contexthub-api.html?lang=ja#init-name-config).
を参照してください。
データオブジェクトまたは配列とストアデータを結合します。オブジェクトのキーと値の各ペアまたは配列が(setItem
関数を使用して)ストアに追加されます。
値にオブジェクトを使用できます。
パラメーター
options
setItem(key,value,) の options パラメーターを参照してください。戻り値
boolean
値:
true
は、データオブジェクトが保存されたことを示します。false
は、データストアが変更されていないことを示します。1 つのキーから別のキーへの参照を作成します。キーは自分自身を参照できません。
パラメーター
key: anotherKey
を参照するキー。
anotherkey:key
に参照されるキー。
戻り値
boolean
値:
true
値は、参照が追加されたことを示します。false
値は、参照が追加されなかったことを示します。このストアに対する ready
イベントを発生させます。この関数にパラメーターはなく、値を返しません。
すべてのデータをストアから削除します。この関数にパラメーターおよび戻り値はありません。
キーに関連付けられている値を返します。
パラメーター
戻り値
キーの値を表すオブジェクト。
ストアからキーを取得します。オプションで、ContextHub フレームワークが内部的に使用するキーを取得できます。
パラメーター
true
は、内部的に使用されているキーを結果に含めます。このようなキーは、アンダースコア("_")文字で始まります。デフォルト値は false
です。戻り値
キー名(string
値)の配列。
ストアから参照を取得します。
戻り値
参照キーを被参照キーのインデックスとして使用する配列。
参照キーは、key
関数の addReference
パラメーターに対応しています。
被参照キーは、anotherKey
関数の addReference
パラメーターに対応しています。
データツリーをストアから取得します。オプションで、ContextHub フレームワークが内部的に使用しているキーと値のペアを含めることができます。
パラメーター
includeInternals:
:値 true
は、内部的に使用されているキーと値のペアを結果に含めます。このデータのキーは、アンダースコア("_")文字で始まります。デフォルト値は false
です。戻り値
データツリーを表すオブジェクト。キーは、オブジェクトのプロパティ名です。
ストアを初期化します。
ストアデータを空のオブジェクトに設定します。
ストア参照を空のオブジェクトに設定します。
eventChannel は data:name です。name はストア名です。
storeDataKey は /store/name です。name はストア名です。
パラメーター
name:ストアの名前。
config:設定プロパティを格納したオブジェクト。
このストアに対するイベンティングが一時停止されているかどうかを判断します。
戻り値
次の boolean 値。
true
:イベンティングが一時停止されているので、このストアに対するイベントは発生しません。false
:イベンティングが一時停止されていないので、このストアに対するイベントが発生します。このストアに対するイベンティングを一時停止して、イベントが発生しないようにします。この関数にパラメーターは必要なく、値を返しません。
キーと値のペアをストアから削除します。
キーが削除されると、この関数が data
イベントを発生させます。イベントデータには、ストア名、削除されたキーの名前、削除された値、キーの新しい値(null)およびアクションタイプ「remove」が含まれます。
オプションで、data
イベントを発生させないようにすることができます。
パラメーター
key:(String)削除するキーの名前。
options:(Object)オプションからなるオブジェクト。次のオブジェクトプロパティが有効です。
true
は、data
イベントが発生しないようにします。デフォルト値は false
です。戻り値
boolean
値:
true
値は、キーと値のペアが削除されたことを示します。false
値は、キーがストアに見つからなかったのでデータストアが変更されていないことを示します。参照をストアから削除します。
パラメーター
key
関数の addReference
パラメーターに対応しています。戻り値
boolean
値:
true
値は、参照が削除されたことを示します。false
値は、キーが有効ではなかったのでストアが変更されていないことを示します。ストアの永続データの初期値を再設定します。オプションで、その他すべてのデータをストアから削除できます。ストアが再設定されている間、このストアに対するイベンティングは一時停止されます。この関数は値を返しません。
初期値は、ストアオブジェクトのインスタンス化に使用される config オブジェクトの initialValues プロパティで提供されます。
パラメーター
ストアの永続データの初期値を再設定します。オプションで、その他すべてのデータをストアから削除できます。ストアが再設定されている間、このストアに対するイベンティングは一時停止されます。この関数は値を返しません。
初期値は、ストアオブジェクトのインスタンス化に使用される config オブジェクトの initialValues プロパティで提供されます。
パラメーター
被参照キーを取得します。オプションで、最良一致の解決に使用する繰り返し回数を指定できます。
パラメーター
key:(String)参照を解決するためのキー。この key
パラメーターは、key
関数の addReference
パラメーターに対応しています。
retry:(Number)使用する繰り返し回数。
戻り値
被参照キーを表す string
値。参照が解決されない場合は、key
パラメーターの値が返されます。
このストアに対するイベンティングを再開し、イベントが発生するようにします。この関数はパラメーターを定義せず、値を返しません。
キーと値のペアをストアに追加します。
キーの値がそのキーに対して現在保存されている値と異なる場合にのみ data
イベントを発生させます。オプションで、data
イベントを発生させないようにすることができます。
イベントデータには、ストア名、キー、前の値、新しい値およびアクションタイプ set
が含まれます。
パラメーター
key:(String)キーの名前。
options:(Object)オプションからなるオブジェクト。次のオブジェクトプロパティが有効です。
true
は、data
イベントが発生しないようにします。デフォルト値は false
です。value:(Object)キーに関連付ける値。
戻り値
boolean
値:
true
は、データオブジェクトが保存されたことを示します。false
は、データストアが変更されていないことを示します。JSON データを格納するストア。データは外部の JSONP サービスから取得されるか、オプションで JSON データを返すサービスから取得されます。このクラスのインスタンスを作成する際に、 関数を使用してサービスの詳細を指定します。init
ストアは、インメモリパーシスタンス(JavaScript 変数)を使用します。ストアデータは、ページが持続している間のみ使用可能です。
ContextHub.Store.JSONPStore は ContextHub.Store.Core を拡張したものなので、このクラスの関数を継承しています。
このオブジェクトが使用する JSONP サービスへの接続の詳細を設定します。既存の設定を更新または置換できます。この関数は値を返しません。
パラメーター
serviceConfig:次のプロパティを格納したオブジェクト。
host:(String)サーバーの名前または IP アドレス。
jsonp:(Boolean)値 true はサービスが JSONP サービスであることを示します。それ以外は false です。true の場合、{callback: "ContextHub.Callbacks.Object.name} オブジェクトが service.params オブジェクトに追加されます。
params:(オブジェクト)オブジェクトのプロパティとして表される URL パラメーター。パラメーター名はプロパティ名で、パラメーター値はプロパティ値です。
path:(String)サービスへのパス。
port:(Number)サービスのポート番号。
secure:(String または Boolean)サービス URL に使用するプロトコルを決定します。
override:(Boolean)値が true
の場合、既存のサービス設定を serviceConfig
のプロパティで置き換えます。値が false
の場合、既存のサービス設定プロパティを serviceConfig
のプロパティと結合します。
JSONP サービスへの最後の呼び出し以降キャッシュされている未加工の応答を返します。この関数にパラメーターは必要ありません。
戻り値
未加工の応答を表すオブジェクト。
この ContextHub.Store.JSONPStore オブジェクトのサービスオブジェクトを取得します。サービスオブジェクトには、サービス URL を作成するのに必要なすべての情報が格納されています。
戻り値
次のプロパティを持つオブジェクト。
host:(String)サーバーの名前または IP アドレス。
jsonp:(Boolean)値 true はサービスが JSONP サービスであることを示します。それ以外は false です。true の場合、{callback: "ContextHub.Callbacks.Object.name} オブジェクトが service.params オブジェクトに追加されます。
params:(オブジェクト)オブジェクトのプロパティとして表される URL パラメーター。パラメーター名はプロパティ名で、パラメーター値はプロパティ値です。
path:(String)サービスへのパス。
port:(Number)サービスのポート番号。
secure:(String または Boolean)サービス URL に使用するプロトコルを決定します。
JSONP サービスの URL を取得します。
パラメーター
true
はパラメーターを解決し、false
は解決しません。戻り値
サービス URL を表す string
値。
ContextHub.Store.JSONPStore オブジェクトを初期化します。
パラメーター
name:(String)ストアの名前。
config:(Object)サービスプロパティを格納するオブジェクト。JSONPStore オブジェクトは、service
オブジェクトのプロパティを使用して、JSONP サービスの URL を組み立てます。
eventDeferring:32
eventing:このストアの ContextHub.Utils.Eventing オブジェクト。デフォルト値は ContextHub.eventing
オブジェクトです。
persistence:このストアの ContextHub.Utils.Persistence オブジェクト。デフォルトでは、メモリパーシスタンスが使用されます(JavaScript オブジェクト)。
service:(オブジェクト)
host:(String)サーバーの名前または IP アドレス。
jsonp:(Boolean)値 true はサービスが JSONP サービスであることを示します。それ以外は false です。true の場合、{callback: "ContextHub.Callbacks.*Object.name*}
オブジェクトは service.params
に追加されます。
params:(オブジェクト)オブジェクトのプロパティとして表される URL パラメーター。パラメーターの名前と値は、それぞれオブジェクトのプロパティの名前と値です。
path:(String)サービスへのパス。
port:(Number)サービスのポート番号。
secure:(String または Boolean)サービス URL に使用するプロトコルを決定します。
timeout:(Number)タイムアウトまでに JSONP サービスの応答を待機する時間(ミリ秒単位)。
ttl:JSONP サービスの最小呼び出し間隔(ミリ秒単位)。(queryService 関数を参照)。
リモート JSONP サービスをクエリし、応答をキャッシュします。この関数の前回の呼び出しからの時間が config.service.ttl
の値より小さい場合、サービスは呼び出されず、キャッシュされた応答は変更されません。オプションで、サービスを強制的に呼び出すことができます。config.service.ttl
プロパティは、ストアを初期化するために init 関数を呼び出すと設定されます。
クエリが完了すると、ready イベントが発生します。JSONP サービス URL が設定されていない場合、この関数は何もしません。
パラメーター
ストアの永続データを初期値にリセットしてから、JSONP サービスを呼び出します。オプションで、その他すべてのデータをストアから削除できます。初期値が再設定されている間、このストアに対するイベンティングは一時停止されます。この関数は値を返しません。
初期値は、ストアオブジェクトのインスタンス化に使用される config オブジェクトの initialValues プロパティで提供されます。
パラメーター
指定されたパラメーターを解決します。
ContextHub.Store.PersistedJSONPStore は ContextHub.Store.JSONPStore を拡張したものなので、このクラスのすべての関数を継承しています。ただし、JSONP サービスから取得されるデータは、ContextHub の永続性に応じて保持されます(永続モードを参照)。
ContextHub.Store.PersistedStore は ContextHub.Store.Core を拡張したものなので、このクラスのすべての関数を継承しています。このストアのデータは、ContextHub の永続性の設定に応じて保持されます。
ContextHub.Store.SessionStore は ContextHub.Store.Core を拡張したものなので、このクラスのすべての関数を継承しています。このストアのデータは、インメモリパーシスタンス(JavaScript オブジェクト)を使用して保持されます。
UI モジュールおよび UI モジュールレンダラーを管理します。
UI モジュールレンダラーを ContextHub に登録します。登録後、レンダラーを使用して UI モジュールを作成できます。ContextHub.UI.BaseModuleRenderer を拡張してカスタム UI モジュールレンダラーを作成する場合は、この関数を使用します。
パラメーター
true
に設定します。デフォルト値は false
です。例
次の例では、レンダラーを contexthub.browserinfo モジュールタイプとして登録します。
ContextHub.UI.registerRenderer('contexthub.browserinfo', new SurferinfoRenderer());
cookie とやり取りするユーティリティクラス。
cookie が存在するかどうかを判断します。
パラメーター
String
。戻り値
boolean
値 true は、cookie が存在することを示します。
例
if (ContextHub.Utils.Cookie.exists("name")) {
// conditionally-executed code
}
フィルターに一致するキーを持つすべての cookie を返します。
パラメーター
(オプション)filter: cookie のキーを照合する条件。すべての cookie を返すには、値を指定しないでください。次のタイプがサポートされています。
戻り値
cookie からなるオブジェクト。オブジェクトのプロパティは cookie のキーで、キー値は cookie の値です。
例
ContextHub.Utils.Cookie.getAllItems([/^cq-authoring/, /^cq-editor/])
cookie の値を返します。
パラメーター
戻り値
cookie の値、またはそのキーの cookie が見つからなかった場合は null
。
例
ContextHub.Utils.Cookie.getItem("name");
フィルターに一致する既存の cookie のキーからなる配列を返します。
パラメーター
filter: cookie のキーを照合する条件。次のタイプがサポートされています。
true
を返す必要があります。戻り値
それぞれがフィルターに一致する cookie のキーである文字列からなる配列。
例
ContextHub.Utils.Cookie.getKeys([/^cq-authoring/, /^cq-editor/])
cookie を削除します。cookie を削除するには、値を空の文字列に設定し、有効期限を現在の日付より前の日に設定します。
パラメーター
key:削除する cookie のキーを表す String
値。
options: cookie の属性を設定するプロパティ値を格納したオブジェクト。詳しくは、 [setItem](/docs/experience-manager-65/developing/personlization/contexthub-api.html?lang=ja#setitem-key-value-options)
関数を参照してください。expires
プロパティは無効です。
戻り値
この関数は値を返しません。
例
ContextHub.Utils.Cookie.vanish([/^cq-authoring/, 'cq-scrollpos']);
指定されたキーと値の cookie を作成し、その cookie を現在のドキュメントに追加します。オプションで、cookie の属性を設定するオプションを指定できます。
パラメーター
key: cookie のキーを格納した String。
value: cookie の値を格納した String。
options:(オプション)cookie の属性を設定する、次のいずれかのプロパティを格納したオブジェクト。
date
値または number
値。date 値は、有効期限の絶対時間を指定します。number(日数)は、有効期限を現在時刻 + その日数に設定します。デフォルト値は undefined
です。boolean
Secure 属性を指定する Secure
値。デフォルト値は false
です。String
Path 属性として使用する Path
値。デフォルト値は undefined
です。戻り値
値が設定された cookie。
例
ContextHub.Utils.Cookie.setItem("name", "mycookie", {
expires: 3,
domain: 'localhost',
path: '/some/directory',
secure: true
});
指定されたフィルターに一致するすべての cookie を削除します。cookie は、getKeys 関数を使用して照合され、removeItem 関数を使用して削除されます。
パラメーター
:filter
関数への呼び出しに使用する [getKeys](/docs/experience-manager-65/developing/personlization/contexthub-api.md#getkeys-filter)
filter 引数。
:options
関数への呼び出しに使用する [removeItem](/docs/experience-manager-65/developing/personlization/contexthub-api.md#removeitem-key-options)
options 引数。
戻り値
この関数は値を返しません。
関数を ContextHub ストアイベントにバインドおよびバインド解除できます。ストアの eventing プロパティを使用して、ストアの ContextHub.Utils.Eventing オブジェクトにアクセスします。
イベントから関数をバインド解除します。
パラメーター
戻り値
この関数は値を返しません。
関数をイベントにバインドします。この関数は、イベントが発生するたびに呼び出されます。オプションで、過去にバインドが確立される前に発生したイベントに対して関数を呼び出すことができます。
パラメーター
name:(String)関数をバインドするイベントの名前。
handler:(Function)イベントにバインドする関数。
selector:(文字列)バインドの一意の識別子。off
関数を使用してバインドを削除する場合は、セレクターでバインドを識別する必要があります。
triggerForPastEvents:(Boolean)過去に発生したイベントに対してハンドラーを実行するかどうかを示します。true
値は、過去のイベントに対してハンドラーを呼び出します。値 false
は、未来のイベントに対してハンドラーを呼び出します。デフォルト値は true
です。
戻り値
triggerForPastEvents
引数が true
の場合、この関数はイベントが過去に発生したかどうかを示す boolean
値を返します。
true
:イベントが過去に発生しており、ハンドラーが呼び出されます。false
:イベントが過去に発生していません。triggerForPastEvents
が false
の場合、この関数は値を返しません。
例
次の例では、関数を geolocation ストアの data イベントにバインドします。この関数は、ページ上の要素にストアの緯度データ項目の値を設定しています。
<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>
関数をイベントにバインドします。関数は、最初に発生したイベントに対して一度だけ呼び出されます。オプションで、過去にバインドが確立される前に発生したイベントに対して関数を呼び出すことができます。
パラメーター
name:(String)関数をバインドするイベントの名前。
handler:(Function)イベントにバインドする関数。
selector:(文字列)バインドの一意の識別子。off
関数を使用してバインドを削除する場合は、セレクターでバインドを識別する必要があります。
triggerForPastEvents:(Boolean)過去に発生したイベントに対してハンドラーを実行するかどうかを示します。true
値は、過去のイベントに対してハンドラーを呼び出します。値 false
は、未来のイベントに対してハンドラーを呼び出します。デフォルト値は true
です。
戻り値
triggerForPastEvents
引数が true
の場合、この関数はイベントが過去に発生したかどうかを示す boolean
値を返します。
true
:イベントが過去に発生しており、ハンドラーが呼び出されます。false
:イベントが過去に発生していません。triggerForPastEvents
が false
の場合、この関数は値を返しません。
オブジェクトが別のオブジェクトのプロパティとメソッドを継承できるようにするユーティリティクラス。
オブジェクトに別のオブジェクトのプロパティとメソッドを継承させます。
パラメーター
オブジェクトを JSON 形式にシリアライズし、JSON 文字列をオブジェクトにデシリアライズするための関数を提供します。
文字列値を JSON として解析し、JavaScript オブジェクトに変換します。
パラメーター
戻り値
JavaScript オブジェクト。
例
このコード ContextHub.Utils.JSON.parse("{'city':'Basel','country':'Switzerland','population':'173330'}");
は次のオブジェクトを返します。
Object {
city: "Basel",
country: "Switzerland",
population: 173330
}
JavaScript の値およびオブジェクトを JSON 形式の文字列値にシリアライズします。
パラメーター
戻り値
シリアライズされた文字列値。data
が egExp
値の場合、この関数は空のオブジェクトを返します。data
が関数の場合は、undefined
を返します。
例
次のコードは "{'city':'Basel','country':'Switzerland','population':'173330'}":
を返します。
ContextHub.Utils.JSON.stringify({
city: "Basel",
country: "Switzerland",
population: 173330
});
このクラスは、ContextHub ストアに保存または ContextHub ストアから取得するデータオブジェクトの操作を容易にします。
データオブジェクトのコピーを作成し、2 つ目のオブジェクトのデータツリーに追加します。この関数はコピーを返し、元のオブジェクトはどちらも変更されません。2 つのオブジェクトのデータツリーに同一のキーが含まれる場合、2 つ目のオブジェクトの値によって最初のオブジェクトの値が上書きされます。
パラメーター
tree
オブジェクトのコピーと結合されるオブジェクト。戻り値
結合されたデータを格納したオブジェクト。
オブジェクトのコピーを作成し、値を含まないか、null 値または undefined 値を含むデータツリーの項目を探して削除し、コピーを返します。
パラメーター
戻り値
クリーンアップされたツリーのコピー。
キーに対する値をオブジェクトから取得します。
パラメーター
戻り値
キーに対応する値。キーに子キーがある場合、この関数は複合オブジェクトを返します。キーの値のタイプが undefined
の場合、null
が返されます。
例
次の JavaScript オブジェクトについて考えてみます。
myObject {
user: {
location: {
city: "Basel",
details: {
population: 173330,
elevation: 260
}
}
}
}
次のサンプルコードは、値 260
を返します。
ContextHub.Utils.JSON.tree.getItem(myObject, "/user/location/details/elevation");
次のサンプルコードは、子キーを持つキーの値を取得します。
ContextHub.Utils.JSON.tree.getItem(myObject, "/user");
この関数は次のオブジェクトを返します。
Object {
location: {
city: "Basel",
details: {
population: 173330,
elevation: 260
}
}
}
オブジェクトのデータツリーからすべてのキーを取得します。オプションで、特定のキーの子のキーのみを取得できます。オプションで、取得したキーのソート順を指定することもできます。
パラメーター
戻り値
キーからなる配列。
例
次のオブジェクトについて考えてみます。
myObject {
location: {
weather: {
temperature: "28C",
humidity: "77%",
precipitation: "10%",
wind: "8km/h"
},
city: "Basel",
country: "Switzerland",
longitude: 7.5925727,
latitude: 47.557421
}
}
ContextHub.Utils.JSON.tree.getKeys(myObject);
スクリプトは、次の配列を返します。
["/location", "/location/city", "/location/country", "/location/latitude", "/location/longitude", "/location/weather", "/location/weather/humidity", "/location/weather/precipitation", "/location/weather/temperature", "/location/weather/wind"]
指定されたオブジェクトのコピーを作成し、指定されたブランチをデータツリーから削除し、変更されたコピーを返します。
パラメーター
戻り値
キーが削除された元のデータオブジェクトのコピー。
例
次のオブジェクトについて考えてみます。
myObject {
one: {
foo: "bar",
two: {
three: {
four: {
five: 5,
six: 6
}
}
}
}
}
次のサンプルスクリプトでは、データツリーから /one/two/three/four ブランチを削除しています。
myObject = ContextHub.Utils.JSON.tree.removeItem(myObject, "/one/two/three/four");
この関数は次のオブジェクトを返します。
myObject {
one: {
foo: "bar"
}
}
文字列値の不要部分を削除して、キーとして使用できるようにします。文字列の不要部分を削除するために、この関数は次のアクションを実行します。
作成された配列を使用して、使用可能なキーを作成します。パラメーター
string
。戻り値
string
値からなる配列で、各文字列はスラッシュで区切られた key
の一部です。不要部分が削除されたキーを表します。不要部分が削除された配列の長さがゼロの場合、この関数は null
を返します。
例
次のコードは、文字列の不要部分を削除して ["this", "is", "a", "path"]
という配列を作成し、その配列からキー "/this/is/a/path"
を生成します。
var key = " / this////is/a/path ";
ContextHub.Utils.JSON.tree.sanitizeKey(key)
"/" + ContextHub.Utils.JSON.tree.sanitizeKey(key).join("/");
オブジェクトのコピーのデータツリーにキーと値のペアを追加します。データツリーについて詳しくは、永続性を参照してください。
パラメーター
ContextHub.Utils.JSON.tree.sanitize
を呼び出して、キーを追加する前に不要部分を削除します。戻り値
key
と value
のペアを含む tree
オブジェクトのコピー。
例
次の 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);
myObject オブジェクトは次の値を持ちます。
ストア候補を登録したり、登録されたストア候補を取得したりできるようにします。
ストア候補として登録されているストアタイプを返します。特定のストアタイプまたはすべてのストアタイプの登録されている候補を取得します。
パラメーター
storeType
関数の パラメーターを参照してください。ContextHub.Utils.storeCandidates.registerStoreCandidate
戻り値
ストアタイプのオブジェクト。オブジェクトのプロパティはストアタイプ名で、プロパティ値は登録されているストア候補からなる配列です。
登録されている候補からストアタイプを返します。複数のストアタイプが同じ名前で登録されている場合、この関数は最も優先度が高いストアタイプを返します。
パラメーター
storeType
関数の パラメーターを参照してください。ContextHub.Utils.storeCandidates.registerStoreCandidate
戻り値
登録されているストア候補を表すオブジェクト。要求されたストアタイプが登録されていない場合は、エラーがスローされます。
ストア候補として登録されているストアタイプの名前を返します。この関数にパラメーターは必要ありません。
戻り値
文字列値からなる配列で、各文字列はストア候補と一緒に登録されたストアタイプです。storeType
関数の パラメーターを参照してください。ContextHub.Utils.storeCandidates.registerStoreCandidate
名前と優先度を使用して、ストアオブジェクトをストア候補として登録します。
優先度は、同じ名前のストアの重要度を示す数字です。既に登録されているストア候補と同じ名前を使用してストア候補を登録した場合、優先度の高い候補が使用されます。ストア候補を登録する場合、同じ名前の登録済みストア候補より優先度が高い場合にのみストアが登録されます。
パラメーター
true
、それ以外の場合は false
を返す必要があります。デフォルト値は、true を返す関数 function() {return true;}
です。例
ContextHub.Utils.storeCandidates.registerStoreCandidate(myStoreCandidate,
'contexthub.mystorecandiate', 0);