com.amazonaws.services.simpleworkflow.model.RespondActivityTaskFailedRequest Maven / Gradle / Ivy
Show all versions of aws-java-sdk Show documentation
/*
* Copyright 2010-2014 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.simpleworkflow.model;
import java.io.Serializable;
import com.amazonaws.AmazonWebServiceRequest;
/**
* Container for the parameters to the {@link com.amazonaws.services.simpleworkflow.AmazonSimpleWorkflow#respondActivityTaskFailed(RespondActivityTaskFailedRequest) RespondActivityTaskFailed operation}.
*
* Used by workers to tell the service that the ActivityTask identified
* by the taskToken has failed with reason (if
* specified). The reason and details appear in
* the ActivityTaskFailed event added to the workflow
* history.
*
*
* A task is considered open from the time that it is scheduled until it
* is closed. Therefore a task is reported as open while a worker is
* processing it. A task is closed after it has been specified in a call
* to RespondActivityTaskCompleted, RespondActivityTaskCanceled,
* RespondActivityTaskFailed, or the task has
* timed out
* .
*
*
* Access Control
*
*
* You can use IAM policies to control this action's access to Amazon SWF
* resources as follows:
*
*
*
* - Use a
Resource element with the domain name to limit
* the action to only specified domains.
* - Use an
Action element to allow or deny permission to
* call this action.
* - You cannot use an IAM policy to constrain this action's
* parameters.
*
*
*
* If the caller does not have sufficient permissions to invoke the
* action, or the parameter values fall outside the specified
* constraints, the action fails by throwing
* OperationNotPermitted . For details and example IAM
* policies, see
* Using IAM to Manage Access to Amazon SWF Workflows
* .
*
*
* @see com.amazonaws.services.simpleworkflow.AmazonSimpleWorkflow#respondActivityTaskFailed(RespondActivityTaskFailedRequest)
*/
public class RespondActivityTaskFailedRequest extends AmazonWebServiceRequest implements Serializable {
/**
* The taskToken of the ActivityTask. The
* taskToken is generated by the service and should be
* treated as an opaque value. If the task is passed to another process,
* its taskToken must also be passed. This enables it to
* provide its progress and respond with results.
*
* Constraints:
* Length: 1 - 1024
*/
private String taskToken;
/**
* Description of the error that may assist in diagnostics.
*
* Constraints:
* Length: 0 - 256
*/
private String reason;
/**
* Optional detailed information about the failure.
*
* Constraints:
* Length: 0 - 32768
*/
private String details;
/**
* The taskToken of the ActivityTask. The
* taskToken is generated by the service and should be
* treated as an opaque value. If the task is passed to another process,
* its taskToken must also be passed. This enables it to
* provide its progress and respond with results.
*
* Constraints:
* Length: 1 - 1024
*
* @return The taskToken of the ActivityTask. The
* taskToken is generated by the service and should be
* treated as an opaque value. If the task is passed to another process,
* its taskToken must also be passed. This enables it to
* provide its progress and respond with results.
*/
public String getTaskToken() {
return taskToken;
}
/**
* The taskToken of the ActivityTask. The
* taskToken is generated by the service and should be
* treated as an opaque value. If the task is passed to another process,
* its taskToken must also be passed. This enables it to
* provide its progress and respond with results.
*
* Constraints:
* Length: 1 - 1024
*
* @param taskToken The taskToken of the ActivityTask. The
* taskToken is generated by the service and should be
* treated as an opaque value. If the task is passed to another process,
* its taskToken must also be passed. This enables it to
* provide its progress and respond with results.
*/
public void setTaskToken(String taskToken) {
this.taskToken = taskToken;
}
/**
* The taskToken of the ActivityTask. The
* taskToken is generated by the service and should be
* treated as an opaque value. If the task is passed to another process,
* its taskToken must also be passed. This enables it to
* provide its progress and respond with results.
*
* Returns a reference to this object so that method calls can be chained together.
*
* Constraints:
* Length: 1 - 1024
*
* @param taskToken The taskToken of the ActivityTask. The
* taskToken is generated by the service and should be
* treated as an opaque value. If the task is passed to another process,
* its taskToken must also be passed. This enables it to
* provide its progress and respond with results.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public RespondActivityTaskFailedRequest withTaskToken(String taskToken) {
this.taskToken = taskToken;
return this;
}
/**
* Description of the error that may assist in diagnostics.
*
* Constraints:
* Length: 0 - 256
*
* @return Description of the error that may assist in diagnostics.
*/
public String getReason() {
return reason;
}
/**
* Description of the error that may assist in diagnostics.
*
* Constraints:
* Length: 0 - 256
*
* @param reason Description of the error that may assist in diagnostics.
*/
public void setReason(String reason) {
this.reason = reason;
}
/**
* Description of the error that may assist in diagnostics.
*
* Returns a reference to this object so that method calls can be chained together.
*
* Constraints:
* Length: 0 - 256
*
* @param reason Description of the error that may assist in diagnostics.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public RespondActivityTaskFailedRequest withReason(String reason) {
this.reason = reason;
return this;
}
/**
* Optional detailed information about the failure.
*
* Constraints:
* Length: 0 - 32768
*
* @return Optional detailed information about the failure.
*/
public String getDetails() {
return details;
}
/**
* Optional detailed information about the failure.
*
* Constraints:
* Length: 0 - 32768
*
* @param details Optional detailed information about the failure.
*/
public void setDetails(String details) {
this.details = details;
}
/**
* Optional detailed information about the failure.
*
* Returns a reference to this object so that method calls can be chained together.
*
* Constraints:
* Length: 0 - 32768
*
* @param details Optional detailed information about the failure.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public RespondActivityTaskFailedRequest withDetails(String details) {
this.details = details;
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 (getTaskToken() != null) sb.append("TaskToken: " + getTaskToken() + ",");
if (getReason() != null) sb.append("Reason: " + getReason() + ",");
if (getDetails() != null) sb.append("Details: " + getDetails() );
sb.append("}");
return sb.toString();
}
@Override
public int hashCode() {
final int prime = 31;
int hashCode = 1;
hashCode = prime * hashCode + ((getTaskToken() == null) ? 0 : getTaskToken().hashCode());
hashCode = prime * hashCode + ((getReason() == null) ? 0 : getReason().hashCode());
hashCode = prime * hashCode + ((getDetails() == null) ? 0 : getDetails().hashCode());
return hashCode;
}
@Override
public boolean equals(Object obj) {
if (this == obj) return true;
if (obj == null) return false;
if (obj instanceof RespondActivityTaskFailedRequest == false) return false;
RespondActivityTaskFailedRequest other = (RespondActivityTaskFailedRequest)obj;
if (other.getTaskToken() == null ^ this.getTaskToken() == null) return false;
if (other.getTaskToken() != null && other.getTaskToken().equals(this.getTaskToken()) == false) return false;
if (other.getReason() == null ^ this.getReason() == null) return false;
if (other.getReason() != null && other.getReason().equals(this.getReason()) == false) return false;
if (other.getDetails() == null ^ this.getDetails() == null) return false;
if (other.getDetails() != null && other.getDetails().equals(this.getDetails()) == false) return false;
return true;
}
}