/* * Copyright 2010-2020 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.simpleemail.model; import java.io.Serializable; /** *

* Represents the destination of the message, consisting of To:, CC:, and BCC: * fields. *

* *

* Amazon SES does not support the SMTPUTF8 extension, as described in RFC6531. For this reason, the * local part of a destination email address (the part of the email * address that precedes the @ sign) may only contain 7-bit ASCII * characters. If the domain part of an address (the part after the @ * sign) contains non-ASCII characters, they must be encoded using Punycode, as * described in RFC3492. *

*
*/ public class Destination implements Serializable { /** *

* The recipients to place on the To: line of the message. *

*/ private java.util.List toAddresses = new java.util.ArrayList(); /** *

* The recipients to place on the CC: line of the message. *

*/ private java.util.List ccAddresses = new java.util.ArrayList(); /** *

* The recipients to place on the BCC: line of the message. *

*/ private java.util.List bccAddresses = new java.util.ArrayList(); /** * Default constructor for Destination object. Callers should use the setter * or fluent setter (with...) methods to initialize any additional object * members. */ public Destination() { } /** * Constructs a new Destination object. Callers should use the setter or * fluent setter (with...) methods to initialize any additional object * members. * * @param toAddresses

* The recipients to place on the To: line of the message. *

*/ public Destination(java.util.List toAddresses) { setToAddresses(toAddresses); } /** *

* The recipients to place on the To: line of the message. *

* * @return

* The recipients to place on the To: line of the message. *

*/ public java.util.List getToAddresses() { return toAddresses; } /** *

* The recipients to place on the To: line of the message. *

* * @param toAddresses

* The recipients to place on the To: line of the message. *

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

* The recipients to place on the To: line of the message. *

*

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

* The recipients to place on the To: line of the message. *

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

* The recipients to place on the To: line of the message. *

*

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

* The recipients to place on the To: line of the message. *

* @return A reference to this updated object so that method calls can be * chained together. */ public Destination withToAddresses(java.util.Collection toAddresses) { setToAddresses(toAddresses); return this; } /** *

* The recipients to place on the CC: line of the message. *

* * @return

* The recipients to place on the CC: line of the message. *

*/ public java.util.List getCcAddresses() { return ccAddresses; } /** *

* The recipients to place on the CC: line of the message. *

* * @param ccAddresses

* The recipients to place on the CC: line of the message. *

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

* The recipients to place on the CC: line of the message. *

*

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

* The recipients to place on the CC: line of the message. *

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

* The recipients to place on the CC: line of the message. *

*

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

* The recipients to place on the CC: line of the message. *

* @return A reference to this updated object so that method calls can be * chained together. */ public Destination withCcAddresses(java.util.Collection ccAddresses) { setCcAddresses(ccAddresses); return this; } /** *

* The recipients to place on the BCC: line of the message. *

* * @return

* The recipients to place on the BCC: line of the message. *

*/ public java.util.List getBccAddresses() { return bccAddresses; } /** *

* The recipients to place on the BCC: line of the message. *

* * @param bccAddresses

* The recipients to place on the BCC: line of the message. *

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

* The recipients to place on the BCC: line of the message. *

*

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

* The recipients to place on the BCC: line of the message. *

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

* The recipients to place on the BCC: line of the message. *

*

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

* The recipients to place on the BCC: line of the message. *

* @return A reference to this updated object so that method calls can be * chained together. */ public Destination withBccAddresses(java.util.Collection bccAddresses) { setBccAddresses(bccAddresses); 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 (getToAddresses() != null) sb.append("ToAddresses: " + getToAddresses() + ","); if (getCcAddresses() != null) sb.append("CcAddresses: " + getCcAddresses() + ","); if (getBccAddresses() != null) sb.append("BccAddresses: " + getBccAddresses()); sb.append("}"); return sb.toString(); } @Override public int hashCode() { final int prime = 31; int hashCode = 1; hashCode = prime * hashCode + ((getToAddresses() == null) ? 0 : getToAddresses().hashCode()); hashCode = prime * hashCode + ((getCcAddresses() == null) ? 0 : getCcAddresses().hashCode()); hashCode = prime * hashCode + ((getBccAddresses() == null) ? 0 : getBccAddresses().hashCode()); return hashCode; } @Override public boolean equals(Object obj) { if (this == obj) return true; if (obj == null) return false; if (obj instanceof Destination == false) return false; Destination other = (Destination) obj; if (other.getToAddresses() == null ^ this.getToAddresses() == null) return false; if (other.getToAddresses() != null && other.getToAddresses().equals(this.getToAddresses()) == false) return false; if (other.getCcAddresses() == null ^ this.getCcAddresses() == null) return false; if (other.getCcAddresses() != null && other.getCcAddresses().equals(this.getCcAddresses()) == false) return false; if (other.getBccAddresses() == null ^ this.getBccAddresses() == null) return false; if (other.getBccAddresses() != null && other.getBccAddresses().equals(this.getBccAddresses()) == false) return false; return true; } }