/* * Copyright 2010 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.s3.transfer; import java.util.concurrent.ExecutionException; import com.amazonaws.AmazonClientException; import com.amazonaws.AmazonServiceException; import com.amazonaws.services.s3.transfer.internal.ProgressListenerChain; import com.amazonaws.services.s3.transfer.internal.TransferProgressImpl; import com.amazonaws.services.s3.transfer.model.UploadResult; /** * Represents an asynchronous upload to Amazon S3. * <p> * See {@link TransferManager} for more information about creating transfers. * </p> * * @see TransferManager#upload(String, String, java.io.File) * @see TransferManager#upload(com.amazonaws.services.s3.model.PutObjectRequest) */ public class Upload extends Transfer { protected Upload(String description, TransferProgressImpl transferProgressInternalState, ProgressListenerChain progressListenerChain) { super(description, transferProgressInternalState, progressListenerChain); } /** * Waits for this upload to complete and returns the result of this * upload. Be prepared to handle errors when calling this method. Any * errors that occurred during the asynchronous transfer will be re-thrown * through this method. * * @return The result of this transfer. * * @throws AmazonClientException * If any errors were encountered in the client while making the * request or handling the response. * @throws AmazonServiceException * If any errors occurred in Amazon S3 while processing the * request. * @throws InterruptedException * If this thread is interrupted while waiting for the upload to * complete. */ public UploadResult waitForUploadResult() throws AmazonClientException, AmazonServiceException, InterruptedException { try { return (UploadResult)future.get(); } catch (ExecutionException e) { rethrowExecutionException(e); } return null; } }