/*************************************************************************
* Copyright 2014 Eucalyptus Systems, Inc.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; version 3 of the License.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see http://www.gnu.org/licenses/.
*
* Please contact Eucalyptus Systems, Inc., 6755 Hollister Ave., Goleta
* CA 93117, USA or visit http://www.eucalyptus.com/licenses/ if you
* need additional information or have any questions.
*
* This file may incorporate work covered under the following copyright
* and permission notice:
* Copyright 2010-2015 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.eucalyptus.simpleworkflow.common.model;
import java.io.Serializable;
import javax.annotation.Nonnull;
import com.eucalyptus.auth.policy.annotation.PolicyAction;
/**
* Container for the parameters to the {@link com.amazonaws.services.simpleworkflow.AmazonSimpleWorkflow#listActivityTypes(ListActivityTypesRequest) ListActivityTypes operation}.
* <p>
* Returns information about all activities registered in the specified
* domain that match the specified name and registration status. The
* result includes information like creation date, current status of the
* activity, etc. The results may be split into multiple pages. To
* retrieve subsequent pages, make the call again using the
* <code>nextPageToken</code> returned by the initial call.
* </p>
* <p>
* <b>Access Control</b>
* </p>
* <p>
* You can use IAM policies to control this action's access to Amazon SWF
* resources as follows:
* </p>
*
* <ul>
* <li>Use a <code>Resource</code> element with the domain name to limit
* the action to only specified domains.</li>
* <li>Use an <code>Action</code> element to allow or deny permission to
* call this action.</li>
* <li>You cannot use an IAM policy to constrain this action's
* parameters.</li>
*
* </ul>
* <p>
* If the caller does not have sufficient permissions to invoke the
* action, or the parameter values fall outside the specified
* constraints, the action fails. The associated event attribute's
* <b>cause</b> parameter will be set to OPERATION_NOT_PERMITTED. For
* details and example IAM policies, see
* <a href="http://docs.aws.amazon.com/amazonswf/latest/developerguide/swf-dev-iam.html"> Using IAM to Manage Access to Amazon SWF Workflows </a>
* .
* </p>
*
* @see com.amazonaws.services.simpleworkflow.AmazonSimpleWorkflow#listActivityTypes(ListActivityTypesRequest)
*/
@PolicyAction( vendor = "swf", action = "listactivitytypes" )
public class ListActivityTypesRequest extends SimpleWorkflowMessage implements Serializable {
/**
* The name of the domain in which the activity types have been
* registered.
* <p>
* <b>Constraints:</b><br/>
* <b>Length: </b>1 - 256<br/>
*/
@Nonnull
@FieldRegex( FieldRegexValue.NAME_256 )
private String domain;
/**
* If specified, only lists the activity types that have this name.
* <p>
* <b>Constraints:</b><br/>
* <b>Length: </b>1 - 256<br/>
*/
@FieldRegex( FieldRegexValue.NAME_256 )
private String name;
/**
* Specifies the registration status of the activity types to list.
* <p>
* <b>Constraints:</b><br/>
* <b>Allowed Values: </b>REGISTERED, DEPRECATED
*/
@Nonnull
@FieldRegex( FieldRegexValue.REGISTRATION_STATUS )
private String registrationStatus;
/**
* If a <code>NextPageToken</code> was returned by a previous call, there
* are more results available. To retrieve the next page of results, make
* the call again using the returned token in <code>nextPageToken</code>.
* Keep all other arguments unchanged. <p>The configured
* <code>maximumPageSize</code> determines how many results can be
* returned in a single call.
* <p>
* <b>Constraints:</b><br/>
* <b>Length: </b>0 - 2048<br/>
*/
@FieldRegex( FieldRegexValue.OPT_STRING_2048 )
private String nextPageToken;
/**
* The maximum number of results that will be returned per call.
* <code>nextPageToken</code> can be used to obtain futher pages of
* results. The default is 1000, which is the maximum allowed page size.
* You can, however, specify a page size <i>smaller</i> than the maximum.
* <p>This is an upper limit only; the actual number of results returned
* per call may be fewer than the specified maximum.
* <p>
* <b>Constraints:</b><br/>
* <b>Range: </b>0 - 1000<br/>
*/
@FieldRange( max = 1000 )
private Integer maximumPageSize;
/**
* When set to <code>true</code>, returns the results in reverse order.
* By default, the results are returned in ascending alphabetical order
* by <code>name</code> of the activity types.
*/
private Boolean reverseOrder;
/**
* The name of the domain in which the activity types have been
* registered.
* <p>
* <b>Constraints:</b><br/>
* <b>Length: </b>1 - 256<br/>
*
* @return The name of the domain in which the activity types have been
* registered.
*/
public String getDomain() {
return domain;
}
/**
* The name of the domain in which the activity types have been
* registered.
* <p>
* <b>Constraints:</b><br/>
* <b>Length: </b>1 - 256<br/>
*
* @param domain The name of the domain in which the activity types have been
* registered.
*/
public void setDomain(String domain) {
this.domain = domain;
}
/**
* The name of the domain in which the activity types have been
* registered.
* <p>
* Returns a reference to this object so that method calls can be chained together.
* <p>
* <b>Constraints:</b><br/>
* <b>Length: </b>1 - 256<br/>
*
* @param domain The name of the domain in which the activity types have been
* registered.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public ListActivityTypesRequest withDomain(String domain) {
this.domain = domain;
return this;
}
/**
* If specified, only lists the activity types that have this name.
* <p>
* <b>Constraints:</b><br/>
* <b>Length: </b>1 - 256<br/>
*
* @return If specified, only lists the activity types that have this name.
*/
public String getName() {
return name;
}
/**
* If specified, only lists the activity types that have this name.
* <p>
* <b>Constraints:</b><br/>
* <b>Length: </b>1 - 256<br/>
*
* @param name If specified, only lists the activity types that have this name.
*/
public void setName(String name) {
this.name = name;
}
/**
* If specified, only lists the activity types that have this name.
* <p>
* Returns a reference to this object so that method calls can be chained together.
* <p>
* <b>Constraints:</b><br/>
* <b>Length: </b>1 - 256<br/>
*
* @param name If specified, only lists the activity types that have this name.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public ListActivityTypesRequest withName(String name) {
this.name = name;
return this;
}
/**
* Specifies the registration status of the activity types to list.
* <p>
* <b>Constraints:</b><br/>
* <b>Allowed Values: </b>REGISTERED, DEPRECATED
*
* @return Specifies the registration status of the activity types to list.
*
* @see RegistrationStatus
*/
public String getRegistrationStatus() {
return registrationStatus;
}
/**
* Specifies the registration status of the activity types to list.
* <p>
* <b>Constraints:</b><br/>
* <b>Allowed Values: </b>REGISTERED, DEPRECATED
*
* @param registrationStatus Specifies the registration status of the activity types to list.
*
* @see RegistrationStatus
*/
public void setRegistrationStatus(String registrationStatus) {
this.registrationStatus = registrationStatus;
}
/**
* Specifies the registration status of the activity types to list.
* <p>
* Returns a reference to this object so that method calls can be chained together.
* <p>
* <b>Constraints:</b><br/>
* <b>Allowed Values: </b>REGISTERED, DEPRECATED
*
* @param registrationStatus Specifies the registration status of the activity types to list.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*
* @see RegistrationStatus
*/
public ListActivityTypesRequest withRegistrationStatus(String registrationStatus) {
this.registrationStatus = registrationStatus;
return this;
}
/**
* Specifies the registration status of the activity types to list.
* <p>
* <b>Constraints:</b><br/>
* <b>Allowed Values: </b>REGISTERED, DEPRECATED
*
* @param registrationStatus Specifies the registration status of the activity types to list.
*
* @see RegistrationStatus
*/
public void setRegistrationStatus(RegistrationStatus registrationStatus) {
this.registrationStatus = registrationStatus.toString();
}
/**
* Specifies the registration status of the activity types to list.
* <p>
* Returns a reference to this object so that method calls can be chained together.
* <p>
* <b>Constraints:</b><br/>
* <b>Allowed Values: </b>REGISTERED, DEPRECATED
*
* @param registrationStatus Specifies the registration status of the activity types to list.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*
* @see RegistrationStatus
*/
public ListActivityTypesRequest withRegistrationStatus(RegistrationStatus registrationStatus) {
this.registrationStatus = registrationStatus.toString();
return this;
}
/**
* If a <code>NextPageToken</code> was returned by a previous call, there
* are more results available. To retrieve the next page of results, make
* the call again using the returned token in <code>nextPageToken</code>.
* Keep all other arguments unchanged. <p>The configured
* <code>maximumPageSize</code> determines how many results can be
* returned in a single call.
* <p>
* <b>Constraints:</b><br/>
* <b>Length: </b>0 - 2048<br/>
*
* @return If a <code>NextPageToken</code> was returned by a previous call, there
* are more results available. To retrieve the next page of results, make
* the call again using the returned token in <code>nextPageToken</code>.
* Keep all other arguments unchanged. <p>The configured
* <code>maximumPageSize</code> determines how many results can be
* returned in a single call.
*/
public String getNextPageToken() {
return nextPageToken;
}
/**
* If a <code>NextPageToken</code> was returned by a previous call, there
* are more results available. To retrieve the next page of results, make
* the call again using the returned token in <code>nextPageToken</code>.
* Keep all other arguments unchanged. <p>The configured
* <code>maximumPageSize</code> determines how many results can be
* returned in a single call.
* <p>
* <b>Constraints:</b><br/>
* <b>Length: </b>0 - 2048<br/>
*
* @param nextPageToken If a <code>NextPageToken</code> was returned by a previous call, there
* are more results available. To retrieve the next page of results, make
* the call again using the returned token in <code>nextPageToken</code>.
* Keep all other arguments unchanged. <p>The configured
* <code>maximumPageSize</code> determines how many results can be
* returned in a single call.
*/
public void setNextPageToken(String nextPageToken) {
this.nextPageToken = nextPageToken;
}
/**
* If a <code>NextPageToken</code> was returned by a previous call, there
* are more results available. To retrieve the next page of results, make
* the call again using the returned token in <code>nextPageToken</code>.
* Keep all other arguments unchanged. <p>The configured
* <code>maximumPageSize</code> determines how many results can be
* returned in a single call.
* <p>
* Returns a reference to this object so that method calls can be chained together.
* <p>
* <b>Constraints:</b><br/>
* <b>Length: </b>0 - 2048<br/>
*
* @param nextPageToken If a <code>NextPageToken</code> was returned by a previous call, there
* are more results available. To retrieve the next page of results, make
* the call again using the returned token in <code>nextPageToken</code>.
* Keep all other arguments unchanged. <p>The configured
* <code>maximumPageSize</code> determines how many results can be
* returned in a single call.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public ListActivityTypesRequest withNextPageToken(String nextPageToken) {
this.nextPageToken = nextPageToken;
return this;
}
/**
* The maximum number of results that will be returned per call.
* <code>nextPageToken</code> can be used to obtain futher pages of
* results. The default is 1000, which is the maximum allowed page size.
* You can, however, specify a page size <i>smaller</i> than the maximum.
* <p>This is an upper limit only; the actual number of results returned
* per call may be fewer than the specified maximum.
* <p>
* <b>Constraints:</b><br/>
* <b>Range: </b>0 - 1000<br/>
*
* @return The maximum number of results that will be returned per call.
* <code>nextPageToken</code> can be used to obtain futher pages of
* results. The default is 1000, which is the maximum allowed page size.
* You can, however, specify a page size <i>smaller</i> than the maximum.
* <p>This is an upper limit only; the actual number of results returned
* per call may be fewer than the specified maximum.
*/
public Integer getMaximumPageSize() {
return maximumPageSize;
}
/**
* The maximum number of results that will be returned per call.
* <code>nextPageToken</code> can be used to obtain futher pages of
* results. The default is 1000, which is the maximum allowed page size.
* You can, however, specify a page size <i>smaller</i> than the maximum.
* <p>This is an upper limit only; the actual number of results returned
* per call may be fewer than the specified maximum.
* <p>
* <b>Constraints:</b><br/>
* <b>Range: </b>0 - 1000<br/>
*
* @param maximumPageSize The maximum number of results that will be returned per call.
* <code>nextPageToken</code> can be used to obtain futher pages of
* results. The default is 1000, which is the maximum allowed page size.
* You can, however, specify a page size <i>smaller</i> than the maximum.
* <p>This is an upper limit only; the actual number of results returned
* per call may be fewer than the specified maximum.
*/
public void setMaximumPageSize(Integer maximumPageSize) {
this.maximumPageSize = maximumPageSize;
}
/**
* The maximum number of results that will be returned per call.
* <code>nextPageToken</code> can be used to obtain futher pages of
* results. The default is 1000, which is the maximum allowed page size.
* You can, however, specify a page size <i>smaller</i> than the maximum.
* <p>This is an upper limit only; the actual number of results returned
* per call may be fewer than the specified maximum.
* <p>
* Returns a reference to this object so that method calls can be chained together.
* <p>
* <b>Constraints:</b><br/>
* <b>Range: </b>0 - 1000<br/>
*
* @param maximumPageSize The maximum number of results that will be returned per call.
* <code>nextPageToken</code> can be used to obtain futher pages of
* results. The default is 1000, which is the maximum allowed page size.
* You can, however, specify a page size <i>smaller</i> than the maximum.
* <p>This is an upper limit only; the actual number of results returned
* per call may be fewer than the specified maximum.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public ListActivityTypesRequest withMaximumPageSize(Integer maximumPageSize) {
this.maximumPageSize = maximumPageSize;
return this;
}
/**
* When set to <code>true</code>, returns the results in reverse order.
* By default, the results are returned in ascending alphabetical order
* by <code>name</code> of the activity types.
*
* @return When set to <code>true</code>, returns the results in reverse order.
* By default, the results are returned in ascending alphabetical order
* by <code>name</code> of the activity types.
*/
public Boolean isReverseOrder() {
return reverseOrder;
}
/**
* When set to <code>true</code>, returns the results in reverse order.
* By default, the results are returned in ascending alphabetical order
* by <code>name</code> of the activity types.
*
* @param reverseOrder When set to <code>true</code>, returns the results in reverse order.
* By default, the results are returned in ascending alphabetical order
* by <code>name</code> of the activity types.
*/
public void setReverseOrder(Boolean reverseOrder) {
this.reverseOrder = reverseOrder;
}
/**
* When set to <code>true</code>, returns the results in reverse order.
* By default, the results are returned in ascending alphabetical order
* by <code>name</code> of the activity types.
* <p>
* Returns a reference to this object so that method calls can be chained together.
*
* @param reverseOrder When set to <code>true</code>, returns the results in reverse order.
* By default, the results are returned in ascending alphabetical order
* by <code>name</code> of the activity types.
*
* @return A reference to this updated object so that method calls can be chained
* together.
*/
public ListActivityTypesRequest withReverseOrder(Boolean reverseOrder) {
this.reverseOrder = reverseOrder;
return this;
}
/**
* When set to <code>true</code>, returns the results in reverse order.
* By default, the results are returned in ascending alphabetical order
* by <code>name</code> of the activity types.
*
* @return When set to <code>true</code>, returns the results in reverse order.
* By default, the results are returned in ascending alphabetical order
* by <code>name</code> of the activity types.
*/
public Boolean getReverseOrder() {
return reverseOrder;
}
/**
* 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 (getDomain() != null) sb.append("Domain: " + getDomain() + ",");
if (getName() != null) sb.append("Name: " + getName() + ",");
if (getRegistrationStatus() != null) sb.append("RegistrationStatus: " + getRegistrationStatus() + ",");
if (getNextPageToken() != null) sb.append("NextPageToken: " + getNextPageToken() + ",");
if (getMaximumPageSize() != null) sb.append("MaximumPageSize: " + getMaximumPageSize() + ",");
if (isReverseOrder() != null) sb.append("ReverseOrder: " + isReverseOrder() );
sb.append("}");
return sb.toString();
}
@Override
public int hashCode() {
final int prime = 31;
int hashCode = 1;
hashCode = prime * hashCode + ((getDomain() == null) ? 0 : getDomain().hashCode());
hashCode = prime * hashCode + ((getName() == null) ? 0 : getName().hashCode());
hashCode = prime * hashCode + ((getRegistrationStatus() == null) ? 0 : getRegistrationStatus().hashCode());
hashCode = prime * hashCode + ((getNextPageToken() == null) ? 0 : getNextPageToken().hashCode());
hashCode = prime * hashCode + ((getMaximumPageSize() == null) ? 0 : getMaximumPageSize().hashCode());
hashCode = prime * hashCode + ((isReverseOrder() == null) ? 0 : isReverseOrder().hashCode());
return hashCode;
}
@Override
public boolean equals(Object obj) {
if (this == obj) return true;
if (obj == null) return false;
if (obj instanceof ListActivityTypesRequest == false) return false;
ListActivityTypesRequest other = (ListActivityTypesRequest)obj;
if (other.getDomain() == null ^ this.getDomain() == null) return false;
if (other.getDomain() != null && other.getDomain().equals(this.getDomain()) == false) return false;
if (other.getName() == null ^ this.getName() == null) return false;
if (other.getName() != null && other.getName().equals(this.getName()) == false) return false;
if (other.getRegistrationStatus() == null ^ this.getRegistrationStatus() == null) return false;
if (other.getRegistrationStatus() != null && other.getRegistrationStatus().equals(this.getRegistrationStatus()) == false) return false;
if (other.getNextPageToken() == null ^ this.getNextPageToken() == null) return false;
if (other.getNextPageToken() != null && other.getNextPageToken().equals(this.getNextPageToken()) == false) return false;
if (other.getMaximumPageSize() == null ^ this.getMaximumPageSize() == null) return false;
if (other.getMaximumPageSize() != null && other.getMaximumPageSize().equals(this.getMaximumPageSize()) == false) return false;
if (other.isReverseOrder() == null ^ this.isReverseOrder() == null) return false;
if (other.isReverseOrder() != null && other.isReverseOrder().equals(this.isReverseOrder()) == false) return false;
return true;
}
}