com.amazonaws.services.workdocs

Class ContentManagerAsync

java.lang.Object

com.amazonaws.services.workdocs.ContentManager

com.amazonaws.services.workdocs.ContentManagerAsync

@ThreadSafe
public class ContentManagerAsync
extends ContentManager

High level asynchronous utility for transferring content from and to Amazon WorkDocs. ContentManagerAsync provides a simple API for uploading and downloading documents to/from Amazon WorkDocs easily. ContentManagerAsync, like all the client classes in the AWS SDK for Java, is thread safe. Call ContentManagerAsync.shutdownNow(true) to release the resources once the operation is complete. If you want to keep Amazon WorkDocs client open, then call ContentManagerAsync.shutdownNow(false).

In order to use ContentManager:

 AWSStaticCredentialsProvider credentialsProvider = new AWSStaticCredentialsProvider(new AnonymousAWSCredentials());
 AmazonWorkDocs client = AmazonWorkDocsClient.builder().withCredentials(credentialsProvider).withRegion(Regions.REGION).build();
 ContentManagerAsync contentManager = ContentManagerAsyncBuilder.standard().withWorkDocsClient(client).withAuthenticationToken(authenticationToken).build();
 GetDocumentStreamRequest request = new GetDocumentStreamRequest();
 request.setDocumentId("doc-id");
 InputStream inputStream = contentManager.getDocumentStreamAsync(request).get().getStream();
 contentManager.shutdownNow(true);
 

Method Summary

Modifier and Type	Method and Description
Future<GetDocumentStreamResult>	getDocumentStreamAsync(GetDocumentStreamRequest getDocumentStreamRequest) Asynchronously gets document stream of latest version of given document and version ID.
void	shutdownNow(boolean shutdownWorkDocsClient) Forcefully shuts down this ContentManager instance - currently executing operations will not be allowed to finish.
Future<UploadDocumentStreamResult>	uploadDocumentStreamAsync(UploadDocumentStreamRequest uploadDocumentStreamRequest) Asynchronously uploads stream to given folder and document name.

Methods inherited from class com.amazonaws.services.workdocs.ContentManager

getDocumentStream, uploadDocumentStream

Methods inherited from class java.lang.Object

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

Method Detail

getDocumentStreamAsync

public Future<GetDocumentStreamResult> getDocumentStreamAsync(GetDocumentStreamRequest getDocumentStreamRequest)

Asynchronously gets document stream of latest version of given document and version ID. If version ID is null, it retrieves latest version of requested document ID. Clients must close the stream once content is read.

Parameters:

getDocumentStreamRequest - Request specifying parameters of the operation.

Returns:

Result containing stream of requested document content.

uploadDocumentStreamAsync

public Future<UploadDocumentStreamResult> uploadDocumentStreamAsync(UploadDocumentStreamRequest uploadDocumentStreamRequest)
                                                             throws IllegalArgumentException

Asynchronously uploads stream to given folder and document name. Client must close the input stream once upload operation is complete.

Parameters:

uploadDocumentStreamRequest - Request specifying parameters of the operation.

Returns:

Result containing metadata of the newly created document or version.

Throws:

IllegalArgumentException

shutdownNow

public void shutdownNow(boolean shutdownWorkDocsClient)

Forcefully shuts down this ContentManager instance - currently executing operations will not be allowed to finish. Callers should use this method when they either:

• have already verified that their operations have completed by checking each transfer's state
• need to exit quickly and don't mind stopping operations before they complete.

Callers should also remember that uploaded parts from an interrupted upload may not always be automatically cleaned up.

Parameters:

shutdownWorkDocsClient - Whether to shut down the underlying Amazon WorkDocs client.