/* * Copyright 2010-2023 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.translate.model; import java.io.Serializable; import com.amazonaws.AmazonWebServiceRequest; /** *

* Translates input text from the source language to the target language. For a * list of available languages and language codes, see Supported languages. *

*/ public class TranslateTextRequest extends AmazonWebServiceRequest implements Serializable { /** *

* The text to translate. The text string can be a maximum of 10,000 bytes * long. Depending on your character set, this may be fewer than 10,000 * characters. *

* Constraints:
* Length: 1 - 10000
* Pattern: [\P{M}\p{M}]{1,10000}
*/ private String text; /** *

* The name of a terminology list file to add to the translation job. This * file provides source terms and the desired translation for each term. A * terminology list can contain a maximum of 256 terms. You can use one * custom terminology resource in your translation request. *

* Use the ListTerminologies operation to get the available * terminology lists. *

* For more information about custom terminology lists, see Custom terminology. *

*/ private java.util.List terminologyNames; /** *

* The language code for the language of the source text. For a list of * language codes, see Supported languages. *

* 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. *

* *

* If you specify auto, you must send the * TranslateText request in a region that supports Amazon * Comprehend. Otherwise, the request returns an error indicating that * autodetect is not supported. *

* *

* Constraints:
* Length: 2 - 5
*/ private String sourceLanguageCode; /** *

* The language code requested for the language of the target text. For a * list of language codes, see Supported languages. *

* Constraints:
* Length: 2 - 5
*/ private String targetLanguageCode; /** *

* Settings to configure your translation output, including the option to * set the formality level of the output text and the option to mask profane * words and phrases. *

*/ private TranslationSettings settings; /** *

* The text to translate. The text string can be a maximum of 10,000 bytes * long. Depending on your character set, this may be fewer than 10,000 * characters. *

* Constraints:
* Length: 1 - 10000
* Pattern: [\P{M}\p{M}]{1,10000}
* * @return

* The text to translate. The text string can be a maximum of 10,000 * bytes long. Depending on your character set, this may be fewer * than 10,000 characters. *

*/ public String getText() { return text; } /** *

* The text to translate. The text string can be a maximum of 10,000 bytes * long. Depending on your character set, this may be fewer than 10,000 * characters. *

* Constraints:
* Length: 1 - 10000
* Pattern: [\P{M}\p{M}]{1,10000}
* * @param text

* The text to translate. The text string can be a maximum of * 10,000 bytes long. Depending on your character set, this may * be fewer than 10,000 characters. *

*/ public void setText(String text) { this.text = text; } /** *

* The text to translate. The text string can be a maximum of 10,000 bytes * long. Depending on your character set, this may be fewer than 10,000 * characters. *

* Returns a reference to this object so that method calls can be chained * together. *

* Constraints:
* Length: 1 - 10000
* Pattern: [\P{M}\p{M}]{1,10000}
* * @param text

* The text to translate. The text string can be a maximum of * 10,000 bytes long. Depending on your character set, this may * be fewer than 10,000 characters. *

* @return A reference to this updated object so that method calls can be * chained together. */ public TranslateTextRequest withText(String text) { this.text = text; return this; } /** *

* Use the ListTerminologies operation to get the available * terminology lists. *

* For more information about custom terminology lists, see Custom terminology. *

* * @return

* The name of a terminology list file to add to the translation * job. This file provides source terms and the desired translation * for each term. A terminology list can contain a maximum of 256 * terms. You can use one custom terminology resource in your * translation request. *

* Use the ListTerminologies operation to get the available * terminology lists. *

* For more information about custom terminology lists, see Custom terminology. *

*/ public java.util.List getTerminologyNames() { return terminologyNames; } /** *

* Use the ListTerminologies operation to get the available * terminology lists. *

* For more information about custom terminology lists, see Custom terminology. *

* * @param terminologyNames

* The name of a terminology list file to add to the translation * job. This file provides source terms and the desired * translation for each term. A terminology list can contain a * maximum of 256 terms. You can use one custom terminology * resource in your translation request. *

* Use the ListTerminologies operation to get the * available terminology lists. *

* For more information about custom terminology lists, see Custom terminology. *

*/ public void setTerminologyNames(java.util.Collection terminologyNames) { if (terminologyNames == null) { this.terminologyNames = null; return; } this.terminologyNames = new java.util.ArrayList(terminologyNames); } /** *

* Use the ListTerminologies operation to get the available * terminology lists. *

* For more information about custom terminology lists, see Custom terminology. *

* Returns a reference to this object so that method calls can be chained * together. * * @param terminologyNames

* Use the ListTerminologies operation to get the * available terminology lists. *

* For more information about custom terminology lists, see Custom terminology. *

* @return A reference to this updated object so that method calls can be * chained together. */ public TranslateTextRequest withTerminologyNames(String... terminologyNames) { if (getTerminologyNames() == null) { this.terminologyNames = new java.util.ArrayList(terminologyNames.length); } for (String value : terminologyNames) { this.terminologyNames.add(value); } return this; } /** *

* Use the ListTerminologies operation to get the available * terminology lists. *

* For more information about custom terminology lists, see Custom terminology. *

* Returns a reference to this object so that method calls can be chained * together. * * @param terminologyNames

* Use the ListTerminologies operation to get the * available terminology lists. *

* For more information about custom terminology lists, see Custom terminology. *

* @return A reference to this updated object so that method calls can be * chained together. */ public TranslateTextRequest withTerminologyNames(java.util.Collection terminologyNames) { setTerminologyNames(terminologyNames); return this; } /** *

* The language code for the language of the source text. For a list of * language codes, see Supported languages. *

* *

* Constraints:
* Length: 2 - 5
* * @return

* The language code for the language of the source text. For a list * of language codes, see Supported languages. *

* 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. *

* *

* If you specify auto, you must send the * TranslateText request in a region that supports * Amazon Comprehend. Otherwise, the request returns an error * indicating that autodetect is not supported. *

* */ public String getSourceLanguageCode() { return sourceLanguageCode; } /** *

* The language code for the language of the source text. For a list of * language codes, see Supported languages. *

* *

* Constraints:
* Length: 2 - 5
* * @param sourceLanguageCode

* The language code for the language of the source text. For a * list of language codes, see Supported languages. *

* *

* */ public void setSourceLanguageCode(String sourceLanguageCode) { this.sourceLanguageCode = sourceLanguageCode; } /** *

* The language code for the language of the source text. For a list of * language codes, see Supported languages. *

* *

* Returns a reference to this object so that method calls can be chained * together. *

* Constraints:
* Length: 2 - 5
* * @param sourceLanguageCode

* The language code for the language of the source text. For a * list of language codes, see Supported languages. *

* *

* * @return A reference to this updated object so that method calls can be * chained together. */ public TranslateTextRequest withSourceLanguageCode(String sourceLanguageCode) { this.sourceLanguageCode = sourceLanguageCode; return this; } /** *

* The language code requested for the language of the target text. For a * list of language codes, see Supported languages. *

* Constraints:
* Length: 2 - 5
* * @return

* The language code requested for the language of the target text. * For a list of language codes, see Supported languages. *

*/ public String getTargetLanguageCode() { return targetLanguageCode; } /** *

* The language code requested for the language of the target text. For a * list of language codes, see Supported languages. *

* Constraints:
* Length: 2 - 5
* * @param targetLanguageCode

* The language code requested for the language of the target * text. For a list of language codes, see Supported languages. *

*/ public void setTargetLanguageCode(String targetLanguageCode) { this.targetLanguageCode = targetLanguageCode; } /** *

* The language code requested for the language of the target text. For a * list of language codes, see Supported languages. *

* Returns a reference to this object so that method calls can be chained * together. *

* Constraints:
* Length: 2 - 5
* * @param targetLanguageCode

* The language code requested for the language of the target * text. For a list of language codes, see Supported languages. *

* @return A reference to this updated object so that method calls can be * chained together. */ public TranslateTextRequest withTargetLanguageCode(String targetLanguageCode) { this.targetLanguageCode = targetLanguageCode; return this; } /** *

* Settings to configure your translation output, including the option to * set the formality level of the output text and the option to mask profane * words and phrases. *

* * @return

* Settings to configure your translation output, including the * option to set the formality level of the output text and the * option to mask profane words and phrases. *

*/ public TranslationSettings getSettings() { return settings; } /** *

* Settings to configure your translation output, including the option to * set the formality level of the output text and the option to mask profane * words and phrases. *

* * @param settings

* Settings to configure your translation output, including the * option to set the formality level of the output text and the * option to mask profane words and phrases. *

*/ public void setSettings(TranslationSettings settings) { this.settings = settings; } /** *

* Settings to configure your translation output, including the option to * set the formality level of the output text and the option to mask profane * words and phrases. *

* Returns a reference to this object so that method calls can be chained * together. * * @param settings

* Settings to configure your translation output, including the * option to set the formality level of the output text and the * option to mask profane words and phrases. *

* @return A reference to this updated object so that method calls can be * chained together. */ public TranslateTextRequest withSettings(TranslationSettings settings) { this.settings = settings; return this; } /** * Returns a string representation of this object; useful for testing and * debugging. * * @return A string representation of this object. * @see java.lang.Object#toString() */ @Override public String toString() { StringBuilder sb = new StringBuilder(); sb.append("{"); if (getText() != null) sb.append("Text: " + getText() + ","); if (getTerminologyNames() != null) sb.append("TerminologyNames: " + getTerminologyNames() + ","); if (getSourceLanguageCode() != null) sb.append("SourceLanguageCode: " + getSourceLanguageCode() + ","); if (getTargetLanguageCode() != null) sb.append("TargetLanguageCode: " + getTargetLanguageCode() + ","); if (getSettings() != null) sb.append("Settings: " + getSettings()); sb.append("}"); return sb.toString(); } @Override public int hashCode() { final int prime = 31; int hashCode = 1; hashCode = prime * hashCode + ((getText() == null) ? 0 : getText().hashCode()); hashCode = prime * hashCode + ((getTerminologyNames() == null) ? 0 : getTerminologyNames().hashCode()); hashCode = prime * hashCode + ((getSourceLanguageCode() == null) ? 0 : getSourceLanguageCode().hashCode()); hashCode = prime * hashCode + ((getTargetLanguageCode() == null) ? 0 : getTargetLanguageCode().hashCode()); hashCode = prime * hashCode + ((getSettings() == null) ? 0 : getSettings().hashCode()); return hashCode; } @Override public boolean equals(Object obj) { if (this == obj) return true; if (obj == null) return false; if (obj instanceof TranslateTextRequest == false) return false; TranslateTextRequest other = (TranslateTextRequest) obj; if (other.getText() == null ^ this.getText() == null) return false; if (other.getText() != null && other.getText().equals(this.getText()) == false) return false; if (other.getTerminologyNames() == null ^ this.getTerminologyNames() == null) return false; if (other.getTerminologyNames() != null && other.getTerminologyNames().equals(this.getTerminologyNames()) == false) return false; if (other.getSourceLanguageCode() == null ^ this.getSourceLanguageCode() == null) return false; if (other.getSourceLanguageCode() != null && other.getSourceLanguageCode().equals(this.getSourceLanguageCode()) == false) return false; if (other.getTargetLanguageCode() == null ^ this.getTargetLanguageCode() == null) return false; if (other.getTargetLanguageCode() != null && other.getTargetLanguageCode().equals(this.getTargetLanguageCode()) == false) return false; if (other.getSettings() == null ^ this.getSettings() == null) return false; if (other.getSettings() != null && other.getSettings().equals(this.getSettings()) == false) return false; return true; } }