/* * Copyright 2018-2023 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.s3outposts; import javax.annotation.Generated; import com.amazonaws.services.s3outposts.model.*; import com.amazonaws.client.AwsAsyncClientParams; import com.amazonaws.annotation.ThreadSafe; import java.util.concurrent.ExecutorService; /** * Client for accessing Amazon S3 Outposts 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 S3 on Outposts provides access to S3 on Outposts operations. *

*/ @ThreadSafe @Generated("com.amazonaws:aws-java-sdk-code-generator") public class AmazonS3OutpostsAsyncClient extends AmazonS3OutpostsClient implements AmazonS3OutpostsAsync { private static final int DEFAULT_THREAD_POOL_SIZE = 50; private final java.util.concurrent.ExecutorService executorService; public static AmazonS3OutpostsAsyncClientBuilder asyncBuilder() { return AmazonS3OutpostsAsyncClientBuilder.standard(); } /** * Constructs a new asynchronous client to invoke service methods on Amazon S3 Outposts using the specified * parameters. * * @param asyncClientParams * Object providing client parameters. */ AmazonS3OutpostsAsyncClient(AwsAsyncClientParams asyncClientParams) { this(asyncClientParams, false); } /** * Constructs a new asynchronous client to invoke service methods on Amazon S3 Outposts using the specified * parameters. * * @param asyncClientParams * Object providing client parameters. * @param endpointDiscoveryEnabled * true will enable endpoint discovery if the service supports it. */ AmazonS3OutpostsAsyncClient(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 createEndpointAsync(CreateEndpointRequest request) { return createEndpointAsync(request, null); } @Override public java.util.concurrent.Future createEndpointAsync(final CreateEndpointRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final CreateEndpointRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public CreateEndpointResult call() throws Exception { CreateEndpointResult result = null; try { result = executeCreateEndpoint(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 deleteEndpointAsync(DeleteEndpointRequest request) { return deleteEndpointAsync(request, null); } @Override public java.util.concurrent.Future deleteEndpointAsync(final DeleteEndpointRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final DeleteEndpointRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public DeleteEndpointResult call() throws Exception { DeleteEndpointResult result = null; try { result = executeDeleteEndpoint(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 listEndpointsAsync(ListEndpointsRequest request) { return listEndpointsAsync(request, null); } @Override public java.util.concurrent.Future listEndpointsAsync(final ListEndpointsRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final ListEndpointsRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public ListEndpointsResult call() throws Exception { ListEndpointsResult result = null; try { result = executeListEndpoints(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 listOutpostsWithS3Async(ListOutpostsWithS3Request request) { return listOutpostsWithS3Async(request, null); } @Override public java.util.concurrent.Future listOutpostsWithS3Async(final ListOutpostsWithS3Request request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final ListOutpostsWithS3Request finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public ListOutpostsWithS3Result call() throws Exception { ListOutpostsWithS3Result result = null; try { result = executeListOutpostsWithS3(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 listSharedEndpointsAsync(ListSharedEndpointsRequest request) { return listSharedEndpointsAsync(request, null); } @Override public java.util.concurrent.Future listSharedEndpointsAsync(final ListSharedEndpointsRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final ListSharedEndpointsRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public ListSharedEndpointsResult call() throws Exception { ListSharedEndpointsResult result = null; try { result = executeListSharedEndpoints(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(); } }