Bucket の作成

Kii Cloud にデータを格納するにはまず Bucket を作成する必要があります。

Bucket の名前

Bucket を作成する際には、下記の例外を除いて任意の名前をつけることができます。この名前は作成済みの Bucket を参照するときに使用します。

Bucket の命名に関するルールは次のとおりです。

以下は予約語のため利用できません。
- users
- devices
- installations
- internal
- things
"_"（アンダースコア）で始まる名前は利用できません。
英数字、"_"（アンダースコア）、"-"（ハイフン）から構成される 2～64 文字の名前として指定します。
Bucket の名前はアプリケーションスコープ、グループスコープ、ユーザースコープで同じものを使用できますが、それぞれ違う Bucket として認識されます。

Bucket の作成

Bucket はアプリケーションスコープ、グループスコープ、ユーザースコープのいずれのスコープにも作成できます。

アプリケーションスコープ

アプリケーションスコープの Bucket は、アプリケーション上に所属するため、他のスコープのように所属するインスタンスを選択する必要がありません。

Kii クラスが提供するスタティックメソッド bucket() を実行して作成します。
```
// Create a bucket in the application scope.
KiiBucket appBucket = Kii.bucket("my_app");
```
アプリケーションスコープはすべてのユーザーから参照できるため、モバイルアプリで利用できるデータを置く場所としても利用できます。設定情報やテキストデータなどの JSON 形式で表現できるデータであれば、キーと値のペアとして KiiObject に格納しておくことができます。また、画像やサウンドなどのリソースであれば、Object Body としてアップロードしておくことができます。

なお、アプリケーションスコープを使用する場合はセキュリティにご注意ください。セキュリティに示すように、アプリケーションスコープは AppID と AppKey があれば、モバイルアプリ外からもアクセスできるため、顧客情報のような機密情報を保存する用途には向いていません。このような場合は、Server Code と ACL の削除を使って、管理者だけからアクセスできる領域を用意することで回避できます。実装方法のヒントは管理者をご覧ください。
グループスコープ

グループスコープの Bucket は、特定のグループの配下にデータを保存するための Bucket です。

Bucket を作成したいグループの KiiGroup インスタンスを取得し、その bucket() メソッドを実行して作成します。
```
// Create a bucket in the group scope. Login is required.
KiiBucket groupBucket = group.bucket("my_group");
```
ユーザースコープ

ユーザースコープの Bucket は、特定のユーザーの配下にデータを保存するための Bucket です。

Bucket を作成したいユーザーの KiiUser のインスタンスを取得し、その bucket() メソッドを実行して作成します。
```
// Create a bucket in the user scope. Login is required.
KiiBucket userBucket = user.bucket("my_private");
```

Bucket の作成タイミング

Bucket インスタンスを作成した段階では、Kii Cloud 上に Bucket は生成されていないことに注意してください。Bucket は、その中に KiiObject を保存した際に生成されます。たとえば、以下の例のように save() メソッドをコールして KiiObject が生成されたタイミングで userBucket が Kii Cloud 上に生成されます。

KiiObject object = userBucket.object();
try {
  object.save();
} catch (IOException e) {
  // Handle the error.
} catch (AppException e) {
  // Handle the error.
}

KiiObject object = userBucket.object();
object.save(new KiiObjectCallBack() {
  @Override
  public void onSaveCompleted(int token, KiiObject object, Exception exception) {
    if (exception != null) {
      // Handle the error.
      return;
    }
  }
});

Bucket 一覧機能の実装ヒント

Bucket 一覧の機能が必要な場合、アプリ側での実装が必要となります。

通常、Bucket は Bucket 名を使ってプログラムから固定的にアクセスするため、一覧が必要となるケースはあまりないはずです。動的に Bucket を生成するような特殊なケースで一覧が必要な場合は、アプリケーションスコープに Bucket 名の一覧の情報を格納するなどの方法をとれます。実装方法は、ユーザー一覧の実装方法を参考にしてください。