行の取得

特定の行を取得する

getRow()メソッドを使用して、指定されたインスタンスのData Storeテーブルから特定の行を取得できます。以下のコード構文に示すように、行の一意のROWIDをこのメソッドの引数として渡します。

以下のコードで使用されている<DATA_STORE_INSTANCE>は、Data Storeインスタンスページで定義されたインスタンスです。

<DATA_STORE_INSTANCE>.getRow(id : Int64, completion: @escaping (Result<ZCatalystRow, ZCatalystError>) -> Void)

パラメータ:

• id: 取得する特定の行の一意のROWID
• completion: 操作が成功した場合、completionブロックは行の詳細を返します。それ以外の場合は、エラーを返します。

サンプルコードスニペットは以下の通りです:

ZCatalystApp.shared.getDataStoreInstance(tableIdentifier : "EmployeeDetails").getRow(id: 1096000000002845){( result ) in
// これをあなたのテーブル識別子とROW IDに置き換えてください       
switch result{
  case .success ( let row) :
   print(row.id)
  case .error( let error ) :
   print( "Error occurred >>> \( error )" )
 }
}

ページネーションを使用して行を取得する

ページネーションをコードに組み込むことで、Data Storeのテーブルからすべての行を取得できます。ページネーションを使用すると、テーブルの行をバッチまたはページとして反復的に取得できます。

たとえば、100件ずつのバッチで個別のページとして行を取得する場合、各ページで取得する最大行数を定義し、以下に示すようにmaxRowsを使用してカウントを指定できます。

さらに、ループの各実行後に、後続のデータ取得を認可するトークン文字列がレスポンスで返されます。後続の反復時に、これをnextTokenの値として渡すことができます。ループの最初の実行時には、nextToken文字列は渡されません。

以下のコードスニペットで使用されている<DATA_STORE_INSTANCE>は、Data Storeインスタンスページで定義されたインスタンスです。

<DATA_STORE_INSTANCE>.getRows(nextToken : String?, maxRecord : String?, completion: @escaping (Result<[ZCatalystRow], ZCatalystError>) -> Void)

パラメータ:

• maxRows: この反復で取得する最大行数
• nextToken: 次の行セットを取得するための認可トークン

最初の反復後にすべての残りの行を取得する場合は、maxRowsの制限を渡さないこともできます。すべての行が取得されると、ページネーションは完了します。

すべての行を取得する

以下のコード構文に示すように、getRows()メソッドを使用して、指定されたインスタンスのテーブルのすべての行を取得できます。操作が成功すると、このメソッドはフィルターや条件なしでテーブルのすべての行を返します。

以下のコードで使用されている<DATA_STORE_INSTANCE>は、Data Storeインスタンスページで定義されたインスタンスです。

<DATA_STORE_INSTANCE>.getRows(completion: @escaping (Result<[ZCatalystRow], ZCatalystError>) -> Void)

パラメータ:

• completion: 操作が成功した場合、completionブロックはすべての行の詳細を返します。それ以外の場合は、エラーを返します。

サンプルコードスニペットは以下の通りです:

ZCatalystApp.shared.getDataStoreInstance(tableIdentifier : "EmployeeDetails").getRows{ ( result ) in      
//これをあなたのテーブル名に置き換えてください             
switch result{
  case .success ( let rows) :
   for row in rows{
    print(row.id)
   }
  case .error( let error ) :
   print( "Error occurred >>> \( error )" )
 }
}