ContextHub コンポーネントをページに追加すると、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.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 ストアを格納したオブジェクト。各ストアは、ストアと同じ名前を使用するオブジェクトです。
例
次の例では、すべてのストアを取得してから、geolocation ストアを取得しています。
var allStores = ContextHub.getAllStores(); var geoloc = allStores.geolocation
ストアを JavaScript オブジェクトとして取得します。
パラメーター
- name:ストアが登録された名前。
戻り値
ストアを表すオブジェクト。
例
次の例では、geolocation ストアを取得します。
var geoloc = ContextHub.getStore("geolocation");
ContextHub.Utils.Eventing オブジェクト。このオブジェクトを使用して、関数をストアイベントにバインドします。デフォルト値と初期化については、init(name,config) を参照してください。
ContextHub.Utils.Persistence オブジェクト。デフォルト値と初期化については、init(name,config) を参照してください。
データオブジェクトまたは配列とストアデータを結合します。オブジェクトのキーと値の各ペアまたは配列が(setItem 関数を使用して)ストアに追加されます。
- オブジェクト:キーはプロパティ名です。
- 配列:キーは配列のインデックスです。
値にオブジェクトを使用できます。
パラメーター
- tree:(Object または Array)ストアに追加するデータ。
- options:(Object)setItem 関数に渡すオプションからなる任意のオブジェクト。詳しくは、setItem(key,value,options) の options パラメーターを参照してください。
戻り値
次の boolean 値。
- 値 true は、データオブジェクトが保存されたことを示します。
- 値 false は、データストアが変更されていないことを示します。
1 つのキーから別のキーへの参照を作成します。キーは自分自身を参照できません。
パラメーター
- key:anotherKey を参照するキー。
- anotherkey:key に参照されるキー。
戻り値
次の boolean 値。
- 値 true は、参照が追加されたことを示します。
- 値 false は、参照が追加されなかったことを示します。
ストアからキーを取得します。オプションで、ContextHub フレームワークが内部的に使用するキーを取得できます。
パラメーター
- includeInternals:値 true は、内部的に使用されているキーを結果に含めます。このようなキーは、アンダースコア("_")文字で始まります。デフォルト値は false です。
戻り値
キー名(string 値)の配列。
ストアから参照を取得します。
戻り値
参照キーを被参照キーのインデックスとして使用する配列。
- 参照キーは、addReference 関数の key パラメーターに対応しています。
- 被参照キーは、addReference 関数の anotherKey パラメーターに対応しています。
データツリーをストアから取得します。オプションで、ContextHub フレームワークが内部的に使用しているキーと値のペアを含めることができます。
パラメーター
- includeInternals:値 true は、内部的に使用されているキーと値のペアを結果に含めます。このデータのキーは、アンダースコア("_")文字で始まります。デフォルト値は false です。
戻り値
データツリーを表すオブジェクト。キーは、オブジェクトのプロパティ名です。
ストアを初期化します。
- ストアデータを空のオブジェクトに設定します。
- ストア参照を空のオブジェクトに設定します。
- eventChannel は data:name です。name はストア名です。
- storeDataKey は /store/name です。name はストア名です。
パラメーター
- name:ストアの名前。
- config:設定プロパティを格納したオブジェクト。
- eventDeferring:デフォルト値は 32 です。
- eventing:このストアの ContextHub.Utils.Eventing オブジェクト。デフォルト値は ContextHub.eventing オブジェクトです。
- persistence:このストアの ContextHub.Utils.Persistence オブジェクト。デフォルト値は ContextHub.persistence オブジェクトです。
このストアに対するイベンティングが一時停止されているかどうかを判断します。
戻り値
次の boolean 値。
- true:イベンティングが一時停止されているので、このストアに対するイベントは発生しません。
- false:イベンティングが一時停止されていないので、このストアに対するイベントが発生します。
キーと値のペアをストアから削除します。
キーが削除されると、この関数が data イベントを発生させます。イベントデータには、ストア名、削除されたキーの名前、削除された値、キーの新しい値(null)およびアクションタイプ "remove" が含まれます。
オプションで、data イベントを発生させないようにすることができます。
パラメーター
- key:(String)削除するキーの名前。
- options:(Object)オプションからなるオブジェクト。次のオブジェクトプロパティが有効です。
- silent:値 true は、data イベントが発生しないようにします。デフォルト値は false です。
戻り値
次の boolean 値。
- 値 true は、キーと値のペアが削除されたことを示します。
- 値 false は、キーがストアに見つからなかったのでデータストアが変更されていないことを示します。
参照をストアから削除します。
パラメーター
- key:削除するキー参照。このパラメーターは、addReference 関数の key パラメーターに対応しています。
戻り値
次の boolean 値。
- 値 true は、参照が削除されたことを示します。
- 値 false は、キーが有効ではなかったのでストアが変更されていないことを示します。
ストアの永続データの初期値を再設定します。オプションで、その他すべてのデータをストアから削除できます。ストアが再設定されている間、このストアに対するイベンティングは一時停止されます。この関数は値を返しません。
初期値は、ストアオブジェクトのインスタンス化に使用される config オブジェクトの initialValues プロパティで提供されます。
パラメーター
- keepRemainingData:(Boolean)値が true の場合、初期値以外のデータは保持されます。値が false の場合、初期値以外のすべてのデータが削除されます。
ストアの永続データの初期値を再設定します。オプションで、その他すべてのデータをストアから削除できます。ストアが再設定されている間、このストアに対するイベンティングは一時停止されます。この関数は値を返しません。
初期値は、ストアオブジェクトのインスタンス化に使用される config オブジェクトの initialValues プロパティで提供されます。
パラメーター
- keepRemainingData:(Boolean)値が true の場合、初期値以外のデータは保持されます。値が false の場合、初期値以外のすべてのデータが削除されます。
被参照キーを取得します。オプションで、最良一致の解決に使用する繰り返し回数を指定できます。
パラメーター
- key:(String)参照を解決するためのキー。この key パラメーターは、addReference 関数の key パラメーターに対応しています。
- retry:(Number)使用する繰り返し回数。
戻り値
被参照キーを表す string 値。参照が解決されない場合は、key パラメーターの値が返されます。
キーと値のペアをストアに追加します。
キーの値がそのキーに対して現在保存されている値と異なる場合にのみ data イベントを発生させます。オプションで、data イベントを発生させないようにすることができます。
イベントデータには、ストア名、キー、前の値、新しい値およびアクションタイプ set が含まれます。
パラメーター
- key:(String)キーの名前。
- options:(Object)オプションからなるオブジェクト。次のオブジェクトプロパティが有効です。
- silent:値 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:(Object)オブジェクトのプロパティとして表される URL パラメーター。パラメーター名はプロパティ名で、パラメーター値はプロパティ値です。
- path:(String)サービスへのパス。
- port:(Number)サービスのポート番号。
- secure:(String または Boolean)サービス URL に使用するプロトコルを決定します。
- auto://
- true:https://
- false:http://
- override:(Boolean)値が true の場合、既存のサービス設定を serviceConfig のプロパティで置き換えます。値が false の場合、既存のサービス設定プロパティを serviceConfig のプロパティと結合します。
この ContextHub.Store.JSONPStore オブジェクトのサービスオブジェクトを取得します。サービスオブジェクトには、サービス URL を作成するのに必要なすべての情報が格納されています。
戻り値
次のプロパティを持つオブジェクト。
- host:(String)サーバーの名前または IP アドレス。
- jsonp:(Boolean)値 true はサービスが JSONP サービスであることを示します。それ以外は false です。true の場合、{callback: "ContextHub.Callbacks.Object.name} オブジェクトが service.params オブジェクトに追加されます。
- params:(Object)オブジェクトのプロパティとして表される URL パラメーター。パラメーター名はプロパティ名で、パラメーター値はプロパティ値です。
- path:(String)サービスへのパス。
- port:(Number)サービスのポート番号。
- secure:(String または Boolean)サービス URL に使用するプロトコルを決定します。
- auto://
- true:https://
- false:http://
JSONP サービスの URL を取得します。
パラメーター
- resolve:(Boolean)解決されたパラメーターを 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:(Object)
- host:(String)サーバーの名前または IP アドレス。
- jsonp:(Boolean)値 true はサービスが JSONP サービスであることを示します。それ以外は false です。true の場合、{callback: "ContextHub.Callbacks.Object.name} オブジェクトが service.params に追加されます。
- params:(Object)オブジェクトのプロパティとして表される URL パラメーター。パラメーターの名前と値は、それぞれオブジェクトのプロパティの名前と値です。
- path:(String)サービスへのパス。
- port:(Number)サービスのポート番号。
- secure:(String または Boolean)サービス URL に使用するプロトコルを決定します。
- auto://
- true:https://
- false:http://
- timeout:(Number)タイムアウトまでに JSONP サービスの応答を待機する時間(ミリ秒単位)。
- ttl:JSONP サービスの最小呼び出し間隔(ミリ秒単位)。(queryService 関数を参照)。
リモート JSONP サービスをクエリーし、応答をキャッシュします。この関数の前回の呼び出しからの時間が config.service.ttl の値より小さい場合、サービスは呼び出されず、キャッシュされた応答は変更されません。オプションで、サービスを強制的に呼び出すことができます。config.service.ttl プロパティは、ストアを初期化するために init 関数を呼び出すと設定されます。
クエリーが完了すると、ready イベントが発生します。JSONP サービス URL が設定されていない場合、この関数は何もしません。
パラメーター
- reload:(Boolean)値が true の場合、キャッシュされた応答を削除し、JSONP サービスを強制的に呼び出します。
ストアの永続データを初期値にリセットしてから、JSONP サービスを呼び出します。オプションで、その他すべてのデータをストアから削除できます。初期値が再設定されている間、このストアに対するイベンティングは一時停止されます。この関数は値を返しません。
初期値は、ストアオブジェクトのインスタンス化に使用される config オブジェクトの initialValues プロパティで提供されます。
パラメーター
- keepRemainingData:(Boolean)値が true の場合、初期値以外のデータは保持されます。値が false の場合、初期値以外のすべてのデータが削除されます。
ContextHub.Store.PersistedJSONPStore は ContextHub.Store.JSONPStore を拡張したものなので、このクラスのすべての関数を継承しています。ただし、JSONP サービスから取得されるデータは、ContextHub の永続性に応じて保持されます(永続モードを参照)。
ContextHub.Store.PersistedStore は ContextHub.Store.Core を拡張したものなので、このクラスのすべての関数を継承しています。このストアのデータは、ContextHub の永続性の設定に応じて保持されます。
ContextHub.Store.SessionStore は ContextHub.Store.Core を拡張したものなので、このクラスのすべての関数を継承しています。このストアのデータは、インメモリパーシスタンス(JavaScript オブジェクト)を使用して保持されます。
UI モジュールレンダラーを ContextHub に登録します。登録後、レンダラーを使用して UI モジュールを作成できます。ContextHub.UI.BaseModuleRenderer を拡張してカスタム UI モジュールレンダラーを作成する場合は、この関数を使用します。
パラメーター
- moduleType:(String)UI モジュールレンダラーの識別子。指定された値でレンダラーが既に登録されている場合、既存のレンダラーが登録解除されてから、このレンダラーが登録されます。
- renderer:(String)UI モジュールをレンダリングするクラスの名前。
- dontRender:(Boolean)レンダラーの登録後に ContextHub UI がレンダリングされないようにするには、true に設定します。デフォルト値は false です。
例
次の例では、レンダラーを contexthub.browserinfo モジュールタイプとして登録します。
ContextHub.UI.registerRenderer('contexthub.browserinfo', new SurferinfoRenderer());
cookie が存在するかどうかを判断します。
パラメーター
- key:テストする cookie のキーを格納した String。
戻り値
boolean 値 true は、cookie が存在することを示します。
例
if (ContextHub.Utils.Cookie.exists("name")) { // conditionally-executed code }
フィルターに一致するキーを持つすべての cookie を返します。
パラメーター
- (オプション)filter:cookie のキーを照合する条件。すべての cookie を返すには、値を指定しないでください。次のタイプがサポートされています。
- String:文字列を cookie のキーと比較します。
- Array:配列内の各項目はフィルターです。
- 正規表現オブジェクト:オブジェクトのテスト関数を使用して cookie のキーを照合します。
- 関数:cookie のキーが一致するかどうかをテストする関数。関数は、cookie のキーをパラメーターとして取り、テストによって一致が確認された場合は true を返す必要があります。
戻り値
cookie からなるオブジェクト。オブジェクトのプロパティは cookie のキーで、キー値は cookie の値です。
例
ContextHub.Utils.Cookie.getAllItems([/^cq-authoring/, /^cq-editor/])
ContextHub.Utils.Cookie.getItem("name");
フィルターに一致する既存の cookie のキーからなる配列を返します。
パラメーター
- filter:cookie のキーを照合する条件。次のタイプがサポートされています。
- String:文字列を cookie のキーと比較します。
- Array:配列内の各項目はフィルターです。
- 正規表現オブジェクト:オブジェクトのテスト関数を使用して cookie のキーを照合します。
- 関数:cookie のキーが一致するかどうかをテストする関数。関数は、cookie のキーをパラメーターとして取り、テストによって一致が確認された場合は true を返す必要があります。
戻り値
それぞれがフィルターに一致する cookie のキーである文字列からなる配列。
例
ContextHub.Utils.Cookie.getKeys([/^cq-authoring/, /^cq-editor/])
cookie を削除します。cookie を削除するには、値を空の文字列に設定し、有効期限を現在の日付より前の日に設定します。
パラメーター
- key:削除する cookie のキーを表す String 値。
- options:cookie の属性を設定するプロパティ値を格納したオブジェクト。詳しくは、setItem 関数を参照してください。expires プロパティは無効です。
戻り値
この関数は値を返しません。
例
ContextHub.Utils.Cookie.vanish([/^cq-authoring/, 'cq-scrollpos']);
指定されたキーと値の cookie を作成し、その cookie を現在のドキュメントに追加します。オプションで、cookie の属性を設定するオプションを指定できます。
パラメーター
- key:cookie のキーを格納した String。
- value:cookie の値を格納した String。
- options:(オプション)cookie の属性を設定する、次のいずれかのプロパティを格納したオブジェクト。
- expires:cookie の有効期限を指定する date 値または number 値。date 値は、有効期限の絶対時間を指定します。number(日数)は、有効期限を現在時刻 + その日数に設定します。デフォルト値は undefined です。
- secure:cookie の Secure 属性を指定する boolean 値。デフォルト値は false です。
- path:cookie の Path 属性として使用する String 値。デフォルト値は undefined です。
戻り値
値が設定された cookie。
例
ContextHub.Utils.Cookie.setItem("name", "mycookie", { expires: 3, domain: 'localhost', path: '/some/directory', secure: true });
関数を ContextHub ストアイベントにバインドおよびバインド解除できます。ストアの eventing プロパティを使用して、ストアの ContextHub.Utils.Eventing オブジェクトにアクセスします。
関数をイベントにバインドします。この関数は、イベントが発生するたびに呼び出されます。オプションで、過去にバインドが確立される前に発生したイベントに対して関数を呼び出すことができます。
パラメーター
- name:(String)関数をバインドするイベントの名前。
- handler:(Function)イベントにバインドする関数。
- selector:(String)バインドの一意の識別子。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:(String)バインドの一意の識別子。off 関数を使用してバインドを削除する場合は、セレクターでバインドを識別する必要があります。
- triggerForPastEvents:(Boolean)過去に発生したイベントに対してハンドラーを実行するかどうかを示します。値 true は、過去のイベントに対してハンドラーを呼び出します。値 false は、未来のイベントに対してハンドラーを呼び出します。デフォルト値は true です。
戻り値
triggerForPastEvents 引数が true の場合、この関数はイベントが過去に発生したかどうかを示す boolean 値を返します。
- true:イベントが過去に発生しており、ハンドラーが呼び出されます。
- false:イベントが過去に発生していません。
triggerForPastEvents が false の場合、この関数は値を返しません。
オブジェクトに別のオブジェクトのプロパティとメソッドを継承させます。
パラメーター
- child:(Object)継承するオブジェクト。
- parent:(Object)継承するプロパティとメソッドを定義するオブジェクト。
文字列値を JSON として解析し、JavaScript オブジェクトに変換します。
パラメーター
- data:JSON 形式の文字列値。
戻り値
JavaScript オブジェクト。
例
コード ContextHub.Utils.JSON.parse("{'city':'Basel','country':'Switzerland','population':'173330'}"); は、次のオブジェクトを返します。
Object { city: "Basel", country: "Switzerland", population: 173330 }
JavaScript の値およびオブジェクトを JSON 形式の文字列値にシリアライズします。
パラメーター
- data:シリアライズする値またはオブジェクト。この関数は、boolean、array、number、string および date 値をサポートします。
戻り値
シリアライズされた文字列値。data が正規表現値の場合、この関数は空のオブジェクトを返します。data が関数の場合は、undefined を返します。
例
次のコードは "{'city':'Basel','country':'Switzerland','population':'173330'}": を返します。
ContextHub.Utils.JSON.stringify({ city: "Basel", country: "Switzerland", population: 173330 });
データオブジェクトのコピーを作成し、2 つ目のオブジェクトのデータツリーに追加します。この関数はコピーを返し、元のオブジェクトはどちらも変更されません。2 つのオブジェクトのデータツリーに同一のキーが含まれる場合、2 つ目のオブジェクトの値によって最初のオブジェクトの値が上書きされます。
パラメーター
- tree:コピーするオブジェクト。
- secondTree:tree オブジェクトのコピーと結合されるオブジェクト。
戻り値
結合されたデータを格納したオブジェクト。
オブジェクトのコピーを作成し、値を含まないか、null 値または undefined 値を含むデータツリーの項目を探して削除し、コピーを返します。
パラメーター
- tree:クリーンアップするオブジェクト。
戻り値
クリーンアップされたツリーのコピー。
キーに対する値をオブジェクトから取得します。
パラメーター
- tree:データオブジェクト。
- key:取得する値のキー。
戻り値
キーに対応する値。キーに子キーがある場合、この関数は複合オブジェクトを返します。キーの値のタイプが undefined の場合、null が返されます。
例
次の JavaScript オブジェクトについて考えてみます。
myObject { user: { location: { city: "Basel", details: { population: 173330, elevation: 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 } } }
オブジェクトのデータツリーからすべてのキーを取得します。オプションで、特定のキーの子のキーのみを取得できます。オプションで、取得したキーのソート順を指定することもできます。
パラメーター
- tree:データツリーのキーの取得元となるオブジェクト。
- parent:(オプション)子項目のキーを取得するデータツリー内の項目のキー。
- order:(オプション)返されたキーのソート順を判断する関数(Mozilla Developer Network の Array.prototype.sort を参照)。
戻り値
キーからなる配列。
例
次のオブジェクトについて考えてみます。
myObject { location: { weather: { temperature: "28C", humidity: "77%", precipitation: "10%", wind: "8km/h" }, city: "Basel", country: "Switzerland", longitude: 7.5925727, latitude: 47.557421 } }
["/location", "/location/city", "/location/country", "/location/latitude", "/location/longitude", "/location/weather", "/location/weather/humidity", "/location/weather/precipitation", "/location/weather/temperature", "/location/weather/wind"]
指定されたオブジェクトのコピーを作成し、指定されたブランチをデータツリーから削除し、変更されたコピーを返します。
パラメーター
- tree:データオブジェクト。
- key:削除するキー。
戻り値
キーが削除された元のデータオブジェクトのコピー。
例
次のオブジェクトについて考えてみます。
myObject { one: { foo: "bar", two: { three: { four: { five: 5, six: 6 } } } } }
myObject = ContextHub.Utils.JSON.tree.removeItem(myObject, "/one/two/three/four");
myObject { one: { foo: "bar" } }
文字列値の不要部分を削除して、キーとして使用できるようにします。文字列の不要部分を削除するために、この関数は次のアクションを実行します。
- 複数の連続するフォワードスラッシュを 1 つのスラッシュにまとめます。
- 文字列の先頭および末尾から空白を削除します。
- 結果をスラッシュで区切られた文字列の配列に分割します。
パラメーター
- key:不要部分を削除する 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("/");
オブジェクトのコピーのデータツリーにキーと値のペアを追加します。データツリーについて詳しくは、ストアデータを参照してください。
パラメーター
- tree:データオブジェクト。
- key:追加する値に関連付けるキー。キーは、データツリー内の項目へのパスです。この関数は、ContextHub.Utils.JSON.tree.sanitize を呼び出して、キーを追加する前に不要部分を削除します。
- value:データツリーに追加する値。
戻り値
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);
ストア候補として登録されているストアタイプを返します。特定のストアタイプまたはすべてのストアタイプの登録されている候補を取得します。
パラメーター
- storeType:(String)ストアタイプの名前。ContextHub.Utils.storeCandidates.registerStoreCandidate 関数の storeType パラメーターを参照してください。
戻り値
ストアタイプのオブジェクト。オブジェクトのプロパティはストアタイプ名で、プロパティ値は登録されているストア候補からなる配列です。
登録されている候補からストアタイプを返します。複数のストアタイプが同じ名前で登録されている場合、この関数は最も優先度が高いストアタイプを返します。
パラメーター
- storeType:(String)ストア候補の名前。ContextHub.Utils.storeCandidates.registerStoreCandidate 関数の storeType パラメーターを参照してください。
戻り値
登録されているストア候補を表すオブジェクト。要求されたストアタイプが登録されていない場合は、エラーがスローされます。
ストア候補として登録されているストアタイプの名前を返します。この関数にパラメーターは必要ありません。
戻り値
文字列値からなる配列で、各文字列はストア候補と一緒に登録されたストアタイプです。ContextHub.Utils.storeCandidates.registerStoreCandidate 関数の storeType パラメーターを参照してください。
名前と優先度を使用して、ストアオブジェクトをストア候補として登録します。
優先度は、同じ名前のストアの重要度を示す数字です。既に登録されているストア候補と同じ名前を使用してストア候補を登録した場合、優先度の高い候補が使用されます。ストア候補を登録する場合、同じ名前の登録済みストア候補より優先度が高い場合にのみストアが登録されます。
パラメーター
- store:(Object)ストア候補として登録するストアオブジェクト。
- storeType:(String)ストア候補の名前。この値は、ストア候補のインスタンスを作成する際に必要です。
- priority:(Number)ストア候補の優先度。
- applies:(Function)現在の環境内でのストアの適用可能性を評価するために呼び出す関数。この関数は、ストアを適用できる場合は true、それ以外の場合は false を返す必要があります。デフォルト値は、true を返す関数 function() {return true;} です。
例
ContextHub.Utils.storeCandidates.registerStoreCandidate(myStoreCandidate, 'contexthub.mystorecandiate', 0);