/* * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). * You may not use this file except in compliance with the License. * A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either * express or implied. See the License for the specific language governing * permissions and limitations under the License. */ using System; using System.Collections.Generic; using System.Linq; using Amazon.DynamoDBv2; namespace Amazon.DynamoDBv2.DataModel { /// /// A strongly-typed object for retrieving search results (Query or Scan) /// from DynamoDB. /// /// public partial class AsyncSearch { #region Async public /// /// Initiates the asynchronous execution to get the next set of results from DynamoDB. /// /// An AsyncCallback delegate that is invoked when the operation completes. /// A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback /// procedure using the AsyncState property. /// /// An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndGetNextSet /// operation. public IAsyncResult BeginGetNextSet(AsyncCallback callback, object state) { return DynamoDBAsyncExecutor.BeginOperation(() => { var documents = DocumentSearch.GetNextSetHelper(); List items = SourceContext.FromDocumentsHelper(documents, Config).ToList(); return items; }, callback, state); } /// /// Finishes the asynchronous execution of the BeginGetNextSet operation. /// /// If there are more items in the Scan/Query, PaginationToken will be /// set and can be consumed in a new Scan/Query operation to resume /// retrieving items from this point. /// /// The IAsyncResult returned by the call to BeginGetNextSet. public List EndGetNextSet(IAsyncResult asyncResult) { return DynamoDBAsyncExecutor.EndOperation>(asyncResult) as List; } /// /// Initiates the asynchronous execution to get all the remaining results from DynamoDB. /// /// An AsyncCallback delegate that is invoked when the operation completes. /// A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback /// procedure using the AsyncState property. /// /// An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndGetRemaining /// operation. public IAsyncResult BeginGetRemaining(AsyncCallback callback, object state) { return DynamoDBAsyncExecutor.BeginOperation(() => { var documents = DocumentSearch.GetRemainingHelper(); List items = SourceContext.FromDocumentsHelper(documents, Config).ToList(); return items; }, callback, state); } /// /// Finishes the asynchronous execution of the BeginGetRemaining operation. /// /// The IAsyncResult returned by the call to BeginGetNextSet. public List EndGetRemaining(IAsyncResult asyncResult) { return DynamoDBAsyncExecutor.EndOperation>(asyncResult); } #endregion } }