/** * 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 #include #include #include #include #include namespace Aws { namespace Http { class HttpClient; class HttpClientFactory; } // namespace Http namespace Utils { template< typename R, typename E> class Outcome; namespace Threading { class Executor; } // namespace Threading } // namespace Utils namespace Auth { class AWSCredentials; class AWSCredentialsProvider; } // namespace Auth namespace Client { class RetryStrategy; } // namespace Client namespace QLDBSession { namespace Model { class SendCommandRequest; typedef Aws::Utils::Outcome SendCommandOutcome; typedef std::future SendCommandOutcomeCallable; } // namespace Model class QLDBSessionClient; typedef std::function&) > SendCommandResponseReceivedHandler; /** *

The transactional data APIs for Amazon QLDB

Instead of * interacting directly with this API, we recommend that you use the Amazon QLDB * Driver or the QLDB Shell to execute data transactions on a ledger.

  • *

    If you are working with an AWS SDK, use the QLDB Driver. The driver provides * a high-level abstraction layer above this qldbsession data plane * and manages SendCommand API calls for you. For information and a * list of supported programming languages, see Getting * started with the driver in the Amazon QLDB Developer Guide.

  • *
  • If you are working with the AWS Command Line Interface (AWS CLI), use * the QLDB Shell. The shell is a command line interface that uses the QLDB Driver * to interact with a ledger. For information, see Accessing * Amazon QLDB using the QLDB Shell.

*/ class AWS_QLDBSESSION_API QLDBSessionClient : public Aws::Client::AWSJsonClient { public: typedef Aws::Client::AWSJsonClient BASECLASS; /** * Initializes client to use DefaultCredentialProviderChain, with default http client factory, and optional client config. If client config * is not specified, it will be initialized to default values. */ QLDBSessionClient(const Aws::Client::ClientConfiguration& clientConfiguration = Aws::Client::ClientConfiguration()); /** * Initializes client to use SimpleAWSCredentialsProvider, with default http client factory, and optional client config. If client config * is not specified, it will be initialized to default values. */ QLDBSessionClient(const Aws::Auth::AWSCredentials& credentials, const Aws::Client::ClientConfiguration& clientConfiguration = Aws::Client::ClientConfiguration()); /** * Initializes client to use specified credentials provider with specified client config. If http client factory is not supplied, * the default http client factory will be used */ QLDBSessionClient(const std::shared_ptr& credentialsProvider, const Aws::Client::ClientConfiguration& clientConfiguration = Aws::Client::ClientConfiguration()); virtual ~QLDBSessionClient(); /** *

Sends a command to an Amazon QLDB ledger.

Instead of * interacting directly with this API, we recommend that you use the Amazon QLDB * Driver or the QLDB Shell to execute data transactions on a ledger.

  • *

    If you are working with an AWS SDK, use the QLDB Driver. The driver provides * a high-level abstraction layer above this qldbsession data plane * and manages SendCommand API calls for you. For information and a * list of supported programming languages, see Getting * started with the driver in the Amazon QLDB Developer Guide.

  • *
  • If you are working with the AWS Command Line Interface (AWS CLI), use * the QLDB Shell. The shell is a command line interface that uses the QLDB Driver * to interact with a ledger. For information, see Accessing * Amazon QLDB using the QLDB Shell.

See * Also:

AWS * API Reference

*/ virtual Model::SendCommandOutcome SendCommand(const Model::SendCommandRequest& request) const; /** *

Sends a command to an Amazon QLDB ledger.

Instead of * interacting directly with this API, we recommend that you use the Amazon QLDB * Driver or the QLDB Shell to execute data transactions on a ledger.

  • *

    If you are working with an AWS SDK, use the QLDB Driver. The driver provides * a high-level abstraction layer above this qldbsession data plane * and manages SendCommand API calls for you. For information and a * list of supported programming languages, see Getting * started with the driver in the Amazon QLDB Developer Guide.

  • *
  • If you are working with the AWS Command Line Interface (AWS CLI), use * the QLDB Shell. The shell is a command line interface that uses the QLDB Driver * to interact with a ledger. For information, see Accessing * Amazon QLDB using the QLDB Shell.

See * Also:

AWS * API Reference

* * returns a future to the operation so that it can be executed in parallel to other requests. */ virtual Model::SendCommandOutcomeCallable SendCommandCallable(const Model::SendCommandRequest& request) const; /** *

Sends a command to an Amazon QLDB ledger.

Instead of * interacting directly with this API, we recommend that you use the Amazon QLDB * Driver or the QLDB Shell to execute data transactions on a ledger.

  • *

    If you are working with an AWS SDK, use the QLDB Driver. The driver provides * a high-level abstraction layer above this qldbsession data plane * and manages SendCommand API calls for you. For information and a * list of supported programming languages, see Getting * started with the driver in the Amazon QLDB Developer Guide.

  • *
  • If you are working with the AWS Command Line Interface (AWS CLI), use * the QLDB Shell. The shell is a command line interface that uses the QLDB Driver * to interact with a ledger. For information, see Accessing * Amazon QLDB using the QLDB Shell.

See * Also:

AWS * API Reference

* * Queues the request into a thread executor and triggers associated callback when operation has finished. */ virtual void SendCommandAsync(const Model::SendCommandRequest& request, const SendCommandResponseReceivedHandler& handler, const std::shared_ptr& context = nullptr) const; void OverrideEndpoint(const Aws::String& endpoint); private: void init(const Aws::Client::ClientConfiguration& clientConfiguration); void SendCommandAsyncHelper(const Model::SendCommandRequest& request, const SendCommandResponseReceivedHandler& handler, const std::shared_ptr& context) const; Aws::String m_uri; Aws::String m_configScheme; std::shared_ptr m_executor; }; } // namespace QLDBSession } // namespace Aws