com.amazonaws.services.qldbsession

Class AmazonQLDBSessionAsyncClient

java.lang.Object

com.amazonaws.AmazonWebServiceClient

com.amazonaws.services.qldbsession.AmazonQLDBSessionClient

com.amazonaws.services.qldbsession.AmazonQLDBSessionAsyncClient

All Implemented Interfaces:

AmazonQLDBSession, AmazonQLDBSessionAsync

@ThreadSafe
 @Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class AmazonQLDBSessionAsyncClient
extends AmazonQLDBSessionClient
implements AmazonQLDBSessionAsync

Client for accessing QLDB Session asynchronously. Each asynchronous method will return a Java Future object representing the asynchronous operation; overloads which accept an AsyncHandler can be used to receive notification when an asynchronous operation completes.

The transactional data APIs for Amazon QLDB

Instead of interacting directly with this API, we recommend using the 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 QLDB Session 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.

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceClient

LOGGING_AWS_REQUEST_METRIC

Fields inherited from interface com.amazonaws.services.qldbsession.AmazonQLDBSession

ENDPOINT_PREFIX

Method Summary

Modifier and Type	Method and Description
static AmazonQLDBSessionAsyncClientBuilder	asyncBuilder()
ExecutorService	getExecutorService() Returns the executor service used by this client to execute async requests.
Future<SendCommandResult>	sendCommandAsync(SendCommandRequest request) Sends a command to an Amazon QLDB ledger.
Future<SendCommandResult>	sendCommandAsync(SendCommandRequest request, AsyncHandler<SendCommandRequest,SendCommandResult> asyncHandler) Sends a command to an Amazon QLDB ledger.
void	shutdown() Shuts down the client, releasing all managed resources.

Methods inherited from class com.amazonaws.services.qldbsession.AmazonQLDBSessionClient

builder, getCachedResponseMetadata, sendCommand

Methods inherited from class com.amazonaws.AmazonWebServiceClient

addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffset

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.amazonaws.services.qldbsession.AmazonQLDBSession

getCachedResponseMetadata, sendCommand

Method Detail

asyncBuilder

public static AmazonQLDBSessionAsyncClientBuilder asyncBuilder()

getExecutorService

public ExecutorService getExecutorService()

Returns the executor service used by this client to execute async requests.

Returns:

The executor service used by this client to execute async requests.

sendCommandAsync

public Future<SendCommandResult> sendCommandAsync(SendCommandRequest request)

Description copied from interface: AmazonQLDBSessionAsync

Sends a command to an Amazon QLDB ledger.

Instead of interacting directly with this API, we recommend using the 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 QLDB Session 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.

Specified by:

sendCommandAsync in interface AmazonQLDBSessionAsync

Returns:

A Java Future containing the result of the SendCommand operation returned by the service.

See Also:

AWS API Documentation

sendCommandAsync

public Future<SendCommandResult> sendCommandAsync(SendCommandRequest request,
                                                  AsyncHandler<SendCommandRequest,SendCommandResult> asyncHandler)

Description copied from interface: AmazonQLDBSessionAsync

Sends a command to an Amazon QLDB ledger.

Instead of interacting directly with this API, we recommend using the 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 QLDB Session 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.

Specified by:

sendCommandAsync in interface AmazonQLDBSessionAsync

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the SendCommand operation returned by the service.

See Also:

AWS API Documentation

shutdown

public void shutdown()

Shuts down the client, releasing all managed resources. This includes forcibly terminating all pending asynchronous service calls. Clients who wish to give pending asynchronous service calls time to complete should call getExecutorService().shutdown() followed by getExecutorService().awaitTermination() prior to calling this method.

Specified by:

shutdown in interface AmazonQLDBSession

Overrides:

shutdown in class AmazonQLDBSessionClient