com.amazonaws.services.pi.AWSPIAsyncClient Maven / Gradle / Ivy
Show all versions of aws-java-sdk-pi Show documentation
/*
* Copyright 2019-2024 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.
*/
package com.amazonaws.services.pi;
import javax.annotation.Generated;
import com.amazonaws.services.pi.model.*;
import com.amazonaws.client.AwsAsyncClientParams;
import com.amazonaws.annotation.ThreadSafe;
import java.util.concurrent.ExecutorService;
/**
* Client for accessing AWS PI asynchronously. Each asynchronous method will return a Java Future object representing
* the asynchronous operation; overloads which accept an {@code AsyncHandler} can be used to receive notification when
* an asynchronous operation completes.
*
* Amazon RDS Performance Insights
*
* Amazon RDS Performance Insights enables you to monitor and explore different dimensions of database load based on
* data captured from a running DB instance. The guide provides detailed information about Performance Insights data
* types, parameters and errors.
*
*
* When Performance Insights is enabled, the Amazon RDS Performance Insights API provides visibility into the
* performance of your DB instance. Amazon CloudWatch provides the authoritative source for Amazon Web Services
* service-vended monitoring metrics. Performance Insights offers a domain-specific view of DB load.
*
*
* DB load is measured as average active sessions. Performance Insights provides the data to API consumers as a
* two-dimensional time-series dataset. The time dimension provides DB load data for each time point in the queried time
* range. Each time point decomposes overall load in relation to the requested dimensions, measured at that time point.
* Examples include SQL, Wait event, User, and Host.
*
*
* -
*
* To learn more about Performance Insights and Amazon Aurora DB instances, go to the Amazon Aurora User
* Guide .
*
*
* -
*
* To learn more about Performance Insights and Amazon RDS DB instances, go to the Amazon RDS User Guide .
*
*
* -
*
* To learn more about Performance Insights and Amazon DocumentDB clusters, go to the Amazon DocumentDB
* Developer Guide .
*
*
*
*/
@ThreadSafe
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public class AWSPIAsyncClient extends AWSPIClient implements AWSPIAsync {
private static final int DEFAULT_THREAD_POOL_SIZE = 50;
private final java.util.concurrent.ExecutorService executorService;
public static AWSPIAsyncClientBuilder asyncBuilder() {
return AWSPIAsyncClientBuilder.standard();
}
/**
* Constructs a new asynchronous client to invoke service methods on AWS PI using the specified parameters.
*
* @param asyncClientParams
* Object providing client parameters.
*/
AWSPIAsyncClient(AwsAsyncClientParams asyncClientParams) {
this(asyncClientParams, false);
}
/**
* Constructs a new asynchronous client to invoke service methods on AWS PI using the specified parameters.
*
* @param asyncClientParams
* Object providing client parameters.
* @param endpointDiscoveryEnabled
* true will enable endpoint discovery if the service supports it.
*/
AWSPIAsyncClient(AwsAsyncClientParams asyncClientParams, boolean endpointDiscoveryEnabled) {
super(asyncClientParams, endpointDiscoveryEnabled);
this.executorService = asyncClientParams.getExecutor();
}
/**
* Returns the executor service used by this client to execute async requests.
*
* @return The executor service used by this client to execute async requests.
*/
public ExecutorService getExecutorService() {
return executorService;
}
@Override
public java.util.concurrent.Future createPerformanceAnalysisReportAsync(
CreatePerformanceAnalysisReportRequest request) {
return createPerformanceAnalysisReportAsync(request, null);
}
@Override
public java.util.concurrent.Future createPerformanceAnalysisReportAsync(
final CreatePerformanceAnalysisReportRequest request,
final com.amazonaws.handlers.AsyncHandler asyncHandler) {
final CreatePerformanceAnalysisReportRequest finalRequest = beforeClientExecution(request);
return executorService.submit(new java.util.concurrent.Callable() {
@Override
public CreatePerformanceAnalysisReportResult call() throws Exception {
CreatePerformanceAnalysisReportResult result = null;
try {
result = executeCreatePerformanceAnalysisReport(finalRequest);
} catch (Exception ex) {
if (asyncHandler != null) {
asyncHandler.onError(ex);
}
throw ex;
}
if (asyncHandler != null) {
asyncHandler.onSuccess(finalRequest, result);
}
return result;
}
});
}
@Override
public java.util.concurrent.Future deletePerformanceAnalysisReportAsync(
DeletePerformanceAnalysisReportRequest request) {
return deletePerformanceAnalysisReportAsync(request, null);
}
@Override
public java.util.concurrent.Future deletePerformanceAnalysisReportAsync(
final DeletePerformanceAnalysisReportRequest request,
final com.amazonaws.handlers.AsyncHandler asyncHandler) {
final DeletePerformanceAnalysisReportRequest finalRequest = beforeClientExecution(request);
return executorService.submit(new java.util.concurrent.Callable() {
@Override
public DeletePerformanceAnalysisReportResult call() throws Exception {
DeletePerformanceAnalysisReportResult result = null;
try {
result = executeDeletePerformanceAnalysisReport(finalRequest);
} catch (Exception ex) {
if (asyncHandler != null) {
asyncHandler.onError(ex);
}
throw ex;
}
if (asyncHandler != null) {
asyncHandler.onSuccess(finalRequest, result);
}
return result;
}
});
}
@Override
public java.util.concurrent.Future describeDimensionKeysAsync(DescribeDimensionKeysRequest request) {
return describeDimensionKeysAsync(request, null);
}
@Override
public java.util.concurrent.Future describeDimensionKeysAsync(final DescribeDimensionKeysRequest request,
final com.amazonaws.handlers.AsyncHandler asyncHandler) {
final DescribeDimensionKeysRequest finalRequest = beforeClientExecution(request);
return executorService.submit(new java.util.concurrent.Callable() {
@Override
public DescribeDimensionKeysResult call() throws Exception {
DescribeDimensionKeysResult result = null;
try {
result = executeDescribeDimensionKeys(finalRequest);
} catch (Exception ex) {
if (asyncHandler != null) {
asyncHandler.onError(ex);
}
throw ex;
}
if (asyncHandler != null) {
asyncHandler.onSuccess(finalRequest, result);
}
return result;
}
});
}
@Override
public java.util.concurrent.Future getDimensionKeyDetailsAsync(GetDimensionKeyDetailsRequest request) {
return getDimensionKeyDetailsAsync(request, null);
}
@Override
public java.util.concurrent.Future getDimensionKeyDetailsAsync(final GetDimensionKeyDetailsRequest request,
final com.amazonaws.handlers.AsyncHandler asyncHandler) {
final GetDimensionKeyDetailsRequest finalRequest = beforeClientExecution(request);
return executorService.submit(new java.util.concurrent.Callable() {
@Override
public GetDimensionKeyDetailsResult call() throws Exception {
GetDimensionKeyDetailsResult result = null;
try {
result = executeGetDimensionKeyDetails(finalRequest);
} catch (Exception ex) {
if (asyncHandler != null) {
asyncHandler.onError(ex);
}
throw ex;
}
if (asyncHandler != null) {
asyncHandler.onSuccess(finalRequest, result);
}
return result;
}
});
}
@Override
public java.util.concurrent.Future getPerformanceAnalysisReportAsync(GetPerformanceAnalysisReportRequest request) {
return getPerformanceAnalysisReportAsync(request, null);
}
@Override
public java.util.concurrent.Future getPerformanceAnalysisReportAsync(final GetPerformanceAnalysisReportRequest request,
final com.amazonaws.handlers.AsyncHandler asyncHandler) {
final GetPerformanceAnalysisReportRequest finalRequest = beforeClientExecution(request);
return executorService.submit(new java.util.concurrent.Callable() {
@Override
public GetPerformanceAnalysisReportResult call() throws Exception {
GetPerformanceAnalysisReportResult result = null;
try {
result = executeGetPerformanceAnalysisReport(finalRequest);
} catch (Exception ex) {
if (asyncHandler != null) {
asyncHandler.onError(ex);
}
throw ex;
}
if (asyncHandler != null) {
asyncHandler.onSuccess(finalRequest, result);
}
return result;
}
});
}
@Override
public java.util.concurrent.Future getResourceMetadataAsync(GetResourceMetadataRequest request) {
return getResourceMetadataAsync(request, null);
}
@Override
public java.util.concurrent.Future getResourceMetadataAsync(final GetResourceMetadataRequest request,
final com.amazonaws.handlers.AsyncHandler asyncHandler) {
final GetResourceMetadataRequest finalRequest = beforeClientExecution(request);
return executorService.submit(new java.util.concurrent.Callable() {
@Override
public GetResourceMetadataResult call() throws Exception {
GetResourceMetadataResult result = null;
try {
result = executeGetResourceMetadata(finalRequest);
} catch (Exception ex) {
if (asyncHandler != null) {
asyncHandler.onError(ex);
}
throw ex;
}
if (asyncHandler != null) {
asyncHandler.onSuccess(finalRequest, result);
}
return result;
}
});
}
@Override
public java.util.concurrent.Future getResourceMetricsAsync(GetResourceMetricsRequest request) {
return getResourceMetricsAsync(request, null);
}
@Override
public java.util.concurrent.Future getResourceMetricsAsync(final GetResourceMetricsRequest request,
final com.amazonaws.handlers.AsyncHandler asyncHandler) {
final GetResourceMetricsRequest finalRequest = beforeClientExecution(request);
return executorService.submit(new java.util.concurrent.Callable() {
@Override
public GetResourceMetricsResult call() throws Exception {
GetResourceMetricsResult result = null;
try {
result = executeGetResourceMetrics(finalRequest);
} catch (Exception ex) {
if (asyncHandler != null) {
asyncHandler.onError(ex);
}
throw ex;
}
if (asyncHandler != null) {
asyncHandler.onSuccess(finalRequest, result);
}
return result;
}
});
}
@Override
public java.util.concurrent.Future listAvailableResourceDimensionsAsync(
ListAvailableResourceDimensionsRequest request) {
return listAvailableResourceDimensionsAsync(request, null);
}
@Override
public java.util.concurrent.Future listAvailableResourceDimensionsAsync(
final ListAvailableResourceDimensionsRequest request,
final com.amazonaws.handlers.AsyncHandler asyncHandler) {
final ListAvailableResourceDimensionsRequest finalRequest = beforeClientExecution(request);
return executorService.submit(new java.util.concurrent.Callable() {
@Override
public ListAvailableResourceDimensionsResult call() throws Exception {
ListAvailableResourceDimensionsResult result = null;
try {
result = executeListAvailableResourceDimensions(finalRequest);
} catch (Exception ex) {
if (asyncHandler != null) {
asyncHandler.onError(ex);
}
throw ex;
}
if (asyncHandler != null) {
asyncHandler.onSuccess(finalRequest, result);
}
return result;
}
});
}
@Override
public java.util.concurrent.Future listAvailableResourceMetricsAsync(ListAvailableResourceMetricsRequest request) {
return listAvailableResourceMetricsAsync(request, null);
}
@Override
public java.util.concurrent.Future listAvailableResourceMetricsAsync(final ListAvailableResourceMetricsRequest request,
final com.amazonaws.handlers.AsyncHandler asyncHandler) {
final ListAvailableResourceMetricsRequest finalRequest = beforeClientExecution(request);
return executorService.submit(new java.util.concurrent.Callable() {
@Override
public ListAvailableResourceMetricsResult call() throws Exception {
ListAvailableResourceMetricsResult result = null;
try {
result = executeListAvailableResourceMetrics(finalRequest);
} catch (Exception ex) {
if (asyncHandler != null) {
asyncHandler.onError(ex);
}
throw ex;
}
if (asyncHandler != null) {
asyncHandler.onSuccess(finalRequest, result);
}
return result;
}
});
}
@Override
public java.util.concurrent.Future listPerformanceAnalysisReportsAsync(ListPerformanceAnalysisReportsRequest request) {
return listPerformanceAnalysisReportsAsync(request, null);
}
@Override
public java.util.concurrent.Future listPerformanceAnalysisReportsAsync(
final ListPerformanceAnalysisReportsRequest request,
final com.amazonaws.handlers.AsyncHandler asyncHandler) {
final ListPerformanceAnalysisReportsRequest finalRequest = beforeClientExecution(request);
return executorService.submit(new java.util.concurrent.Callable() {
@Override
public ListPerformanceAnalysisReportsResult call() throws Exception {
ListPerformanceAnalysisReportsResult result = null;
try {
result = executeListPerformanceAnalysisReports(finalRequest);
} catch (Exception ex) {
if (asyncHandler != null) {
asyncHandler.onError(ex);
}
throw ex;
}
if (asyncHandler != null) {
asyncHandler.onSuccess(finalRequest, result);
}
return result;
}
});
}
@Override
public java.util.concurrent.Future listTagsForResourceAsync(ListTagsForResourceRequest request) {
return listTagsForResourceAsync(request, null);
}
@Override
public java.util.concurrent.Future listTagsForResourceAsync(final ListTagsForResourceRequest request,
final com.amazonaws.handlers.AsyncHandler asyncHandler) {
final ListTagsForResourceRequest finalRequest = beforeClientExecution(request);
return executorService.submit(new java.util.concurrent.Callable() {
@Override
public ListTagsForResourceResult call() throws Exception {
ListTagsForResourceResult result = null;
try {
result = executeListTagsForResource(finalRequest);
} catch (Exception ex) {
if (asyncHandler != null) {
asyncHandler.onError(ex);
}
throw ex;
}
if (asyncHandler != null) {
asyncHandler.onSuccess(finalRequest, result);
}
return result;
}
});
}
@Override
public java.util.concurrent.Future tagResourceAsync(TagResourceRequest request) {
return tagResourceAsync(request, null);
}
@Override
public java.util.concurrent.Future tagResourceAsync(final TagResourceRequest request,
final com.amazonaws.handlers.AsyncHandler asyncHandler) {
final TagResourceRequest finalRequest = beforeClientExecution(request);
return executorService.submit(new java.util.concurrent.Callable() {
@Override
public TagResourceResult call() throws Exception {
TagResourceResult result = null;
try {
result = executeTagResource(finalRequest);
} catch (Exception ex) {
if (asyncHandler != null) {
asyncHandler.onError(ex);
}
throw ex;
}
if (asyncHandler != null) {
asyncHandler.onSuccess(finalRequest, result);
}
return result;
}
});
}
@Override
public java.util.concurrent.Future untagResourceAsync(UntagResourceRequest request) {
return untagResourceAsync(request, null);
}
@Override
public java.util.concurrent.Future untagResourceAsync(final UntagResourceRequest request,
final com.amazonaws.handlers.AsyncHandler asyncHandler) {
final UntagResourceRequest finalRequest = beforeClientExecution(request);
return executorService.submit(new java.util.concurrent.Callable() {
@Override
public UntagResourceResult call() throws Exception {
UntagResourceResult result = null;
try {
result = executeUntagResource(finalRequest);
} catch (Exception ex) {
if (asyncHandler != null) {
asyncHandler.onError(ex);
}
throw ex;
}
if (asyncHandler != null) {
asyncHandler.onSuccess(finalRequest, result);
}
return result;
}
});
}
/**
* 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 {@code getExecutorService().shutdown()} followed by {@code getExecutorService().awaitTermination()} prior to
* calling this method.
*/
@Override
public void shutdown() {
super.shutdown();
executorService.shutdownNow();
}
}