com.amazonaws.services.textract.model

Class StartDocumentTextDetectionRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.textract.model.StartDocumentTextDetectionRequest

All Implemented Interfaces:

Serializable, Cloneable

public class StartDocumentTextDetectionRequest
extends AmazonWebServiceRequest
implements Serializable

Starts the asynchronous detection of text in a document. Amazon Textract can detect lines of text and the words that make up a line of text.

StartDocumentTextDetection can analyze text in documents that are in JPG, PNG, and PDF format. The documents are stored in an Amazon S3 bucket. Use DocumentLocation to specify the bucket name and file name of the document.

StartTextDetection returns a job identifier (JobId) that you use to get the results of the operation. When text detection is finished, Amazon Textract publishes a completion status to the Amazon Simple Notification Service (Amazon SNS) topic that you specify in NotificationChannel. To get the results of the text detection operation, first check that the status value published to the Amazon SNS topic is SUCCEEDED. If so, call GetDocumentTextDetection, and pass the job identifier (JobId) from the initial call to StartDocumentTextDetection.

For more information, see Document Text Detection.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
StartDocumentTextDetectionRequest()

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
String	getClientRequestToken() The idempotent token that's used to identify the start request.
DocumentLocation	getDocumentLocation() The location of the document to be processed.
String	getJobTag() An identifier you specify that's included in the completion notification that's published to the Amazon SNS topic.
NotificationChannel	getNotificationChannel() The Amazon SNS topic ARN that you want Amazon Textract to publish the completion status of the operation to.
int	hashCode()
void	setClientRequestToken(String clientRequestToken) The idempotent token that's used to identify the start request.
void	setDocumentLocation(DocumentLocation documentLocation) The location of the document to be processed.
void	setJobTag(String jobTag) An identifier you specify that's included in the completion notification that's published to the Amazon SNS topic.
void	setNotificationChannel(NotificationChannel notificationChannel) The Amazon SNS topic ARN that you want Amazon Textract to publish the completion status of the operation to.
String	toString() Returns a string representation of this object; useful for testing and debugging.
StartDocumentTextDetectionRequest	withClientRequestToken(String clientRequestToken) The idempotent token that's used to identify the start request.
StartDocumentTextDetectionRequest	withDocumentLocation(DocumentLocation documentLocation) The location of the document to be processed.
StartDocumentTextDetectionRequest	withJobTag(String jobTag) An identifier you specify that's included in the completion notification that's published to the Amazon SNS topic.
StartDocumentTextDetectionRequest	withNotificationChannel(NotificationChannel notificationChannel) The Amazon SNS topic ARN that you want Amazon Textract to publish the completion status of the operation to.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

clone, copyBaseTo, getCloneRoot, getCloneSource, getGeneralProgressListener, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, withGeneralProgressListener, withRequestMetricCollector

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

StartDocumentTextDetectionRequest

public StartDocumentTextDetectionRequest()

Method Detail

getDocumentLocation

public DocumentLocation getDocumentLocation()

The location of the document to be processed.

Returns:

The location of the document to be processed.

setDocumentLocation

public void setDocumentLocation(DocumentLocation documentLocation)

The location of the document to be processed.

Parameters:

documentLocation -

The location of the document to be processed.

withDocumentLocation

public StartDocumentTextDetectionRequest withDocumentLocation(DocumentLocation documentLocation)

The location of the document to be processed.

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

Parameters:

documentLocation -

The location of the document to be processed.

Returns:

A reference to this updated object so that method calls can be chained together.

getClientRequestToken

public String getClientRequestToken()

The idempotent token that's used to identify the start request. If you use the same token with multiple StartDocumentTextDetection requests, the same JobId is returned. Use ClientRequestToken to prevent the same job from being accidentally started more than once.

Constraints:
Length: 1 - 64
Pattern: ^[a-zA-Z0-9-_]+$

Returns:

The idempotent token that's used to identify the start request. If you use the same token with multiple StartDocumentTextDetection requests, the same JobId is returned. Use ClientRequestToken to prevent the same job from being accidentally started more than once.

setClientRequestToken

public void setClientRequestToken(String clientRequestToken)

The idempotent token that's used to identify the start request. If you use the same token with multiple StartDocumentTextDetection requests, the same JobId is returned. Use ClientRequestToken to prevent the same job from being accidentally started more than once.

Constraints:
Length: 1 - 64
Pattern: ^[a-zA-Z0-9-_]+$

Parameters:

clientRequestToken -

The idempotent token that's used to identify the start request. If you use the same token with multiple StartDocumentTextDetection requests, the same JobId is returned. Use ClientRequestToken to prevent the same job from being accidentally started more than once.

withClientRequestToken

public StartDocumentTextDetectionRequest withClientRequestToken(String clientRequestToken)

The idempotent token that's used to identify the start request. If you use the same token with multiple StartDocumentTextDetection requests, the same JobId is returned. Use ClientRequestToken to prevent the same job from being accidentally started more than once.

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

Constraints:
Length: 1 - 64
Pattern: ^[a-zA-Z0-9-_]+$

Parameters:

clientRequestToken -

The idempotent token that's used to identify the start request. If you use the same token with multiple StartDocumentTextDetection requests, the same JobId is returned. Use ClientRequestToken to prevent the same job from being accidentally started more than once.

Returns:

A reference to this updated object so that method calls can be chained together.

getJobTag

public String getJobTag()

An identifier you specify that's included in the completion notification that's published to the Amazon SNS topic. For example, you can use JobTag to identify the type of document, such as a tax form or a receipt, that the completion notification corresponds to.

Constraints:
Length: 1 - 64
Pattern: [a-zA-Z0-9_.\-:]+

Returns:

An identifier you specify that's included in the completion notification that's published to the Amazon SNS topic. For example, you can use JobTag to identify the type of document, such as a tax form or a receipt, that the completion notification corresponds to.

setJobTag

public void setJobTag(String jobTag)

An identifier you specify that's included in the completion notification that's published to the Amazon SNS topic. For example, you can use JobTag to identify the type of document, such as a tax form or a receipt, that the completion notification corresponds to.

Constraints:
Length: 1 - 64
Pattern: [a-zA-Z0-9_.\-:]+

Parameters:

jobTag -

An identifier you specify that's included in the completion notification that's published to the Amazon SNS topic. For example, you can use JobTag to identify the type of document, such as a tax form or a receipt, that the completion notification corresponds to.

withJobTag

public StartDocumentTextDetectionRequest withJobTag(String jobTag)

An identifier you specify that's included in the completion notification that's published to the Amazon SNS topic. For example, you can use JobTag to identify the type of document, such as a tax form or a receipt, that the completion notification corresponds to.

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

Constraints:
Length: 1 - 64
Pattern: [a-zA-Z0-9_.\-:]+

Parameters:

jobTag -

An identifier you specify that's included in the completion notification that's published to the Amazon SNS topic. For example, you can use JobTag to identify the type of document, such as a tax form or a receipt, that the completion notification corresponds to.

Returns:

A reference to this updated object so that method calls can be chained together.

getNotificationChannel

public NotificationChannel getNotificationChannel()

The Amazon SNS topic ARN that you want Amazon Textract to publish the completion status of the operation to.

Returns:

The Amazon SNS topic ARN that you want Amazon Textract to publish the completion status of the operation to.

setNotificationChannel

public void setNotificationChannel(NotificationChannel notificationChannel)

The Amazon SNS topic ARN that you want Amazon Textract to publish the completion status of the operation to.

Parameters:

notificationChannel -

The Amazon SNS topic ARN that you want Amazon Textract to publish the completion status of the operation to.

withNotificationChannel

public StartDocumentTextDetectionRequest withNotificationChannel(NotificationChannel notificationChannel)

The Amazon SNS topic ARN that you want Amazon Textract to publish the completion status of the operation to.

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

Parameters:

notificationChannel -

The Amazon SNS topic ARN that you want Amazon Textract to publish the completion status of the operation to.

Returns:

A reference to this updated object so that method calls can be chained together.

toString

public String toString()

Returns a string representation of this object; useful for testing and debugging.

Overrides:

toString in class Object

Returns:

A string representation of this object.

See Also:

Object.toString()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object