/** * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. * SPDX-License-Identifier: Apache-2.0. */ #pragma once #include #include #include #include #include #include #include namespace Aws { template class AmazonWebServiceResult; namespace Utils { namespace Json { class JsonValue; } // namespace Json } // namespace Utils namespace DynamoDB { namespace Model { /** *

Represents the output of a Scan operation.

See * Also:

AWS * API Reference

*/ class ScanResult { public: AWS_DYNAMODB_API ScanResult(); AWS_DYNAMODB_API ScanResult(const Aws::AmazonWebServiceResult& result); AWS_DYNAMODB_API ScanResult& operator=(const Aws::AmazonWebServiceResult& result); /** *

An array of item attributes that match the scan criteria. Each element in * this array consists of an attribute name and the value for that attribute.

*/ inline const Aws::Vector>& GetItems() const{ return m_items; } /** *

An array of item attributes that match the scan criteria. Each element in * this array consists of an attribute name and the value for that attribute.

*/ inline void SetItems(const Aws::Vector>& value) { m_items = value; } /** *

An array of item attributes that match the scan criteria. Each element in * this array consists of an attribute name and the value for that attribute.

*/ inline void SetItems(Aws::Vector>&& value) { m_items = std::move(value); } /** *

An array of item attributes that match the scan criteria. Each element in * this array consists of an attribute name and the value for that attribute.

*/ inline ScanResult& WithItems(const Aws::Vector>& value) { SetItems(value); return *this;} /** *

An array of item attributes that match the scan criteria. Each element in * this array consists of an attribute name and the value for that attribute.

*/ inline ScanResult& WithItems(Aws::Vector>&& value) { SetItems(std::move(value)); return *this;} /** *

An array of item attributes that match the scan criteria. Each element in * this array consists of an attribute name and the value for that attribute.

*/ inline ScanResult& AddItems(const Aws::Map& value) { m_items.push_back(value); return *this; } /** *

An array of item attributes that match the scan criteria. Each element in * this array consists of an attribute name and the value for that attribute.

*/ inline ScanResult& AddItems(Aws::Map&& value) { m_items.push_back(std::move(value)); return *this; } /** *

The number of items in the response.

If you set * ScanFilter in the request, then Count is the number of * items returned after the filter was applied, and ScannedCount is * the number of matching items before the filter was applied.

If you did * not use a filter in the request, then Count is the same as * ScannedCount.

*/ inline int GetCount() const{ return m_count; } /** *

The number of items in the response.

If you set * ScanFilter in the request, then Count is the number of * items returned after the filter was applied, and ScannedCount is * the number of matching items before the filter was applied.

If you did * not use a filter in the request, then Count is the same as * ScannedCount.

*/ inline void SetCount(int value) { m_count = value; } /** *

The number of items in the response.

If you set * ScanFilter in the request, then Count is the number of * items returned after the filter was applied, and ScannedCount is * the number of matching items before the filter was applied.

If you did * not use a filter in the request, then Count is the same as * ScannedCount.

*/ inline ScanResult& WithCount(int value) { SetCount(value); return *this;} /** *

The number of items evaluated, before any ScanFilter is applied. * A high ScannedCount value with few, or no, Count * results indicates an inefficient Scan operation. For more * information, see Count * and ScannedCount in the Amazon DynamoDB Developer Guide.

If * you did not use a filter in the request, then ScannedCount is the * same as Count.

*/ inline int GetScannedCount() const{ return m_scannedCount; } /** *

The number of items evaluated, before any ScanFilter is applied. * A high ScannedCount value with few, or no, Count * results indicates an inefficient Scan operation. For more * information, see Count * and ScannedCount in the Amazon DynamoDB Developer Guide.

If * you did not use a filter in the request, then ScannedCount is the * same as Count.

*/ inline void SetScannedCount(int value) { m_scannedCount = value; } /** *

The number of items evaluated, before any ScanFilter is applied. * A high ScannedCount value with few, or no, Count * results indicates an inefficient Scan operation. For more * information, see Count * and ScannedCount in the Amazon DynamoDB Developer Guide.

If * you did not use a filter in the request, then ScannedCount is the * same as Count.

*/ inline ScanResult& WithScannedCount(int value) { SetScannedCount(value); return *this;} /** *

The primary key of the item where the operation stopped, inclusive of the * previous result set. Use this value to start a new operation, excluding this * value in the new request.

If LastEvaluatedKey is empty, then * the "last page" of results has been processed and there is no more data to be * retrieved.

If LastEvaluatedKey is not empty, it does not * necessarily mean that there is more data in the result set. The only way to know * when you have reached the end of the result set is when * LastEvaluatedKey is empty.

*/ inline const Aws::Map& GetLastEvaluatedKey() const{ return m_lastEvaluatedKey; } /** *

The primary key of the item where the operation stopped, inclusive of the * previous result set. Use this value to start a new operation, excluding this * value in the new request.

If LastEvaluatedKey is empty, then * the "last page" of results has been processed and there is no more data to be * retrieved.

If LastEvaluatedKey is not empty, it does not * necessarily mean that there is more data in the result set. The only way to know * when you have reached the end of the result set is when * LastEvaluatedKey is empty.

*/ inline void SetLastEvaluatedKey(const Aws::Map& value) { m_lastEvaluatedKey = value; } /** *

The primary key of the item where the operation stopped, inclusive of the * previous result set. Use this value to start a new operation, excluding this * value in the new request.

If LastEvaluatedKey is empty, then * the "last page" of results has been processed and there is no more data to be * retrieved.

If LastEvaluatedKey is not empty, it does not * necessarily mean that there is more data in the result set. The only way to know * when you have reached the end of the result set is when * LastEvaluatedKey is empty.

*/ inline void SetLastEvaluatedKey(Aws::Map&& value) { m_lastEvaluatedKey = std::move(value); } /** *

The primary key of the item where the operation stopped, inclusive of the * previous result set. Use this value to start a new operation, excluding this * value in the new request.

If LastEvaluatedKey is empty, then * the "last page" of results has been processed and there is no more data to be * retrieved.

If LastEvaluatedKey is not empty, it does not * necessarily mean that there is more data in the result set. The only way to know * when you have reached the end of the result set is when * LastEvaluatedKey is empty.

*/ inline ScanResult& WithLastEvaluatedKey(const Aws::Map& value) { SetLastEvaluatedKey(value); return *this;} /** *

The primary key of the item where the operation stopped, inclusive of the * previous result set. Use this value to start a new operation, excluding this * value in the new request.

If LastEvaluatedKey is empty, then * the "last page" of results has been processed and there is no more data to be * retrieved.

If LastEvaluatedKey is not empty, it does not * necessarily mean that there is more data in the result set. The only way to know * when you have reached the end of the result set is when * LastEvaluatedKey is empty.

*/ inline ScanResult& WithLastEvaluatedKey(Aws::Map&& value) { SetLastEvaluatedKey(std::move(value)); return *this;} /** *

The primary key of the item where the operation stopped, inclusive of the * previous result set. Use this value to start a new operation, excluding this * value in the new request.

If LastEvaluatedKey is empty, then * the "last page" of results has been processed and there is no more data to be * retrieved.

If LastEvaluatedKey is not empty, it does not * necessarily mean that there is more data in the result set. The only way to know * when you have reached the end of the result set is when * LastEvaluatedKey is empty.

*/ inline ScanResult& AddLastEvaluatedKey(const Aws::String& key, const AttributeValue& value) { m_lastEvaluatedKey.emplace(key, value); return *this; } /** *

The primary key of the item where the operation stopped, inclusive of the * previous result set. Use this value to start a new operation, excluding this * value in the new request.

If LastEvaluatedKey is empty, then * the "last page" of results has been processed and there is no more data to be * retrieved.

If LastEvaluatedKey is not empty, it does not * necessarily mean that there is more data in the result set. The only way to know * when you have reached the end of the result set is when * LastEvaluatedKey is empty.

*/ inline ScanResult& AddLastEvaluatedKey(Aws::String&& key, const AttributeValue& value) { m_lastEvaluatedKey.emplace(std::move(key), value); return *this; } /** *

The primary key of the item where the operation stopped, inclusive of the * previous result set. Use this value to start a new operation, excluding this * value in the new request.

If LastEvaluatedKey is empty, then * the "last page" of results has been processed and there is no more data to be * retrieved.

If LastEvaluatedKey is not empty, it does not * necessarily mean that there is more data in the result set. The only way to know * when you have reached the end of the result set is when * LastEvaluatedKey is empty.

*/ inline ScanResult& AddLastEvaluatedKey(const Aws::String& key, AttributeValue&& value) { m_lastEvaluatedKey.emplace(key, std::move(value)); return *this; } /** *

The primary key of the item where the operation stopped, inclusive of the * previous result set. Use this value to start a new operation, excluding this * value in the new request.

If LastEvaluatedKey is empty, then * the "last page" of results has been processed and there is no more data to be * retrieved.

If LastEvaluatedKey is not empty, it does not * necessarily mean that there is more data in the result set. The only way to know * when you have reached the end of the result set is when * LastEvaluatedKey is empty.

*/ inline ScanResult& AddLastEvaluatedKey(Aws::String&& key, AttributeValue&& value) { m_lastEvaluatedKey.emplace(std::move(key), std::move(value)); return *this; } /** *

The primary key of the item where the operation stopped, inclusive of the * previous result set. Use this value to start a new operation, excluding this * value in the new request.

If LastEvaluatedKey is empty, then * the "last page" of results has been processed and there is no more data to be * retrieved.

If LastEvaluatedKey is not empty, it does not * necessarily mean that there is more data in the result set. The only way to know * when you have reached the end of the result set is when * LastEvaluatedKey is empty.

*/ inline ScanResult& AddLastEvaluatedKey(const char* key, AttributeValue&& value) { m_lastEvaluatedKey.emplace(key, std::move(value)); return *this; } /** *

The primary key of the item where the operation stopped, inclusive of the * previous result set. Use this value to start a new operation, excluding this * value in the new request.

If LastEvaluatedKey is empty, then * the "last page" of results has been processed and there is no more data to be * retrieved.

If LastEvaluatedKey is not empty, it does not * necessarily mean that there is more data in the result set. The only way to know * when you have reached the end of the result set is when * LastEvaluatedKey is empty.

*/ inline ScanResult& AddLastEvaluatedKey(const char* key, const AttributeValue& value) { m_lastEvaluatedKey.emplace(key, value); return *this; } /** *

The capacity units consumed by the Scan operation. The data * returned includes the total provisioned throughput consumed, along with * statistics for the table and any indexes involved in the operation. * ConsumedCapacity is only returned if the * ReturnConsumedCapacity parameter was specified. For more * information, see Provisioned * Throughput in the Amazon DynamoDB Developer Guide.

*/ inline const ConsumedCapacity& GetConsumedCapacity() const{ return m_consumedCapacity; } /** *

The capacity units consumed by the Scan operation. The data * returned includes the total provisioned throughput consumed, along with * statistics for the table and any indexes involved in the operation. * ConsumedCapacity is only returned if the * ReturnConsumedCapacity parameter was specified. For more * information, see Provisioned * Throughput in the Amazon DynamoDB Developer Guide.

*/ inline void SetConsumedCapacity(const ConsumedCapacity& value) { m_consumedCapacity = value; } /** *

The capacity units consumed by the Scan operation. The data * returned includes the total provisioned throughput consumed, along with * statistics for the table and any indexes involved in the operation. * ConsumedCapacity is only returned if the * ReturnConsumedCapacity parameter was specified. For more * information, see Provisioned * Throughput in the Amazon DynamoDB Developer Guide.

*/ inline void SetConsumedCapacity(ConsumedCapacity&& value) { m_consumedCapacity = std::move(value); } /** *

The capacity units consumed by the Scan operation. The data * returned includes the total provisioned throughput consumed, along with * statistics for the table and any indexes involved in the operation. * ConsumedCapacity is only returned if the * ReturnConsumedCapacity parameter was specified. For more * information, see Provisioned * Throughput in the Amazon DynamoDB Developer Guide.

*/ inline ScanResult& WithConsumedCapacity(const ConsumedCapacity& value) { SetConsumedCapacity(value); return *this;} /** *

The capacity units consumed by the Scan operation. The data * returned includes the total provisioned throughput consumed, along with * statistics for the table and any indexes involved in the operation. * ConsumedCapacity is only returned if the * ReturnConsumedCapacity parameter was specified. For more * information, see Provisioned * Throughput in the Amazon DynamoDB Developer Guide.

*/ inline ScanResult& WithConsumedCapacity(ConsumedCapacity&& value) { SetConsumedCapacity(std::move(value)); return *this;} inline const Aws::String& GetRequestId() const{ return m_requestId; } inline void SetRequestId(const Aws::String& value) { m_requestId = value; } inline void SetRequestId(Aws::String&& value) { m_requestId = std::move(value); } inline void SetRequestId(const char* value) { m_requestId.assign(value); } inline ScanResult& WithRequestId(const Aws::String& value) { SetRequestId(value); return *this;} inline ScanResult& WithRequestId(Aws::String&& value) { SetRequestId(std::move(value)); return *this;} inline ScanResult& WithRequestId(const char* value) { SetRequestId(value); return *this;} private: Aws::Vector> m_items; int m_count; int m_scannedCount; Aws::Map m_lastEvaluatedKey; ConsumedCapacity m_consumedCapacity; Aws::String m_requestId; }; } // namespace Model } // namespace DynamoDB } // namespace Aws