KiiObject の取得

Kii Cloud 上に登録された KiiObject を取得する方法には、ID や URI によって特定の KiiObject 1 つを指定する方法と、KiiObject の検索によって Bucket 内で条件に一致した KiiObject をまとめて取得する方法があります。ここでは IR や URI を使って取得する方法を示します。

いずれの場合も、取得した KiiObject を参照することで、その KiiObject 内に保存されたキーと値のペア等のデータを取得できます。取得した KiiObject からキーと値のペアを取得する方法は、キーと値のペアの取得を参照してください。

ID や URI によって KiiObject を取得するには、KiiObject を作成した際に ID や URI を取得し、どこかに保存しておく必要があります。次回、同じ KiiObject を参照する必要が生じた際に、保存しておいた ID や URI を使って KiiObject を取得できます。

ID と KiiObject

KiiObject の ID を取得

既存 KiiObject の toURI() メソッドを使い KiiObject の URI を取得した後に、ID 部分を切り出します。

// Get the ID of an existing KiiObject.
String uri = object.toUri().toString();
String id = uri.substring(uri.lastIndexOf('/') + 1);

ID を使って KiiObject を参照

ID を指定して取得したい KiiObject が属する Bucket の object() メソッドを実行し、KiiObject のインスタンスを生成します。

// Instantiate a KiiObject in a bucket "_app_bucket_" in the application scope.
KiiObject object = Kii.bucket("_app_bucket_").object(id);

try {
  // Refresh the KiiObject to retrieve the latest data from Kii Cloud.
  object.refresh();
} catch (IOException e) {
  // Handle the error.
} catch (AppException e) {
  // Handle the error.
}

// Instantiate a KiiObject in a bucket "_app_bucket_" in the application scope.
KiiObject object = Kii.bucket("_app_bucket_").object(id);

// Refresh the KiiObject to retrieve the latest data from Kii Cloud.
object.refresh(new KiiObjectCallBack() {
  @Override
  public void onRefreshCompleted(int token, KiiObject object, Exception exception) {
    if (exception != null) {
      // Handle the error.
      return;
    }
  }
});

KiiObject の ID は Bucket 内だけで一意となるため、KiiObject インスタンスの生成は上記の例のように明示的に対象 Bucket を指定して行います。なお設計上、Bucket が異なると同一の ID が取得されることがあります。関連する情報はオブジェクトの ID と URI をご覧ください。

インスタンス生成後、この KiiObject のキーと値のペアにアクセスする前に refresh() メソッドを実行します。refresh() メソッドを実行すると KiiObject の最新データが Kii Cloud より取得され、KiiObject の中身がこの内容に更新されます。KiiObject のインスタンスを生成しただけでは、KiiObject の中身は最新のものにならない点に注意してください。

URI と KiiObject

KiiObject の URI を取得

既存 Object の toURI() メソッドを使い、この KiiObject の URI を取得します。

// Get the URL of an existing KiiObject.
Uri uri = object.toUri();

URI を使って KiiObject を参照

URI を指定して createByUri() メソッドを実行し、対象 KiiObject のインスタンスを生成します。

// Instantiate a KiiObject.
KiiObject object = KiiObject.createByUri(uri);

try {
  // Refresh the KiiObject to retrieve the latest data from Kii Cloud.
  object.refresh();
} catch (IOException e) {
  // Handle the error.
} catch (AppException e) {
  // Handle the error.
}

// Instantiate a KiiObject.
KiiObject object = KiiObject.createByUri(uri);

// Refresh the KiiObject to retrieve the latest data from Kii Cloud.
object.refresh(new KiiObjectCallBack() {
  @Override
  public void onRefreshCompleted(int token, KiiObject object, Exception exception) {
    if (exception != null) {
      // Handle the error.
      return;
    }
  }
});

KiiObject の URI には KiiObject が属する Bucket の情報が含まれています。このため、上記の例のようにインスタンス生成時に対象 Bucket の指定は不要です。関連する情報はオブジェクトの ID と URI をご覧ください。

特に createByUri() メソッドを実行した場合、refresh() メソッドを実行するまでこの KiiObject の ID は設定されていない状態です。ID の取得は、必ず refresh() メソッドを実行してから行ってください。