キーと値のペアの取得

KiiObject からキーと値のペアを取得するには、KiiObject クラスの get() のメソッドを呼び出します。

get() メソッドの引数には、取得するキー名を指定します。JSON ドキュメントから、指定した第 1 階層のキーの値が読み込まれます。取得した値は、JSON ドキュメントの指定したキーに応じたデータ型で取得できます。

以下に JSON ドキュメントのサンプルと、その JSON ドキュメントから値を取得するためのサンプルコードを示します。サンプルコードのコメントは、取得できた値を表します。KiiObject の取得処理まで含む完全なコードは、下記の基本データ型の取得を参照してください。

{
  "score": 987,
  "premiumUser": false,
  "mode": "easy"
}

var score = object.get("score"); // score=987
var mode = object.get("mode"); // mode="easy"
var premiumUser = object.get("premiumUser"); // premiumUser=false

第 2 階層より深い位置の値を読み込みたい場合は、第 1 階層を JSON オブジェクトとして取得してください。

サポートするデータ型

get() メソッドを実行した結果のバリエーションを、以下の表に示します。「読み込み元 JSON の例」に示す JSON ドキュメントを「呼び出し例」で取得すると、「取得結果」の値を取得できます。

JavaScript では実行時に型が決まるため、同じ get() メソッドを使ってすべてのデータ型を扱うことができます。ただし、位置情報（KiiGeoPoint）を扱う場合に get() メソッドを使うと内部データが object として取得されるため、専用メソッド getGeoPoint() を使って取得します。

値の型	読み込み元 JSON の例	呼び出し例	取得結果
string	`"data":"123"`	`get("data");`	"123"
number	`"data":123`	`get("data");`	123
boolean	`"data":true`	`get("data");`	123L
KiiGeoPoint	`"data":{` `"_type": "point",` `"lat": 35.658603,` `"lon": 139.745433` `}`	`getGeoPoint("data");`	`getGeoPoint("data", geoPoint);`
配列	`"data":[1,2,3]`	`get("data");`	[1,2,3]
object	`"data":{"a":"b"}`	`get("data");`	{"a":"b"}

JavaScript では Android にある、バイト配列を BASE64 にして取得する機能はサポートしていません。必要な場合は文字列で取得後に、アプリ側で BASE64 デコードを行います。

基本データ型の取得

KiiObject よりキーと値のペアを取得するには get() メソッドを実行します。詳細については JSDoc を参照してください。

以下に、KiiObject よりキーと値のペアを取得するサンプルを挙げます。

// Instantiate a KiiObject.
var object = KiiObject.objectWithURI("Set the URI of an existing KiiObject here");

// Refresh the KiiObject to retrieve the latest data from Kii Cloud.
object.refresh().then(
  function(theObject) {
    // Get key-value pairs.
    var stringData = object.get("stringValue");
    var intData = object.get("intValue");
    var longData = object.get("longValue");
    var doubleData = object.get("doubleValue");
    var booleanData = object.get("booleanValue");
  }
).catch(
  function(error) {
    var theObject = error.target;
    var errorString = error.message;
    // Handle the error.
  }
);

// Instantiate a KiiObject.
var object = KiiObject.objectWithURI("Set the URI of an existing KiiObject here");

// Refresh the KiiObject to retrieve the latest data from Kii Cloud.
object.refresh({
  success: function(theObject) {
    // Get key-value pairs.
    var stringData = object.get("stringValue");
    var intData = object.get("intValue");
    var longData = object.get("longValue");
    var doubleData = object.get("doubleValue");
    var booleanData = object.get("booleanValue");
  },
  failure: function(theObject, errorString) {
    // Handle the error.
  }
});

インスタンス作成後、refresh() メソッドを呼ぶのを忘れないようにしてください。KiiObject のインスタンスを生成しただけでは、KiiObject の中身は最新のものになりません。

キー一覧の取得

KiiObject にセットされているキーの一覧は、次の例のように getKeys() メソッドを使って確認できます。

// Instantiate a KiiObject.
var object = KiiObject.objectWithURI("Set the URI of an existing KiiObject here");

// Refresh the KiiObject to retrieve the latest data from Kii Cloud.
object.refresh().then(
  function(theObject) {
    // Get a list of keys.
    var keys = object.getKeys();

    // Do something with the list.
    for (var i = 0; i < keys.length; i++) {
      console.log(keys[i] + "=" + object.get(keys[i]));
      // Do something with each key.
    }
  }
).catch(
  function(error) {
    var theObject = error.target;
    var errorString = error.message;
    // Handle the error.
  }
);

// Instantiate a KiiObject.
var object = KiiObject.objectWithURI("Set the URI of an existing KiiObject here");

// Refresh the KiiObject to retrieve the latest data from Kii Cloud.
object.refresh({
  success: function(theObject) {
    // Get a list of keys.
    var keys = object.getKeys();

    // Do something with the list.
    for (var i = 0; i < keys.length; i++) {
      console.log(keys[i] + "=" + object.get(keys[i]));
      // Do something with each key.
    }
  },
  failure: function(theObject, errorString) {
    // Handle the error.
  }
});

getKeys() メソッドでは、プログラムから設定したキーの一覧のみを取得できます。Kii Cloud SDK for JavaScript では、_version や _id などの所定キーは読み込めません。所定キーについて詳しくは、所定キーをご覧ください。

空のフィールドの読み込み

キーと値のペアの取得の際は、存在しないキーの値を読み込んだときと JSON の null を読み込んだときで挙動が違います。

たとえば、以下のような JSON が書き込まれているオブジェクトから値を読み込むものとします。

{
  "key1": null,
  "key2": ""
}

各メソッドでの取得結果は以下のとおりです。

object.get("key1") は null を返します。
object.get("key2") は空文字列を返します。
object.get("key3") は Undefined を返します。

JSON とデータ型との対応の詳細は、取得時のデータ変換をご覧ください。

作成/更新時間の取得

Kii Cloud は、KiiObject の作成時間と最終更新時間を自動的にセットします（いずれも UNIX 時間、ミリ秒）。これらの情報は、それぞれ KiiObject オブジェクトの getCreated() メソッドと getModified() メソッドを実行することで取得可能です。

なお、時間は UTC（協定世界時）で保存されているため、必要に応じて変換を行ってください。

位置情報（GeoPoint）の取得

KiiObject にセットした位置情報を抽出するには、まず KiiObject のキーを指定して getGeoPoint() メソッドを実行し、KiiGeoPoint オブジェクトを取得します。この後、getLatitude() メソッドおよび getLongitude() メソッドを実行して、それぞれ緯度、経度の取得を行います。

// Get GeoPoints from the "location1" and "location2" keys.
var objLoc1 = object.getGeoPoint("location1");
var objLoc2 = object.getGeoPoint("location2");

// Get the latitude and longitude data.
var lat1 = objLoc1.getLatitude();
var lon1 = objLoc1.getLongitude();
var lat2 = objLoc2.getLatitude();
var lon2 = objLoc2.getLongitude();

複雑なデータ型の取得

JavaScript では、KiiObject にセットした JSON オブジェクトや JSON オブジェクトの配列などを型に関係なく取得できます。

複雑なデータ型の設定のサンプルコードでセットした値を取得する例を以下に挙げます。

// Get a value of a JSON object.
var jsonObject = object.get("myObject");
console.log(JSON.stringify(jsonObject));

// Get a value of a JSON array.
var jsonArray = object.get("myArray");
console.log(JSON.stringify(jsonArray));