com.amazonaws.services.elasticmapreduce.model.Application Maven / Gradle / Ivy
Show all versions of aws-java-sdk-osgi Show documentation
/*
 * Copyright 2010-2016 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.elasticmapreduce.model;
import java.io.Serializable;
/**
 * 
 * An application is any Amazon or third-party software that you can add to the
 * cluster. This structure contains a list of strings that indicates the
 * software to use with the cluster and accepts a user argument list. Amazon EMR
 * accepts and forwards the argument list to the corresponding installation
 * script as bootstrap action argument. For more information, see Launch a Job Flow on the MapR Distribution for Hadoop. Currently
 * supported values are:
 * 
 * 
 * - "mapr-m3" - launch the job flow using MapR M3 Edition.
 
 * - "mapr-m5" - launch the job flow using MapR M5 Edition.
 
 * - "mapr" with the user arguments specifying "--edition,m3" or
 * "--edition,m5" - launch the job flow using MapR M3 or M5 Edition,
 * respectively.
 
 * 
 * 
 * 
 * In Amazon EMR releases 4.0 and greater, the only accepted parameter is the
 * application name. To pass arguments to applications, you supply a
 * configuration for each application.
 * 
 *  
 */
public class Application implements Serializable, Cloneable {
    /**
     * 
     * The name of the application.
     * 
     */
    private String name;
    /**
     * 
     * The version of the application.
     * 
     */
    private String version;
    /**
     * 
     * Arguments for Amazon EMR to pass to the application.
     * 
     */
    private com.amazonaws.internal.SdkInternalList args;
    /**
     * 
     * This option is for advanced users only. This is meta information about
     * third-party applications that third-party vendors use for testing
     * purposes.
     * 
     */
    private com.amazonaws.internal.SdkInternalMap additionalInfo;
    /**
     * 
     * The name of the application.
     * 
     * 
     * @param name
     *        The name of the application.
     */
    public void setName(String name) {
        this.name = name;
    }
    /**
     * 
     * The name of the application.
     * 
     * 
     * @return The name of the application.
     */
    public String getName() {
        return this.name;
    }
    /**
     * 
     * The name of the application.
     * 
     * 
     * @param name
     *        The name of the application.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */
    public Application withName(String name) {
        setName(name);
        return this;
    }
    /**
     * 
     * The version of the application.
     * 
     * 
     * @param version
     *        The version of the application.
     */
    public void setVersion(String version) {
        this.version = version;
    }
    /**
     * 
     * The version of the application.
     * 
     * 
     * @return The version of the application.
     */
    public String getVersion() {
        return this.version;
    }
    /**
     * 
     * The version of the application.
     * 
     * 
     * @param version
     *        The version of the application.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */
    public Application withVersion(String version) {
        setVersion(version);
        return this;
    }
    /**
     * 
     * Arguments for Amazon EMR to pass to the application.
     * 
     * 
     * @return Arguments for Amazon EMR to pass to the application.
     */
    public java.util.List getArgs() {
        if (args == null) {
            args = new com.amazonaws.internal.SdkInternalList();
        }
        return args;
    }
    /**
     * 
     * Arguments for Amazon EMR to pass to the application.
     * 
     * 
     * @param args
     *        Arguments for Amazon EMR to pass to the application.
     */
    public void setArgs(java.util.Collection args) {
        if (args == null) {
            this.args = null;
            return;
        }
        this.args = new com.amazonaws.internal.SdkInternalList(args);
    }
    /**
     * 
     * Arguments for Amazon EMR to pass to the application.
     * 
     * 
     * NOTE: This method appends the values to the existing list (if
     * any). Use {@link #setArgs(java.util.Collection)} or
     * {@link #withArgs(java.util.Collection)} if you want to override the
     * existing values.
     * 
     * 
     * @param args
     *        Arguments for Amazon EMR to pass to the application.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */
    public Application withArgs(String... args) {
        if (this.args == null) {
            setArgs(new com.amazonaws.internal.SdkInternalList(
                    args.length));
        }
        for (String ele : args) {
            this.args.add(ele);
        }
        return this;
    }
    /**
     * 
     * Arguments for Amazon EMR to pass to the application.
     * 
     * 
     * @param args
     *        Arguments for Amazon EMR to pass to the application.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */
    public Application withArgs(java.util.Collection args) {
        setArgs(args);
        return this;
    }
    /**
     * 
     * This option is for advanced users only. This is meta information about
     * third-party applications that third-party vendors use for testing
     * purposes.
     * 
     * 
     * @return This option is for advanced users only. This is meta information
     *         about third-party applications that third-party vendors use for
     *         testing purposes.
     */
    public java.util.Map getAdditionalInfo() {
        if (additionalInfo == null) {
            additionalInfo = new com.amazonaws.internal.SdkInternalMap();
        }
        return additionalInfo;
    }
    /**
     * 
     * This option is for advanced users only. This is meta information about
     * third-party applications that third-party vendors use for testing
     * purposes.
     * 
     * 
     * @param additionalInfo
     *        This option is for advanced users only. This is meta information
     *        about third-party applications that third-party vendors use for
     *        testing purposes.
     */
    public void setAdditionalInfo(java.util.Map additionalInfo) {
        this.additionalInfo = additionalInfo == null ? null
                : new com.amazonaws.internal.SdkInternalMap(
                        additionalInfo);
    }
    /**
     * 
     * This option is for advanced users only. This is meta information about
     * third-party applications that third-party vendors use for testing
     * purposes.
     * 
     * 
     * @param additionalInfo
     *        This option is for advanced users only. This is meta information
     *        about third-party applications that third-party vendors use for
     *        testing purposes.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */
    public Application withAdditionalInfo(
            java.util.Map additionalInfo) {
        setAdditionalInfo(additionalInfo);
        return this;
    }
    public Application addAdditionalInfoEntry(String key, String value) {
        if (null == this.additionalInfo) {
            this.additionalInfo = new com.amazonaws.internal.SdkInternalMap();
        }
        if (this.additionalInfo.containsKey(key))
            throw new IllegalArgumentException("Duplicated keys ("
                    + key.toString() + ") are provided.");
        this.additionalInfo.put(key, value);
        return this;
    }
    /**
     * Removes all the entries added into AdditionalInfo. <p> Returns a
     * reference to this object so that method calls can be chained together.
     */
    public Application clearAdditionalInfoEntries() {
        this.additionalInfo = null;
        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 (getName() != null)
            sb.append("Name: " + getName() + ",");
        if (getVersion() != null)
            sb.append("Version: " + getVersion() + ",");
        if (getArgs() != null)
            sb.append("Args: " + getArgs() + ",");
        if (getAdditionalInfo() != null)
            sb.append("AdditionalInfo: " + getAdditionalInfo());
        sb.append("}");
        return sb.toString();
    }
    @Override
    public boolean equals(Object obj) {
        if (this == obj)
            return true;
        if (obj == null)
            return false;
        if (obj instanceof Application == false)
            return false;
        Application other = (Application) obj;
        if (other.getName() == null ^ this.getName() == null)
            return false;
        if (other.getName() != null
                && other.getName().equals(this.getName()) == false)
            return false;
        if (other.getVersion() == null ^ this.getVersion() == null)
            return false;
        if (other.getVersion() != null
                && other.getVersion().equals(this.getVersion()) == false)
            return false;
        if (other.getArgs() == null ^ this.getArgs() == null)
            return false;
        if (other.getArgs() != null
                && other.getArgs().equals(this.getArgs()) == false)
            return false;
        if (other.getAdditionalInfo() == null
                ^ this.getAdditionalInfo() == null)
            return false;
        if (other.getAdditionalInfo() != null
                && other.getAdditionalInfo().equals(this.getAdditionalInfo()) == false)
            return false;
        return true;
    }
    @Override
    public int hashCode() {
        final int prime = 31;
        int hashCode = 1;
        hashCode = prime * hashCode
                + ((getName() == null) ? 0 : getName().hashCode());
        hashCode = prime * hashCode
                + ((getVersion() == null) ? 0 : getVersion().hashCode());
        hashCode = prime * hashCode
                + ((getArgs() == null) ? 0 : getArgs().hashCode());
        hashCode = prime
                * hashCode
                + ((getAdditionalInfo() == null) ? 0 : getAdditionalInfo()
                        .hashCode());
        return hashCode;
    }
    @Override
    public Application clone() {
        try {
            return (Application) super.clone();
        } catch (CloneNotSupportedException e) {
            throw new IllegalStateException(
                    "Got a CloneNotSupportedException from Object.clone() "
                            + "even though we're Cloneable!", e);
        }
    }
}