com.amazonaws.services.translate

Class AmazonTranslateAsyncClient

java.lang.Object

com.amazonaws.AmazonWebServiceClient

com.amazonaws.services.translate.AmazonTranslateClient

com.amazonaws.services.translate.AmazonTranslateAsyncClient

All Implemented Interfaces:

AmazonTranslate, AmazonTranslateAsync

@ThreadSafe
 @Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class AmazonTranslateAsyncClient
extends AmazonTranslateClient
implements AmazonTranslateAsync

Client for accessing Amazon Translate 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.

Provides translation between one source language and another of the same set of languages.

Field Summary

Fields inherited from class com.amazonaws.services.translate.AmazonTranslateClient

configFactory

Fields inherited from class com.amazonaws.AmazonWebServiceClient

client, clientConfiguration, endpoint, isEndpointOverridden, LOGGING_AWS_REQUEST_METRIC, requestHandler2s, timeOffset

Fields inherited from interface com.amazonaws.services.translate.AmazonTranslate

ENDPOINT_PREFIX

Method Summary

Modifier and Type	Method and Description
static AmazonTranslateAsyncClientBuilder	asyncBuilder()
Future<DeleteTerminologyResult>	deleteTerminologyAsync(DeleteTerminologyRequest request) A synchronous action that deletes a custom terminology.
Future<DeleteTerminologyResult>	deleteTerminologyAsync(DeleteTerminologyRequest request, AsyncHandler<DeleteTerminologyRequest,DeleteTerminologyResult> asyncHandler) A synchronous action that deletes a custom terminology.
ExecutorService	getExecutorService() Returns the executor service used by this client to execute async requests.
Future<GetTerminologyResult>	getTerminologyAsync(GetTerminologyRequest request) Retrieves a custom terminology.
Future<GetTerminologyResult>	getTerminologyAsync(GetTerminologyRequest request, AsyncHandler<GetTerminologyRequest,GetTerminologyResult> asyncHandler) Retrieves a custom terminology.
Future<ImportTerminologyResult>	importTerminologyAsync(ImportTerminologyRequest request) Creates or updates a custom terminology, depending on whether or not one already exists for the given terminology name.
Future<ImportTerminologyResult>	importTerminologyAsync(ImportTerminologyRequest request, AsyncHandler<ImportTerminologyRequest,ImportTerminologyResult> asyncHandler) Creates or updates a custom terminology, depending on whether or not one already exists for the given terminology name.
Future<ListTerminologiesResult>	listTerminologiesAsync(ListTerminologiesRequest request) Provides a list of custom terminologies associated with your account.
Future<ListTerminologiesResult>	listTerminologiesAsync(ListTerminologiesRequest request, AsyncHandler<ListTerminologiesRequest,ListTerminologiesResult> asyncHandler) Provides a list of custom terminologies associated with your account.
void	shutdown() Shuts down the client, releasing all managed resources.
Future<TranslateTextResult>	translateTextAsync(TranslateTextRequest request) Translates input text from the source language to the target language.
Future<TranslateTextResult>	translateTextAsync(TranslateTextRequest request, AsyncHandler<TranslateTextRequest,TranslateTextResult> asyncHandler) Translates input text from the source language to the target language.

Methods inherited from class com.amazonaws.services.translate.AmazonTranslateClient

builder, deleteTerminology, getCachedResponseMetadata, getTerminology, importTerminology, listTerminologies, translateText

Methods inherited from class com.amazonaws.AmazonWebServiceClient

addRequestHandler, addRequestHandler, beforeClientExecution, beforeMarshalling, calculateCRC32FromCompressedData, checkMutability, configureRegion, createExecutionContext, createExecutionContext, createExecutionContext, createSignerProvider, endClientExecution, endClientExecution, getClientConfiguration, getClientId, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceAbbreviation, getServiceName, getServiceNameIntern, getSigner, getSignerByURI, getSignerOverride, getSignerProvider, getSignerRegionOverride, getSigningRegion, getTimeOffset, isCsmEnabled, isEndpointOverridden, isProfilingEnabled, isRequestMetricsEnabled, makeImmutable, removeRequestHandler, removeRequestHandler, requestMetricCollector, setEndpoint, setEndpoint, setEndpointPrefix, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, shouldGenerateClientSideMonitoringEvents, useStrictHostNameVerification, withEndpoint, withRegion, withRegion, withTimeOffset

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.amazonaws.services.translate.AmazonTranslate

deleteTerminology, getCachedResponseMetadata, getTerminology, importTerminology, listTerminologies, translateText

Method Detail

asyncBuilder

public static AmazonTranslateAsyncClientBuilder 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.

deleteTerminologyAsync

public Future<DeleteTerminologyResult> deleteTerminologyAsync(DeleteTerminologyRequest request)

Description copied from interface: AmazonTranslateAsync

A synchronous action that deletes a custom terminology.

Specified by:

deleteTerminologyAsync in interface AmazonTranslateAsync

Returns:

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

See Also:

AWS API Documentation

deleteTerminologyAsync

public Future<DeleteTerminologyResult> deleteTerminologyAsync(DeleteTerminologyRequest request,
                                                              AsyncHandler<DeleteTerminologyRequest,DeleteTerminologyResult> asyncHandler)

Description copied from interface: AmazonTranslateAsync

A synchronous action that deletes a custom terminology.

Specified by:

deleteTerminologyAsync in interface AmazonTranslateAsync

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 DeleteTerminology operation returned by the service.

See Also:

AWS API Documentation

getTerminologyAsync

public Future<GetTerminologyResult> getTerminologyAsync(GetTerminologyRequest request)

Description copied from interface: AmazonTranslateAsync

Retrieves a custom terminology.

Specified by:

getTerminologyAsync in interface AmazonTranslateAsync

Returns:

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

See Also:

AWS API Documentation

getTerminologyAsync

public Future<GetTerminologyResult> getTerminologyAsync(GetTerminologyRequest request,
                                                        AsyncHandler<GetTerminologyRequest,GetTerminologyResult> asyncHandler)

Description copied from interface: AmazonTranslateAsync

Retrieves a custom terminology.

Specified by:

getTerminologyAsync in interface AmazonTranslateAsync

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 GetTerminology operation returned by the service.

See Also:

AWS API Documentation

importTerminologyAsync

public Future<ImportTerminologyResult> importTerminologyAsync(ImportTerminologyRequest request)

Description copied from interface: AmazonTranslateAsync

Creates or updates a custom terminology, depending on whether or not one already exists for the given terminology name. Importing a terminology with the same name as an existing one will merge the terminologies based on the chosen merge strategy. Currently, the only supported merge strategy is OVERWRITE, and so the imported terminology will overwrite an existing terminology of the same name.

If you import a terminology that overwrites an existing one, the new terminology take up to 10 minutes to fully propagate and be available for use in a translation due to cache policies with the DataPlane service that performs the translations.

Specified by:

importTerminologyAsync in interface AmazonTranslateAsync

Returns:

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

See Also:

AWS API Documentation

importTerminologyAsync

public Future<ImportTerminologyResult> importTerminologyAsync(ImportTerminologyRequest request,
                                                              AsyncHandler<ImportTerminologyRequest,ImportTerminologyResult> asyncHandler)

Description copied from interface: AmazonTranslateAsync

Creates or updates a custom terminology, depending on whether or not one already exists for the given terminology name. Importing a terminology with the same name as an existing one will merge the terminologies based on the chosen merge strategy. Currently, the only supported merge strategy is OVERWRITE, and so the imported terminology will overwrite an existing terminology of the same name.

If you import a terminology that overwrites an existing one, the new terminology take up to 10 minutes to fully propagate and be available for use in a translation due to cache policies with the DataPlane service that performs the translations.

Specified by:

importTerminologyAsync in interface AmazonTranslateAsync

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 ImportTerminology operation returned by the service.

See Also:

AWS API Documentation

listTerminologiesAsync

public Future<ListTerminologiesResult> listTerminologiesAsync(ListTerminologiesRequest request)

Description copied from interface: AmazonTranslateAsync

Provides a list of custom terminologies associated with your account.

Specified by:

listTerminologiesAsync in interface AmazonTranslateAsync

Returns:

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

See Also:

AWS API Documentation

listTerminologiesAsync

public Future<ListTerminologiesResult> listTerminologiesAsync(ListTerminologiesRequest request,
                                                              AsyncHandler<ListTerminologiesRequest,ListTerminologiesResult> asyncHandler)

Description copied from interface: AmazonTranslateAsync

Provides a list of custom terminologies associated with your account.

Specified by:

listTerminologiesAsync in interface AmazonTranslateAsync

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 ListTerminologies operation returned by the service.

See Also:

AWS API Documentation

translateTextAsync

public Future<TranslateTextResult> translateTextAsync(TranslateTextRequest request)

Description copied from interface: AmazonTranslateAsync

Translates input text from the source language to the target language. It is not necessary to use English (en) as either the source or the target language but not all language combinations are supported by Amazon Translate. For more information, see Supported Language Pairs.

• Arabic (ar)

• Chinese (Simplified) (zh)

• Chinese (Traditional) (zh-TW)

• Czech (cs)

• Danish (da)

• Dutch (nl)

• English (en)

• Finnish (fi)

• French (fr)

• German (de)

• Hebrew (he)

• Indonesian (id)

• Italian (it)

• Japanese (ja)

• Korean (ko)

• Polish (pl)

• Portuguese (pt)

• Russian (ru)

• Spanish (es)

• Swedish (sv)

• Turkish (tr)

To have Amazon Translate determine the source language of your text, you can specify auto in the SourceLanguageCode field. If you specify auto, Amazon Translate will call Amazon Comprehend to determine the source language.

Specified by:

translateTextAsync in interface AmazonTranslateAsync

Returns:

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

See Also:

AWS API Documentation

translateTextAsync

public Future<TranslateTextResult> translateTextAsync(TranslateTextRequest request,
                                                      AsyncHandler<TranslateTextRequest,TranslateTextResult> asyncHandler)

Description copied from interface: AmazonTranslateAsync

Translates input text from the source language to the target language. It is not necessary to use English (en) as either the source or the target language but not all language combinations are supported by Amazon Translate. For more information, see Supported Language Pairs.

• Arabic (ar)

• Chinese (Simplified) (zh)

• Chinese (Traditional) (zh-TW)

• Czech (cs)

• Danish (da)

• Dutch (nl)

• English (en)

• Finnish (fi)

• French (fr)

• German (de)

• Hebrew (he)

• Indonesian (id)

• Italian (it)

• Japanese (ja)

• Korean (ko)

• Polish (pl)

• Portuguese (pt)

• Russian (ru)

• Spanish (es)

• Swedish (sv)

• Turkish (tr)

To have Amazon Translate determine the source language of your text, you can specify auto in the SourceLanguageCode field. If you specify auto, Amazon Translate will call Amazon Comprehend to determine the source language.

Specified by:

translateTextAsync in interface AmazonTranslateAsync

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 TranslateText 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 AmazonTranslate

Overrides:

shutdown in class AmazonWebServiceClient