com.amazonaws.services.translate

Interface AmazonTranslateAsync

All Superinterfaces:

AmazonTranslate

All Known Implementing Classes:

AmazonTranslateAsyncClient

public interface AmazonTranslateAsync
extends AmazonTranslate

Interface for accessing Amazon Translate asynchronously.

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

Method Summary

Modifier and Type	Method and Description
Future<Void>	deleteTerminologyAsync(DeleteTerminologyRequest deleteTerminologyRequest) A synchronous action that deletes a custom terminology.
Future<Void>	deleteTerminologyAsync(DeleteTerminologyRequest deleteTerminologyRequest, AsyncHandler<DeleteTerminologyRequest,Void> asyncHandler) A synchronous action that deletes a custom terminology.
Future<GetTerminologyResult>	getTerminologyAsync(GetTerminologyRequest getTerminologyRequest) Retrieves a custom terminology.
Future<GetTerminologyResult>	getTerminologyAsync(GetTerminologyRequest getTerminologyRequest, AsyncHandler<GetTerminologyRequest,GetTerminologyResult> asyncHandler) Retrieves a custom terminology.
Future<ImportTerminologyResult>	importTerminologyAsync(ImportTerminologyRequest importTerminologyRequest) Creates or updates a custom terminology, depending on whether or not one already exists for the given terminology name.
Future<ImportTerminologyResult>	importTerminologyAsync(ImportTerminologyRequest importTerminologyRequest, 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 listTerminologiesRequest) Provides a list of custom terminologies associated with your account.
Future<ListTerminologiesResult>	listTerminologiesAsync(ListTerminologiesRequest listTerminologiesRequest, AsyncHandler<ListTerminologiesRequest,ListTerminologiesResult> asyncHandler) Provides a list of custom terminologies associated with your account.
Future<TranslateTextResult>	translateTextAsync(TranslateTextRequest translateTextRequest) Translates input text from the source language to the target language.
Future<TranslateTextResult>	translateTextAsync(TranslateTextRequest translateTextRequest, AsyncHandler<TranslateTextRequest,TranslateTextResult> asyncHandler) Translates input text from the source language to the target language.

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

deleteTerminology, getCachedResponseMetadata, getTerminology, importTerminology, listTerminologies, setEndpoint, setRegion, shutdown, translateText

Method Detail

deleteTerminologyAsync

Future<Void> deleteTerminologyAsync(DeleteTerminologyRequest deleteTerminologyRequest)
                             throws AmazonServiceException,
                                    AmazonClientException

A synchronous action that deletes a custom terminology.

Parameters:

deleteTerminologyRequest -

Returns:

A Java Future object containing the response from the DeleteTerminology service method, as returned by Amazon Translate.

Throws:

ResourceNotFoundException

TooManyRequestsException

InternalServerException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Translate indicating either a problem with the data in the request, or a server side issue.

deleteTerminologyAsync

Future<Void> deleteTerminologyAsync(DeleteTerminologyRequest deleteTerminologyRequest,
                                    AsyncHandler<DeleteTerminologyRequest,Void> asyncHandler)
                             throws AmazonServiceException,
                                    AmazonClientException

A synchronous action that deletes a custom terminology.

Parameters:

deleteTerminologyRequest -

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the DeleteTerminology service method, as returned by Amazon Translate.

Throws:

ResourceNotFoundException

TooManyRequestsException

InternalServerException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Translate indicating either a problem with the data in the request, or a server side issue.

getTerminologyAsync

Future<GetTerminologyResult> getTerminologyAsync(GetTerminologyRequest getTerminologyRequest)
                                          throws AmazonServiceException,
                                                 AmazonClientException

Retrieves a custom terminology.

Parameters:

getTerminologyRequest -

Returns:

A Java Future object containing the response from the GetTerminology service method, as returned by Amazon Translate.

Throws:

ResourceNotFoundException

InvalidParameterValueException

TooManyRequestsException

InternalServerException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Translate indicating either a problem with the data in the request, or a server side issue.

getTerminologyAsync

Future<GetTerminologyResult> getTerminologyAsync(GetTerminologyRequest getTerminologyRequest,
                                                 AsyncHandler<GetTerminologyRequest,GetTerminologyResult> asyncHandler)
                                          throws AmazonServiceException,
                                                 AmazonClientException

Retrieves a custom terminology.

Parameters:

getTerminologyRequest -

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the GetTerminology service method, as returned by Amazon Translate.

Throws:

ResourceNotFoundException

InvalidParameterValueException

TooManyRequestsException

InternalServerException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Translate indicating either a problem with the data in the request, or a server side issue.

importTerminologyAsync

Future<ImportTerminologyResult> importTerminologyAsync(ImportTerminologyRequest importTerminologyRequest)
                                                throws AmazonServiceException,
                                                       AmazonClientException

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.

Parameters:

importTerminologyRequest -

Returns:

A Java Future object containing the response from the ImportTerminology service method, as returned by Amazon Translate.

Throws:

InvalidParameterValueException

LimitExceededException

TooManyRequestsException

InternalServerException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Translate indicating either a problem with the data in the request, or a server side issue.

importTerminologyAsync

Future<ImportTerminologyResult> importTerminologyAsync(ImportTerminologyRequest importTerminologyRequest,
                                                       AsyncHandler<ImportTerminologyRequest,ImportTerminologyResult> asyncHandler)
                                                throws AmazonServiceException,
                                                       AmazonClientException

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.

Parameters:

importTerminologyRequest -

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the ImportTerminology service method, as returned by Amazon Translate.

Throws:

InvalidParameterValueException

LimitExceededException

TooManyRequestsException

InternalServerException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Translate indicating either a problem with the data in the request, or a server side issue.

listTerminologiesAsync

Future<ListTerminologiesResult> listTerminologiesAsync(ListTerminologiesRequest listTerminologiesRequest)
                                                throws AmazonServiceException,
                                                       AmazonClientException

Provides a list of custom terminologies associated with your account.

Parameters:

listTerminologiesRequest -

Returns:

A Java Future object containing the response from the ListTerminologies service method, as returned by Amazon Translate.

Throws:

InvalidParameterValueException

TooManyRequestsException

InternalServerException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Translate indicating either a problem with the data in the request, or a server side issue.

listTerminologiesAsync

Future<ListTerminologiesResult> listTerminologiesAsync(ListTerminologiesRequest listTerminologiesRequest,
                                                       AsyncHandler<ListTerminologiesRequest,ListTerminologiesResult> asyncHandler)
                                                throws AmazonServiceException,
                                                       AmazonClientException

Provides a list of custom terminologies associated with your account.

Parameters:

listTerminologiesRequest -

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the ListTerminologies service method, as returned by Amazon Translate.

Throws:

InvalidParameterValueException

TooManyRequestsException

InternalServerException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Translate indicating either a problem with the data in the request, or a server side issue.

translateTextAsync

Future<TranslateTextResult> translateTextAsync(TranslateTextRequest translateTextRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

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.

Parameters:

translateTextRequest -

Returns:

A Java Future object containing the response from the TranslateText service method, as returned by Amazon Translate.

Throws:

InvalidRequestException

TextSizeLimitExceededException

TooManyRequestsException

UnsupportedLanguagePairException

DetectedLanguageLowConfidenceException

ResourceNotFoundException

InternalServerException

ServiceUnavailableException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Translate indicating either a problem with the data in the request, or a server side issue.

translateTextAsync

Future<TranslateTextResult> translateTextAsync(TranslateTextRequest translateTextRequest,
                                               AsyncHandler<TranslateTextRequest,TranslateTextResult> asyncHandler)
                                        throws AmazonServiceException,
                                               AmazonClientException

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.

Parameters:

translateTextRequest -

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the TranslateText service method, as returned by Amazon Translate.

Throws:

InvalidRequestException

TextSizeLimitExceededException

TooManyRequestsException

UnsupportedLanguagePairException

DetectedLanguageLowConfidenceException

ResourceNotFoundException

InternalServerException

ServiceUnavailableException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Translate indicating either a problem with the data in the request, or a server side issue.