com.amazonaws.services.translate

Class AmazonTranslateClient

java.lang.Object

com.amazonaws.AmazonWebServiceClient

com.amazonaws.services.translate.AmazonTranslateClient

All Implemented Interfaces:

AmazonTranslate

Direct Known Subclasses:

AmazonTranslateAsyncClient

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

Client for accessing Amazon Translate. All service calls made using this client are blocking, and will not return until the service call completes.

Provides translation between English and one of six languages, or between one of the six languages and English.

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceClient

LOGGING_AWS_REQUEST_METRIC

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

ENDPOINT_PREFIX

Method Summary

Modifier and Type	Method and Description
static AmazonTranslateClientBuilder	builder()
ResponseMetadata	getCachedResponseMetadata(AmazonWebServiceRequest request) Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected.
TranslateTextResult	translateText(TranslateTextRequest request) Translates input text from the source language to the target language.

Methods inherited from class com.amazonaws.AmazonWebServiceClient

addRequestHandler, addRequestHandler, configureRegion, getEndpointPrefix, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, shutdown, withEndpoint, withRegion, withRegion, withTimeOffset

Methods inherited from class java.lang.Object

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

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

shutdown

Method Detail

builder

public static AmazonTranslateClientBuilder builder()

translateText

public TranslateTextResult translateText(TranslateTextRequest request)

Translates input text from the source language to the target language. You can translate between English (en) and one of the following languages, or between one of the following languages and English.

• Arabic (ar)

• Chinese (Simplified) (zh)

• French (fr)

• German (de)

• Portuguese (pt)

• Spanish (es)

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:

translateText in interface AmazonTranslate

Parameters:

translateTextRequest -

Returns:

Result of the TranslateText operation returned by the service.

Throws:

InvalidRequestException - The request is invalid.

TextSizeLimitExceededException - The size of the input text exceeds the length constraint for the Text field. Try again with a shorter text.

TooManyRequestsException - The number of requests exceeds the limit. Resubmit your request later.

UnsupportedLanguagePairException - Amazon Translate cannot translate input text in the source language into this target language. For more information, see how-to-error-msg.

DetectedLanguageLowConfidenceException - The confidence that Amazon Comprehend accurately detected the source language is low. If a low confidence level is acceptable for your application, you can use the language in the exception to call Amazon Translate again. For more information, see the DetectDominantLanguage operation in the Amazon Comprehend Developer Guide.

InternalServerException - An internal server error occurred. Retry your request.

ServiceUnavailableException - Amazon Translate is unavailable. Retry your request later.

See Also:

AWS API Documentation

getCachedResponseMetadata

public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.

Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.

Specified by:

getCachedResponseMetadata in interface AmazonTranslate

Parameters:

request - The originally executed request

Returns:

The response metadata for the specified request, or null if none is available.