2021-12-02 15:10:47 -05:00
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0
2022-12-20 11:23:09 -05:00
/**
* Before running this C++ code example, set up your development environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/getting-started.html
*
* For information on the structure of the code examples and how to build and run the examples, see
* https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/getting-started-code-examples.html.
*
**/
2021-12-02 15:10:47 -05:00
// snippet-start:[dynamodb.cpp.put_item.inc]
# include <aws/core/Aws.h>
# include <aws/dynamodb/DynamoDBClient.h>
# include <aws/dynamodb/model/AttributeDefinition.h>
# include <aws/dynamodb/model/PutItemRequest.h>
# include <aws/dynamodb/model/PutItemResult.h>
# include <iostream>
// snippet-end:[dynamodb.cpp.put_item.inc]
2022-12-20 11:23:09 -05:00
# include "dynamodb_samples.h"
// snippet-start:[dynamodb.cpp.put_item.code]
//! Put an item in an Amazon DynamoDB table.
/*!
\sa putItem()
\param tableName: The table name.
\param artistKey: The artist key. This is the partition key for the table.
\param artistValue: The artist value.
\param albumTitleKey: The album title key.
\param albumTitleValue: The album title value.
\param awardsKey: The awards key.
\param awardsValue: The awards value.
\param songTitleKey: The song title key.
\param songTitleValue: The song title value.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc : : DynamoDB : : putItem ( const Aws : : String & tableName ,
const Aws : : String & artistKey ,
const Aws : : String & artistValue ,
const Aws : : String & albumTitleKey ,
const Aws : : String & albumTitleValue ,
const Aws : : String & awardsKey ,
const Aws : : String & awardsValue ,
const Aws : : String & songTitleKey ,
const Aws : : String & songTitleValue ,
const Aws : : Client : : ClientConfiguration & clientConfiguration ) {
Aws : : DynamoDB : : DynamoDBClient dynamoClient ( clientConfiguration ) ;
Aws : : DynamoDB : : Model : : PutItemRequest putItemRequest ;
putItemRequest . SetTableName ( tableName ) ;
putItemRequest . AddItem ( artistKey , Aws : : DynamoDB : : Model : : AttributeValue ( ) . SetS (
artistValue ) ) ; // This is the hash key.
putItemRequest . AddItem ( albumTitleKey , Aws : : DynamoDB : : Model : : AttributeValue ( ) . SetS (
albumTitleValue ) ) ;
putItemRequest . AddItem ( awardsKey ,
Aws : : DynamoDB : : Model : : AttributeValue ( ) . SetS ( awardsValue ) ) ;
putItemRequest . AddItem ( songTitleKey ,
Aws : : DynamoDB : : Model : : AttributeValue ( ) . SetS ( songTitleValue ) ) ;
const Aws : : DynamoDB : : Model : : PutItemOutcome outcome = dynamoClient . PutItem (
putItemRequest ) ;
if ( outcome . IsSuccess ( ) ) {
std : : cout < < " Successfully added Item! " < < std : : endl ;
}
else {
std : : cerr < < outcome . GetError ( ) . GetMessage ( ) < < std : : endl ;
2024-10-01 15:30:45 -04:00
return false ;
2022-12-20 11:23:09 -05:00
}
2021-12-02 15:10:47 -05:00
2024-10-01 15:30:45 -04:00
return waitTableActive ( tableName , dynamoClient ) ;
2022-12-20 11:23:09 -05:00
}
2021-12-02 15:10:47 -05:00
2022-12-20 11:23:09 -05:00
// snippet-end:[dynamodb.cpp.put_item.code]
2021-12-02 15:10:47 -05:00
2022-12-20 11:23:09 -05:00
/*
*
* main function
*
* Usage: 'run_put_item <table_name> <artist_key> <artist_value> <album_title_key>
* <album_title_value> <awards_key> <awards_value> <song_title_key> <song_title_value>'
*
* Prerequisites: Create a DynamoDB table named <table_name> with <artist_key> for the
* partition key.
*
*/
# ifndef TESTING_BUILD
int main ( int argc , char * * argv ) {
if ( argc < 10 ) {
std : : cout < < R " (
Usage :
< table_name > < artist_key > < artist_value > < album_title_key > < album_title_value > < awards_key >
< awards_value > < song_title_key > < song_title_value >
Where :
table_name - The Amazon DynamoDB table in which an item is placed ( for example , Music3 ) .
artist_key - The key the artist used in the Amazon DynamoDB table . This is the partition key .
artist_value - The value for the artist ( for example , Famous Band ) .
album_title_key - The key for the album title ( for example , AlbumTitle ) .
album_title_value - The value for the album title ( for example , Songs About Life ) .
awards_key - The key for awards ( for example , Awards ) .
awards_value - The value of the awards ( for example , 10 ) .
song_title_key - The key for the song title ( for example , SongTitle ) .
song_title_value - The value of the song title ( for example , Happy Day ) .
Warning This program places the item that you specify into a table .
) " ;
return 1 ;
2021-12-02 15:10:47 -05:00
}
Aws : : SDKOptions options ;
Aws : : InitAPI ( options ) ;
{
2022-12-20 11:23:09 -05:00
const Aws : : String tableName = ( argv [ 1 ] ) ;
const Aws : : String artistKey = ( argv [ 2 ] ) ;
const Aws : : String artistValue = ( argv [ 3 ] ) ;
const Aws : : String albumTitleKey = ( argv [ 4 ] ) ;
const Aws : : String albumTitleValue = ( argv [ 5 ] ) ;
const Aws : : String awardsKey = ( argv [ 6 ] ) ;
const Aws : : String awardsValue = ( argv [ 7 ] ) ;
const Aws : : String songTitleKey = ( argv [ 8 ] ) ;
const Aws : : String songTitleValue = ( argv [ 9 ] ) ;
2021-12-02 15:10:47 -05:00
Aws : : Client : : ClientConfiguration clientConfig ;
2022-12-20 11:23:09 -05:00
// Optional: Set to the AWS Region (overrides config file).
// clientConfig.region = "us-east-1";
2021-12-02 15:10:47 -05:00
2022-12-20 11:23:09 -05:00
AwsDoc : : DynamoDB : : putItem ( tableName , artistKey , artistValue , albumTitleKey ,
albumTitleValue ,
awardsKey , awardsValue , songTitleKey , songTitleValue ,
clientConfig ) ;
2021-12-02 15:10:47 -05:00
}
Aws : : ShutdownAPI ( options ) ;
return 0 ;
2022-12-20 11:23:09 -05:00
}
# endif // TESTING_BUILD
