Thing の取得と保存/復元

Thing は 識別子 として Thing ベンダーが割り当てた ID(vendorThingID)と Kii Cloud が発行した ID(thingID)を持ちます。Thing はこれらのいずれかの識別子を使って取得できます。

また、一旦取得した Thing は Bundle に保存することで、後にアクティビティが新たに起動した際に復元できます。

Thing の取得と保存

vendorThingID を指定して Thing を取得

以下、Kii Cloud 上で作成済みの Thing を vendorThingID 指定で取得する例を挙げます。

Android

  • try {
      // Instantiate a thing by vendor thing ID.
      KiiThing thing = KiiThing.loadWithVendorThingID("rBnvSPOXBDF9r29GJeGS");
    
      // Create a bundle and save the thing.
      Bundle bundle = new Bundle();
      bundle.putParcelable("my_thing", thing);
    } catch (AppException e) {
      // Handle the error.
    } catch (IOException e) {
      // Handle the error.
    }
  • // Instantiate a thing by vendor thing ID.
    KiiThing.loadWithVendorThingID("rBnvSPOXBDF9r29GJeGS", new KiiCallback<KiiThing>() {
      @Override
      public void onComplete(KiiThing result, Exception e) {
        if (e != null) {
          // Handle the error.
          return;
        }
    
        // Create a bundle and save the thing.
        Bundle bundle = new Bundle();
        bundle.putParcelable("my_thing", thing);
      }
    });

この例では、後に復元を行うために Thing を Bundle に保存しています。Thing のインスタンスは Parcelable を実装しているため Bundle に保存することができます。復元方法については こちら を参照してください。

iOS

Swift 3:

  • let thing : KiiThing
    
    do{
      // Instantiate a thing by vendor thing ID.
      thing = try KiiThing.loadSynchronous(withVendorThingID: "rBnvSPOXBDF9r29GJeGS")
    }catch(let error as NSError){
      // Handle the error.
      return
    }
  • // Instantiate a thing by vendor thing ID.
    KiiThing.load(withVendorThingID: "rBnvSPOXBDF9r29GJeGS") { (thing , error) -> Void in
      if error != nil {
        // Handle the error.
        return
      }
    }

Objective-C:

  • NSError* error = nil;
    
    // Instantiate a thing by vendor thing ID.
    KiiThing* thing = [KiiThing loadSynchronousWithVendorThingID:@"rBnvSPOXBDF9r29GJeGS"
                                                           error:&error];
    if (error != nil) {
      // Handle the error.
      return;
    }
  • // Instantiate a thing by vendor thing ID.
    [KiiThing loadWithVendorThingID:@"rBnvSPOXBDF9r29GJeGS"
                              block:^(KiiThing *thing, NSError *error) {
      if (error != nil) {
        // Handle the error.
        return;
      }
    }];

JavaScript

// Instantiate a thing by vendor thing ID.
KiiThing.loadWithVendorThingID("rBnvSPOXBDF9r29GJeGS", {
  success: function(thing) {
    // Do something.
  },
  failure: function(error) {
    // Handle the error.
  }
});

thingID を指定して Thing を取得

以下、Kii Cloud 上で作成済みの Thing を thingID 指定で取得する例を挙げます。

Android

  • try {
      // Instantiate a thing by thing ID.
      KiiThing thing = KiiThing.loadWithThingID("78924c8vy2984298vvc2");
    
        // Create a bundle and save the thing.
        Bundle bundle = new Bundle();
        bundle.putParcelable("my_thing", thing);
    } catch (AppException e) {
      // Handle the error.
    } catch (IOException e) {
      // Handle the error.
    }
  • // Instantiate a thing by thing ID.
    KiiThing.loadWithThingID("78924c8vy2984298vvc2", new KiiCallback<KiiThing>() {
      @Override
      public void onComplete(KiiThing result, Exception e) {
        if (e != null) {
          // Handle the error.
          return;
        }
    
        // Create a bundle and save the thing.
        Bundle bundle = new Bundle();
        bundle.putParcelable("my_thing", thing);
      }
    });

この例では、後に復元を行うために Thing を Bundle に保存しています。Thing のインスタンスは Parcelable を実装しているため Bundle に保存することができます。復元方法については こちら を参照してください。

iOS

Swift 3:

  • let thing : KiiThing
    
    do{
      // Instantiate a thing by thing ID.
      thing = try KiiThing.loadSynchronous(withThingID: "th.rBnvSPOXBDF9r29GJeGS")
    }catch(let error as NSError){
      // Handle the error.
      return
    }
  • // Instantiate a thing by thing ID.
    KiiThing.load(withThingID: "th.rBnvSPOXBDF9r29GJeGS") { (thing , error) -> Void in
      if error != nil {
        // Handle the error.
        return
      }
    }

Objective-C:

  • NSError* error = nil;
    
    // Instantiate a thing by thing ID.
    KiiThing* thing = [KiiThing loadSynchronousWithThingID:@"th.rBnvSPOXBDF9r29GJeGS"
                                                     error:&error];
    if (error != nil) {
      // Handle the error.
      return;
    }
  • // Instantiate a thing by thing ID.
    [KiiThing loadWithThingID:@"th.rBnvSPOXBDF9r29GJeGS"
                        block:^(KiiThing *thing, NSError *error) {
      if (error != nil) {
        // Handle the error.
        return;
      }
    }];

JavaScript

// Instantiate a thing by thing ID.
KiiThing.loadWithThingID("78924c8vy2984298vvc2", {
  success: function(thing) {
    // Do something.
  },
  failure: function(error) {
    // Handle the error.
  }
});

自分がオーナーになっている Thing の一覧を取得

ログイン中のユーザー、またはログイン中のユーザーがメンバーのグループがオーナーになっている Thing の一覧を取得する例を挙げます。下記の例はこの条件に該当する Thing をすべて取得しますが、KiiThingQuery クラスの setThingType() メソッドなどを使うと Thing タイプでフィルターすることができます。

Android

  • // Get the current user.
    KiiUser user = KiiUser.getCurrentUser();
    
    // Create a query for things owned by the current user or the groups that the current user is a member of.
    KiiThingQuery query = new KiiThingQuery(user, user.memberOfGroups());
    
    // Query things.
    KiiThingQueryResult result = KiiThing.query(query);
    
    List<KiiThing> things = result.getResult();
    for (KiiThing thing : things) {
      // Do something.
    }
  • // Get the current user.
    KiiUser user = KiiUser.getCurrentUser();
    
    // Get a list of groups that the current user is a member of.
    user.memberOfGroups(new KiiUserCallBack() {
      @Override
      public void onMemberOfGroupsCompleted(int token, KiiUser user, List<KiiGroup> groupList, Exception exception) {
        if (exception != null) {
          // Handle the error.
          return;
        }
    
        // Create a query for things owned by the current user or the groups that the current user is a member of.
        KiiThingQuery query = new KiiThingQuery(user, groupList);
    
        // Query things.
        KiiThing.query(query, new KiiCallback<KiiThingQueryResult>() {
          @Override
          public void onComplete(KiiThingQueryResult result, Exception e) {
            List<KiiThing> things = result.getResult();
            for (KiiThing thing : things) {
              // Do something.
            }
          }
        });
      }
    });

検索結果の処理方法は KiiObject の検索 と同じです。必要に応じてページネーションの処理を行います。

iOS

Swift 3:

  • // Get the current user.
    let user : KiiUser = KiiUser.current()!
    
    do{
      // Get a list of groups that the current user is a member of.
      let groups = try user.memberOfGroupsSynchronous() as! [KiiGroup]
    
      // Create a query for things owned by the current user or the groups that the current user is a member of.
      let query = KiiThingQuery(user, groups: groups)
    
      // Query things.
      let queryResult = try KiiThing.querySynchronous(query)
      for thing in queryResult.results! {
        // Do something.
      }
    }catch(let error as NSError){
      // Handle the error.
      return
    }
  • // Get a list of groups that the current user is a member of.
    KiiUser.current()?.memberOfGroups({ (user, groups , error) in
      // Create a query for things owned by the current user or the groups that the current user is a member of.
      let query = KiiThingQuery(user, groups: (groups as! [KiiGroup]))
    
      // Query things.
      KiiThing.query(query, block: { (queryResult, query, error) in
        if error != nil {
          // Handle the error.
          return
        }
        for thing in queryResult.results! {
          // Do something.
        }
      })
    })

Objective-C:

  • NSError* error = nil;
    
    // Get the current user.
    KiiUser* user = [KiiUser currentUser];
    
    // Get a list of groups that the current user is a member of.
    NSArray* groups = [user memberOfGroupsSynchronous:&error];
    
    // Create a query for things owned by the current user or the groups that the current user is a member of.
    KiiThingQuery* query = [KiiThingQuery thingQuery:user groups:groups];
    
    // Query things.
    KiiThingQueryResult* queryResult = [KiiThing querySynchronous:query error:&error];
    
    NSArray<KiiThing * > * results = queryResult.results;
    for(KiiThing * thing in results ){
      // Do something.
    }
  • // Get the current user.
    KiiUser *user = [KiiUser currentUser];
    
    // Get a list of groups that the current user is a member of.
    [user memberOfGroupsWithBlock:^(KiiUser * _Nonnull user, NSArray * _Nullable groups, NSError * _Nullable error) {
      // Create a query for things owned by the current user or the groups that the current user is a member of.
      KiiThingQuery* query = [KiiThingQuery thingQuery:user groups:groups];
    
      // Query things.
      [KiiThing query:query block:^(KiiThingQueryResult * _Nullable queryResult, KiiThingQuery * _Nullable query, NSError * _Nullable error) {
        NSArray<KiiThing * > * results = queryResult.results;
        for(KiiThing * thing in results ){
          // Do something.
        }
      }];
    }];

JavaScript

// Get a list of groups that the current user is a member of.
KiiUser.getCurrentUser().memberOfGroups({
  success: function(user, groupList) {
    // Create a query for things owned by the current user or the groups that the current user is a member of.
    var query = KiiThingQuery.thingQuery(user, groupList);

    // Query things.
    KiiThing.executeQuery(query, {
      success: function(result) {
        var resultSet = result.getResult();
        for(var i = 0; i < resultSet.length; i++) {
          var thing = resultSet[i];
          // Do something.
        }
        if (result.hasNext()) {
          // Get the next page of the result.
          result.getNextResult({
            success: function(result) {
              // Handle the next page of the result.
              var resultSet = result.getResult();
            },
            failure: function(err) {
              // Handle the error.
            }
          });
        }
      },
      failure: function(err) {
        // Handle the error.
      }
    });
  },
  failure: function(theUser, errorString) {
    // Handle the error.
  }
});

Thing のリフレッシュ

以下、サーバーから最新の Thing の情報を取得して、KiiThing インスタンスに反映するサンプルコードです。

loadWithVendorThingID() メソッドや loadWithThingID() メソッドを使って作成した KiiThing インスタンスには、すでに最新の情報が反映されているため、この処理を実行する必要はありません。

Android

  • // Instantiate a thing.
    KiiThing thing = ...
    
    try {
      // Refresh the thing.
      thing.refresh();
    } catch (AppException e) {
      // Handle the error.
    } catch (IOException e) {
      // Handle the error.
    }
  • // Instantiate a thing.
    KiiThing thing = ...
    
    // Refresh the thing.
    thing.refresh(new KiiCallback<KiiThing>() {
      @Override
      public void onComplete(KiiThing result, Exception e) {
        if (e != null) {
          // Handle the error.
          return;
        }
      }
    });

iOS

Swift 3:

  • // Instantiate a thing.
    let thing = ... : KiiThing
    
    do{
      // Refresh the thing.
      try thing.refreshSynchronous()
    }catch(let error as NSError){
      // Handle the error.
      return
    }
  • // Instantiate a thing.
    let thing = ... : KiiThing
    
    // Refresh the thing.
    thing.refresh() { (thing, error) -> Void in
      if error != nil {
        // Handle the error.
        return
      }
    }

Objective-C:

  • // Instantiate a thing.
    KiiThing *thing = ...;
    
    NSError *error = nil;
    
    // Refresh the thing.
    [thing refreshSynchronous:&error];
    if (error != nil) {
      // Handle the error.
      return;
    }
  • // Instantiate a thing.
    KiiThing *thing = ...;
    
    // Refresh the thing.
    thing refresh:^(KiiThing *thing, NSError *error) {
      if (error != nil) {
        // Handle the error.
        return;
      }
    }];

JavaScript

// Instantiate a thing.
var thing = ...;

// Refresh the thing.
thing.refresh({
  success: function(thing) {
    // Do something.
  },
  failure: function(error) {
    // Handle the error.
  }
});

Thing の復元(Android のみ)

以下、Bundle に保存していた Thing を復元し、Kii Cloud 上にある最新の状態に更新するサンプルコードです。

Android

  • try {
      // Restore a thing from a bundle.
      KiiThing thing = (KiiThing)bundle.getParcelable("my_thing");
    
      // Refresh the thing.
      thing.refresh();
    } catch (AppException e) {
      // Handle the error.
    } catch (IOException e) {
      // Handle the error.
    }
  • // Restore a thing from a bundle.
    KiiThing thing = (KiiThing)bundle.getParcelable("my_thing");
    
    // Refresh the thing.
    thing.refresh(new KiiCallback<KiiThing>() {
      @Override
      public void onComplete(KiiThing result, Exception e) {
        if (e != null) {
          // Handle the error.
          return;
        }
      }
    });

基本手順は以下のとおりです。

  1. Bundle から保存していた Thing のインスタンスを取得します。
  2. refresh メソッドを実行して Kii Cloud より最新の Thing を取得します。