/* * Copyright 2012-2017 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.kinesis.model; import java.io.Serializable; import javax.annotation.Generated; import com.amazonaws.protocol.StructuredPojo; import com.amazonaws.protocol.ProtocolMarshaller; /** * <p> * Represents the output for <a>DescribeStream</a>. * </p> * * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/StreamDescription" target="_top">AWS API * Documentation</a> */ @Generated("com.amazonaws:aws-java-sdk-code-generator") public class StreamDescription implements Serializable, Cloneable, StructuredPojo { /** * <p> * The name of the stream being described. * </p> */ private String streamName; /** * <p> * The Amazon Resource Name (ARN) for the stream being described. * </p> */ private String streamARN; /** * <p> * The current status of the stream being described. The stream status is one of the following states: * </p> * <ul> * <li> * <p> * <code>CREATING</code> - The stream is being created. Amazon Kinesis immediately returns and sets * <code>StreamStatus</code> to <code>CREATING</code>. * </p> * </li> * <li> * <p> * <code>DELETING</code> - The stream is being deleted. The specified stream is in the <code>DELETING</code> state * until Amazon Kinesis completes the deletion. * </p> * </li> * <li> * <p> * <code>ACTIVE</code> - The stream exists and is ready for read and write operations or deletion. You should * perform read and write operations only on an <code>ACTIVE</code> stream. * </p> * </li> * <li> * <p> * <code>UPDATING</code> - Shards in the stream are being merged or split. Read and write operations continue to * work while the stream is in the <code>UPDATING</code> state. * </p> * </li> * </ul> */ private String streamStatus; /** * <p> * The shards that comprise the stream. * </p> */ private com.amazonaws.internal.SdkInternalList<Shard> shards; /** * <p> * If set to <code>true</code>, more shards in the stream are available to describe. * </p> */ private Boolean hasMoreShards; /** * <p> * The current retention period, in hours. * </p> */ private Integer retentionPeriodHours; /** * <p> * The approximate time that the stream was created. * </p> */ private java.util.Date streamCreationTimestamp; /** * <p> * Represents the current enhanced monitoring settings of the stream. * </p> */ private com.amazonaws.internal.SdkInternalList<EnhancedMetrics> enhancedMonitoring; /** * <p> * The name of the stream being described. * </p> * * @param streamName * The name of the stream being described. */ public void setStreamName(String streamName) { this.streamName = streamName; } /** * <p> * The name of the stream being described. * </p> * * @return The name of the stream being described. */ public String getStreamName() { return this.streamName; } /** * <p> * The name of the stream being described. * </p> * * @param streamName * The name of the stream being described. * @return Returns a reference to this object so that method calls can be chained together. */ public StreamDescription withStreamName(String streamName) { setStreamName(streamName); return this; } /** * <p> * The Amazon Resource Name (ARN) for the stream being described. * </p> * * @param streamARN * The Amazon Resource Name (ARN) for the stream being described. */ public void setStreamARN(String streamARN) { this.streamARN = streamARN; } /** * <p> * The Amazon Resource Name (ARN) for the stream being described. * </p> * * @return The Amazon Resource Name (ARN) for the stream being described. */ public String getStreamARN() { return this.streamARN; } /** * <p> * The Amazon Resource Name (ARN) for the stream being described. * </p> * * @param streamARN * The Amazon Resource Name (ARN) for the stream being described. * @return Returns a reference to this object so that method calls can be chained together. */ public StreamDescription withStreamARN(String streamARN) { setStreamARN(streamARN); return this; } /** * <p> * The current status of the stream being described. The stream status is one of the following states: * </p> * <ul> * <li> * <p> * <code>CREATING</code> - The stream is being created. Amazon Kinesis immediately returns and sets * <code>StreamStatus</code> to <code>CREATING</code>. * </p> * </li> * <li> * <p> * <code>DELETING</code> - The stream is being deleted. The specified stream is in the <code>DELETING</code> state * until Amazon Kinesis completes the deletion. * </p> * </li> * <li> * <p> * <code>ACTIVE</code> - The stream exists and is ready for read and write operations or deletion. You should * perform read and write operations only on an <code>ACTIVE</code> stream. * </p> * </li> * <li> * <p> * <code>UPDATING</code> - Shards in the stream are being merged or split. Read and write operations continue to * work while the stream is in the <code>UPDATING</code> state. * </p> * </li> * </ul> * * @param streamStatus * The current status of the stream being described. The stream status is one of the following states:</p> * <ul> * <li> * <p> * <code>CREATING</code> - The stream is being created. Amazon Kinesis immediately returns and sets * <code>StreamStatus</code> to <code>CREATING</code>. * </p> * </li> * <li> * <p> * <code>DELETING</code> - The stream is being deleted. The specified stream is in the <code>DELETING</code> * state until Amazon Kinesis completes the deletion. * </p> * </li> * <li> * <p> * <code>ACTIVE</code> - The stream exists and is ready for read and write operations or deletion. You should * perform read and write operations only on an <code>ACTIVE</code> stream. * </p> * </li> * <li> * <p> * <code>UPDATING</code> - Shards in the stream are being merged or split. Read and write operations continue * to work while the stream is in the <code>UPDATING</code> state. * </p> * </li> * @see StreamStatus */ public void setStreamStatus(String streamStatus) { this.streamStatus = streamStatus; } /** * <p> * The current status of the stream being described. The stream status is one of the following states: * </p> * <ul> * <li> * <p> * <code>CREATING</code> - The stream is being created. Amazon Kinesis immediately returns and sets * <code>StreamStatus</code> to <code>CREATING</code>. * </p> * </li> * <li> * <p> * <code>DELETING</code> - The stream is being deleted. The specified stream is in the <code>DELETING</code> state * until Amazon Kinesis completes the deletion. * </p> * </li> * <li> * <p> * <code>ACTIVE</code> - The stream exists and is ready for read and write operations or deletion. You should * perform read and write operations only on an <code>ACTIVE</code> stream. * </p> * </li> * <li> * <p> * <code>UPDATING</code> - Shards in the stream are being merged or split. Read and write operations continue to * work while the stream is in the <code>UPDATING</code> state. * </p> * </li> * </ul> * * @return The current status of the stream being described. The stream status is one of the following states:</p> * <ul> * <li> * <p> * <code>CREATING</code> - The stream is being created. Amazon Kinesis immediately returns and sets * <code>StreamStatus</code> to <code>CREATING</code>. * </p> * </li> * <li> * <p> * <code>DELETING</code> - The stream is being deleted. The specified stream is in the <code>DELETING</code> * state until Amazon Kinesis completes the deletion. * </p> * </li> * <li> * <p> * <code>ACTIVE</code> - The stream exists and is ready for read and write operations or deletion. You * should perform read and write operations only on an <code>ACTIVE</code> stream. * </p> * </li> * <li> * <p> * <code>UPDATING</code> - Shards in the stream are being merged or split. Read and write operations * continue to work while the stream is in the <code>UPDATING</code> state. * </p> * </li> * @see StreamStatus */ public String getStreamStatus() { return this.streamStatus; } /** * <p> * The current status of the stream being described. The stream status is one of the following states: * </p> * <ul> * <li> * <p> * <code>CREATING</code> - The stream is being created. Amazon Kinesis immediately returns and sets * <code>StreamStatus</code> to <code>CREATING</code>. * </p> * </li> * <li> * <p> * <code>DELETING</code> - The stream is being deleted. The specified stream is in the <code>DELETING</code> state * until Amazon Kinesis completes the deletion. * </p> * </li> * <li> * <p> * <code>ACTIVE</code> - The stream exists and is ready for read and write operations or deletion. You should * perform read and write operations only on an <code>ACTIVE</code> stream. * </p> * </li> * <li> * <p> * <code>UPDATING</code> - Shards in the stream are being merged or split. Read and write operations continue to * work while the stream is in the <code>UPDATING</code> state. * </p> * </li> * </ul> * * @param streamStatus * The current status of the stream being described. The stream status is one of the following states:</p> * <ul> * <li> * <p> * <code>CREATING</code> - The stream is being created. Amazon Kinesis immediately returns and sets * <code>StreamStatus</code> to <code>CREATING</code>. * </p> * </li> * <li> * <p> * <code>DELETING</code> - The stream is being deleted. The specified stream is in the <code>DELETING</code> * state until Amazon Kinesis completes the deletion. * </p> * </li> * <li> * <p> * <code>ACTIVE</code> - The stream exists and is ready for read and write operations or deletion. You should * perform read and write operations only on an <code>ACTIVE</code> stream. * </p> * </li> * <li> * <p> * <code>UPDATING</code> - Shards in the stream are being merged or split. Read and write operations continue * to work while the stream is in the <code>UPDATING</code> state. * </p> * </li> * @return Returns a reference to this object so that method calls can be chained together. * @see StreamStatus */ public StreamDescription withStreamStatus(String streamStatus) { setStreamStatus(streamStatus); return this; } /** * <p> * The current status of the stream being described. The stream status is one of the following states: * </p> * <ul> * <li> * <p> * <code>CREATING</code> - The stream is being created. Amazon Kinesis immediately returns and sets * <code>StreamStatus</code> to <code>CREATING</code>. * </p> * </li> * <li> * <p> * <code>DELETING</code> - The stream is being deleted. The specified stream is in the <code>DELETING</code> state * until Amazon Kinesis completes the deletion. * </p> * </li> * <li> * <p> * <code>ACTIVE</code> - The stream exists and is ready for read and write operations or deletion. You should * perform read and write operations only on an <code>ACTIVE</code> stream. * </p> * </li> * <li> * <p> * <code>UPDATING</code> - Shards in the stream are being merged or split. Read and write operations continue to * work while the stream is in the <code>UPDATING</code> state. * </p> * </li> * </ul> * * @param streamStatus * The current status of the stream being described. The stream status is one of the following states:</p> * <ul> * <li> * <p> * <code>CREATING</code> - The stream is being created. Amazon Kinesis immediately returns and sets * <code>StreamStatus</code> to <code>CREATING</code>. * </p> * </li> * <li> * <p> * <code>DELETING</code> - The stream is being deleted. The specified stream is in the <code>DELETING</code> * state until Amazon Kinesis completes the deletion. * </p> * </li> * <li> * <p> * <code>ACTIVE</code> - The stream exists and is ready for read and write operations or deletion. You should * perform read and write operations only on an <code>ACTIVE</code> stream. * </p> * </li> * <li> * <p> * <code>UPDATING</code> - Shards in the stream are being merged or split. Read and write operations continue * to work while the stream is in the <code>UPDATING</code> state. * </p> * </li> * @see StreamStatus */ public void setStreamStatus(StreamStatus streamStatus) { this.streamStatus = streamStatus.toString(); } /** * <p> * The current status of the stream being described. The stream status is one of the following states: * </p> * <ul> * <li> * <p> * <code>CREATING</code> - The stream is being created. Amazon Kinesis immediately returns and sets * <code>StreamStatus</code> to <code>CREATING</code>. * </p> * </li> * <li> * <p> * <code>DELETING</code> - The stream is being deleted. The specified stream is in the <code>DELETING</code> state * until Amazon Kinesis completes the deletion. * </p> * </li> * <li> * <p> * <code>ACTIVE</code> - The stream exists and is ready for read and write operations or deletion. You should * perform read and write operations only on an <code>ACTIVE</code> stream. * </p> * </li> * <li> * <p> * <code>UPDATING</code> - Shards in the stream are being merged or split. Read and write operations continue to * work while the stream is in the <code>UPDATING</code> state. * </p> * </li> * </ul> * * @param streamStatus * The current status of the stream being described. The stream status is one of the following states:</p> * <ul> * <li> * <p> * <code>CREATING</code> - The stream is being created. Amazon Kinesis immediately returns and sets * <code>StreamStatus</code> to <code>CREATING</code>. * </p> * </li> * <li> * <p> * <code>DELETING</code> - The stream is being deleted. The specified stream is in the <code>DELETING</code> * state until Amazon Kinesis completes the deletion. * </p> * </li> * <li> * <p> * <code>ACTIVE</code> - The stream exists and is ready for read and write operations or deletion. You should * perform read and write operations only on an <code>ACTIVE</code> stream. * </p> * </li> * <li> * <p> * <code>UPDATING</code> - Shards in the stream are being merged or split. Read and write operations continue * to work while the stream is in the <code>UPDATING</code> state. * </p> * </li> * @return Returns a reference to this object so that method calls can be chained together. * @see StreamStatus */ public StreamDescription withStreamStatus(StreamStatus streamStatus) { setStreamStatus(streamStatus); return this; } /** * <p> * The shards that comprise the stream. * </p> * * @return The shards that comprise the stream. */ public java.util.List<Shard> getShards() { if (shards == null) { shards = new com.amazonaws.internal.SdkInternalList<Shard>(); } return shards; } /** * <p> * The shards that comprise the stream. * </p> * * @param shards * The shards that comprise the stream. */ public void setShards(java.util.Collection<Shard> shards) { if (shards == null) { this.shards = null; return; } this.shards = new com.amazonaws.internal.SdkInternalList<Shard>(shards); } /** * <p> * The shards that comprise the stream. * </p> * <p> * <b>NOTE:</b> This method appends the values to the existing list (if any). Use * {@link #setShards(java.util.Collection)} or {@link #withShards(java.util.Collection)} if you want to override the * existing values. * </p> * * @param shards * The shards that comprise the stream. * @return Returns a reference to this object so that method calls can be chained together. */ public StreamDescription withShards(Shard... shards) { if (this.shards == null) { setShards(new com.amazonaws.internal.SdkInternalList<Shard>(shards.length)); } for (Shard ele : shards) { this.shards.add(ele); } return this; } /** * <p> * The shards that comprise the stream. * </p> * * @param shards * The shards that comprise the stream. * @return Returns a reference to this object so that method calls can be chained together. */ public StreamDescription withShards(java.util.Collection<Shard> shards) { setShards(shards); return this; } /** * <p> * If set to <code>true</code>, more shards in the stream are available to describe. * </p> * * @param hasMoreShards * If set to <code>true</code>, more shards in the stream are available to describe. */ public void setHasMoreShards(Boolean hasMoreShards) { this.hasMoreShards = hasMoreShards; } /** * <p> * If set to <code>true</code>, more shards in the stream are available to describe. * </p> * * @return If set to <code>true</code>, more shards in the stream are available to describe. */ public Boolean getHasMoreShards() { return this.hasMoreShards; } /** * <p> * If set to <code>true</code>, more shards in the stream are available to describe. * </p> * * @param hasMoreShards * If set to <code>true</code>, more shards in the stream are available to describe. * @return Returns a reference to this object so that method calls can be chained together. */ public StreamDescription withHasMoreShards(Boolean hasMoreShards) { setHasMoreShards(hasMoreShards); return this; } /** * <p> * If set to <code>true</code>, more shards in the stream are available to describe. * </p> * * @return If set to <code>true</code>, more shards in the stream are available to describe. */ public Boolean isHasMoreShards() { return this.hasMoreShards; } /** * <p> * The current retention period, in hours. * </p> * * @param retentionPeriodHours * The current retention period, in hours. */ public void setRetentionPeriodHours(Integer retentionPeriodHours) { this.retentionPeriodHours = retentionPeriodHours; } /** * <p> * The current retention period, in hours. * </p> * * @return The current retention period, in hours. */ public Integer getRetentionPeriodHours() { return this.retentionPeriodHours; } /** * <p> * The current retention period, in hours. * </p> * * @param retentionPeriodHours * The current retention period, in hours. * @return Returns a reference to this object so that method calls can be chained together. */ public StreamDescription withRetentionPeriodHours(Integer retentionPeriodHours) { setRetentionPeriodHours(retentionPeriodHours); return this; } /** * <p> * The approximate time that the stream was created. * </p> * * @param streamCreationTimestamp * The approximate time that the stream was created. */ public void setStreamCreationTimestamp(java.util.Date streamCreationTimestamp) { this.streamCreationTimestamp = streamCreationTimestamp; } /** * <p> * The approximate time that the stream was created. * </p> * * @return The approximate time that the stream was created. */ public java.util.Date getStreamCreationTimestamp() { return this.streamCreationTimestamp; } /** * <p> * The approximate time that the stream was created. * </p> * * @param streamCreationTimestamp * The approximate time that the stream was created. * @return Returns a reference to this object so that method calls can be chained together. */ public StreamDescription withStreamCreationTimestamp(java.util.Date streamCreationTimestamp) { setStreamCreationTimestamp(streamCreationTimestamp); return this; } /** * <p> * Represents the current enhanced monitoring settings of the stream. * </p> * * @return Represents the current enhanced monitoring settings of the stream. */ public java.util.List<EnhancedMetrics> getEnhancedMonitoring() { if (enhancedMonitoring == null) { enhancedMonitoring = new com.amazonaws.internal.SdkInternalList<EnhancedMetrics>(); } return enhancedMonitoring; } /** * <p> * Represents the current enhanced monitoring settings of the stream. * </p> * * @param enhancedMonitoring * Represents the current enhanced monitoring settings of the stream. */ public void setEnhancedMonitoring(java.util.Collection<EnhancedMetrics> enhancedMonitoring) { if (enhancedMonitoring == null) { this.enhancedMonitoring = null; return; } this.enhancedMonitoring = new com.amazonaws.internal.SdkInternalList<EnhancedMetrics>(enhancedMonitoring); } /** * <p> * Represents the current enhanced monitoring settings of the stream. * </p> * <p> * <b>NOTE:</b> This method appends the values to the existing list (if any). Use * {@link #setEnhancedMonitoring(java.util.Collection)} or {@link #withEnhancedMonitoring(java.util.Collection)} if * you want to override the existing values. * </p> * * @param enhancedMonitoring * Represents the current enhanced monitoring settings of the stream. * @return Returns a reference to this object so that method calls can be chained together. */ public StreamDescription withEnhancedMonitoring(EnhancedMetrics... enhancedMonitoring) { if (this.enhancedMonitoring == null) { setEnhancedMonitoring(new com.amazonaws.internal.SdkInternalList<EnhancedMetrics>(enhancedMonitoring.length)); } for (EnhancedMetrics ele : enhancedMonitoring) { this.enhancedMonitoring.add(ele); } return this; } /** * <p> * Represents the current enhanced monitoring settings of the stream. * </p> * * @param enhancedMonitoring * Represents the current enhanced monitoring settings of the stream. * @return Returns a reference to this object so that method calls can be chained together. */ public StreamDescription withEnhancedMonitoring(java.util.Collection<EnhancedMetrics> enhancedMonitoring) { setEnhancedMonitoring(enhancedMonitoring); 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 (getStreamName() != null) sb.append("StreamName: ").append(getStreamName()).append(","); if (getStreamARN() != null) sb.append("StreamARN: ").append(getStreamARN()).append(","); if (getStreamStatus() != null) sb.append("StreamStatus: ").append(getStreamStatus()).append(","); if (getShards() != null) sb.append("Shards: ").append(getShards()).append(","); if (getHasMoreShards() != null) sb.append("HasMoreShards: ").append(getHasMoreShards()).append(","); if (getRetentionPeriodHours() != null) sb.append("RetentionPeriodHours: ").append(getRetentionPeriodHours()).append(","); if (getStreamCreationTimestamp() != null) sb.append("StreamCreationTimestamp: ").append(getStreamCreationTimestamp()).append(","); if (getEnhancedMonitoring() != null) sb.append("EnhancedMonitoring: ").append(getEnhancedMonitoring()); sb.append("}"); return sb.toString(); } @Override public boolean equals(Object obj) { if (this == obj) return true; if (obj == null) return false; if (obj instanceof StreamDescription == false) return false; StreamDescription other = (StreamDescription) obj; if (other.getStreamName() == null ^ this.getStreamName() == null) return false; if (other.getStreamName() != null && other.getStreamName().equals(this.getStreamName()) == false) return false; if (other.getStreamARN() == null ^ this.getStreamARN() == null) return false; if (other.getStreamARN() != null && other.getStreamARN().equals(this.getStreamARN()) == false) return false; if (other.getStreamStatus() == null ^ this.getStreamStatus() == null) return false; if (other.getStreamStatus() != null && other.getStreamStatus().equals(this.getStreamStatus()) == false) return false; if (other.getShards() == null ^ this.getShards() == null) return false; if (other.getShards() != null && other.getShards().equals(this.getShards()) == false) return false; if (other.getHasMoreShards() == null ^ this.getHasMoreShards() == null) return false; if (other.getHasMoreShards() != null && other.getHasMoreShards().equals(this.getHasMoreShards()) == false) return false; if (other.getRetentionPeriodHours() == null ^ this.getRetentionPeriodHours() == null) return false; if (other.getRetentionPeriodHours() != null && other.getRetentionPeriodHours().equals(this.getRetentionPeriodHours()) == false) return false; if (other.getStreamCreationTimestamp() == null ^ this.getStreamCreationTimestamp() == null) return false; if (other.getStreamCreationTimestamp() != null && other.getStreamCreationTimestamp().equals(this.getStreamCreationTimestamp()) == false) return false; if (other.getEnhancedMonitoring() == null ^ this.getEnhancedMonitoring() == null) return false; if (other.getEnhancedMonitoring() != null && other.getEnhancedMonitoring().equals(this.getEnhancedMonitoring()) == false) return false; return true; } @Override public int hashCode() { final int prime = 31; int hashCode = 1; hashCode = prime * hashCode + ((getStreamName() == null) ? 0 : getStreamName().hashCode()); hashCode = prime * hashCode + ((getStreamARN() == null) ? 0 : getStreamARN().hashCode()); hashCode = prime * hashCode + ((getStreamStatus() == null) ? 0 : getStreamStatus().hashCode()); hashCode = prime * hashCode + ((getShards() == null) ? 0 : getShards().hashCode()); hashCode = prime * hashCode + ((getHasMoreShards() == null) ? 0 : getHasMoreShards().hashCode()); hashCode = prime * hashCode + ((getRetentionPeriodHours() == null) ? 0 : getRetentionPeriodHours().hashCode()); hashCode = prime * hashCode + ((getStreamCreationTimestamp() == null) ? 0 : getStreamCreationTimestamp().hashCode()); hashCode = prime * hashCode + ((getEnhancedMonitoring() == null) ? 0 : getEnhancedMonitoring().hashCode()); return hashCode; } @Override public StreamDescription clone() { try { return (StreamDescription) super.clone(); } catch (CloneNotSupportedException e) { throw new IllegalStateException("Got a CloneNotSupportedException from Object.clone() " + "even though we're Cloneable!", e); } } @com.amazonaws.annotation.SdkInternalApi @Override public void marshall(ProtocolMarshaller protocolMarshaller) { com.amazonaws.services.kinesis.model.transform.StreamDescriptionMarshaller.getInstance().marshall(this, protocolMarshaller); } }