/*
 * Copyright 2018-2023 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.apigateway.model;

import java.io.Serializable;
import javax.annotation.Generated;

import com.amazonaws.AmazonWebServiceRequest;

/**
 * <p>
 * A POST request to import an API to API Gateway using an input of an API definition file.
 * </p>
 */
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public class ImportRestApiRequest extends com.amazonaws.AmazonWebServiceRequest implements Serializable, Cloneable {

    /**
     * <p>
     * A query parameter to indicate whether to rollback the API creation (<code>true</code>) or not (<code>false</code>
     * ) when a warning is encountered. The default value is <code>false</code>.
     * </p>
     */
    private Boolean failOnWarnings;
    /**
     * <p>
     * A key-value map of context-specific query string parameters specifying the behavior of different API importing
     * operations. The following shows operation-specific parameters and their supported values.
     * </p>
     * <p>
     * To exclude DocumentationParts from the import, set <code>parameters</code> as <code>ignore=documentation</code>.
     * </p>
     * <p>
     * To configure the endpoint type, set <code>parameters</code> as <code>endpointConfigurationTypes=EDGE</code>,
     * <code>endpointConfigurationTypes=REGIONAL</code>, or <code>endpointConfigurationTypes=PRIVATE</code>. The default
     * endpoint type is <code>EDGE</code>.
     * </p>
     * <p>
     * To handle imported <code>basepath</code>, set <code>parameters</code> as <code>basepath=ignore</code>,
     * <code>basepath=prepend</code> or <code>basepath=split</code>.
     * </p>
     * <p>
     * For example, the AWS CLI command to exclude documentation from the imported API is:
     * </p>
     * <p>
     * The AWS CLI command to set the regional endpoint on the imported API is:
     * </p>
     */
    private java.util.Map<String, String> parameters;
    /**
     * <p>
     * The POST request body containing external API definitions. Currently, only OpenAPI definition JSON/YAML files are
     * supported. The maximum size of the API definition file is 6MB.
     * </p>
     */
    private java.nio.ByteBuffer body;

    /**
     * <p>
     * A query parameter to indicate whether to rollback the API creation (<code>true</code>) or not (<code>false</code>
     * ) when a warning is encountered. The default value is <code>false</code>.
     * </p>
     * 
     * @param failOnWarnings
     *        A query parameter to indicate whether to rollback the API creation (<code>true</code>) or not (
     *        <code>false</code>) when a warning is encountered. The default value is <code>false</code>.
     */

    public void setFailOnWarnings(Boolean failOnWarnings) {
        this.failOnWarnings = failOnWarnings;
    }

    /**
     * <p>
     * A query parameter to indicate whether to rollback the API creation (<code>true</code>) or not (<code>false</code>
     * ) when a warning is encountered. The default value is <code>false</code>.
     * </p>
     * 
     * @return A query parameter to indicate whether to rollback the API creation (<code>true</code>) or not (
     *         <code>false</code>) when a warning is encountered. The default value is <code>false</code>.
     */

    public Boolean getFailOnWarnings() {
        return this.failOnWarnings;
    }

    /**
     * <p>
     * A query parameter to indicate whether to rollback the API creation (<code>true</code>) or not (<code>false</code>
     * ) when a warning is encountered. The default value is <code>false</code>.
     * </p>
     * 
     * @param failOnWarnings
     *        A query parameter to indicate whether to rollback the API creation (<code>true</code>) or not (
     *        <code>false</code>) when a warning is encountered. The default value is <code>false</code>.
     * @return Returns a reference to this object so that method calls can be chained together.
     */

    public ImportRestApiRequest withFailOnWarnings(Boolean failOnWarnings) {
        setFailOnWarnings(failOnWarnings);
        return this;
    }

    /**
     * <p>
     * A query parameter to indicate whether to rollback the API creation (<code>true</code>) or not (<code>false</code>
     * ) when a warning is encountered. The default value is <code>false</code>.
     * </p>
     * 
     * @return A query parameter to indicate whether to rollback the API creation (<code>true</code>) or not (
     *         <code>false</code>) when a warning is encountered. The default value is <code>false</code>.
     */

    public Boolean isFailOnWarnings() {
        return this.failOnWarnings;
    }

    /**
     * <p>
     * A key-value map of context-specific query string parameters specifying the behavior of different API importing
     * operations. The following shows operation-specific parameters and their supported values.
     * </p>
     * <p>
     * To exclude DocumentationParts from the import, set <code>parameters</code> as <code>ignore=documentation</code>.
     * </p>
     * <p>
     * To configure the endpoint type, set <code>parameters</code> as <code>endpointConfigurationTypes=EDGE</code>,
     * <code>endpointConfigurationTypes=REGIONAL</code>, or <code>endpointConfigurationTypes=PRIVATE</code>. The default
     * endpoint type is <code>EDGE</code>.
     * </p>
     * <p>
     * To handle imported <code>basepath</code>, set <code>parameters</code> as <code>basepath=ignore</code>,
     * <code>basepath=prepend</code> or <code>basepath=split</code>.
     * </p>
     * <p>
     * For example, the AWS CLI command to exclude documentation from the imported API is:
     * </p>
     * <p>
     * The AWS CLI command to set the regional endpoint on the imported API is:
     * </p>
     * 
     * @return A key-value map of context-specific query string parameters specifying the behavior of different API
     *         importing operations. The following shows operation-specific parameters and their supported values.</p>
     *         <p>
     *         To exclude DocumentationParts from the import, set <code>parameters</code> as
     *         <code>ignore=documentation</code>.
     *         </p>
     *         <p>
     *         To configure the endpoint type, set <code>parameters</code> as
     *         <code>endpointConfigurationTypes=EDGE</code>, <code>endpointConfigurationTypes=REGIONAL</code>, or
     *         <code>endpointConfigurationTypes=PRIVATE</code>. The default endpoint type is <code>EDGE</code>.
     *         </p>
     *         <p>
     *         To handle imported <code>basepath</code>, set <code>parameters</code> as <code>basepath=ignore</code>,
     *         <code>basepath=prepend</code> or <code>basepath=split</code>.
     *         </p>
     *         <p>
     *         For example, the AWS CLI command to exclude documentation from the imported API is:
     *         </p>
     *         <p>
     *         The AWS CLI command to set the regional endpoint on the imported API is:
     */

    public java.util.Map<String, String> getParameters() {
        return parameters;
    }

    /**
     * <p>
     * A key-value map of context-specific query string parameters specifying the behavior of different API importing
     * operations. The following shows operation-specific parameters and their supported values.
     * </p>
     * <p>
     * To exclude DocumentationParts from the import, set <code>parameters</code> as <code>ignore=documentation</code>.
     * </p>
     * <p>
     * To configure the endpoint type, set <code>parameters</code> as <code>endpointConfigurationTypes=EDGE</code>,
     * <code>endpointConfigurationTypes=REGIONAL</code>, or <code>endpointConfigurationTypes=PRIVATE</code>. The default
     * endpoint type is <code>EDGE</code>.
     * </p>
     * <p>
     * To handle imported <code>basepath</code>, set <code>parameters</code> as <code>basepath=ignore</code>,
     * <code>basepath=prepend</code> or <code>basepath=split</code>.
     * </p>
     * <p>
     * For example, the AWS CLI command to exclude documentation from the imported API is:
     * </p>
     * <p>
     * The AWS CLI command to set the regional endpoint on the imported API is:
     * </p>
     * 
     * @param parameters
     *        A key-value map of context-specific query string parameters specifying the behavior of different API
     *        importing operations. The following shows operation-specific parameters and their supported values.</p>
     *        <p>
     *        To exclude DocumentationParts from the import, set <code>parameters</code> as
     *        <code>ignore=documentation</code>.
     *        </p>
     *        <p>
     *        To configure the endpoint type, set <code>parameters</code> as
     *        <code>endpointConfigurationTypes=EDGE</code>, <code>endpointConfigurationTypes=REGIONAL</code>, or
     *        <code>endpointConfigurationTypes=PRIVATE</code>. The default endpoint type is <code>EDGE</code>.
     *        </p>
     *        <p>
     *        To handle imported <code>basepath</code>, set <code>parameters</code> as <code>basepath=ignore</code>,
     *        <code>basepath=prepend</code> or <code>basepath=split</code>.
     *        </p>
     *        <p>
     *        For example, the AWS CLI command to exclude documentation from the imported API is:
     *        </p>
     *        <p>
     *        The AWS CLI command to set the regional endpoint on the imported API is:
     */

    public void setParameters(java.util.Map<String, String> parameters) {
        this.parameters = parameters;
    }

    /**
     * <p>
     * A key-value map of context-specific query string parameters specifying the behavior of different API importing
     * operations. The following shows operation-specific parameters and their supported values.
     * </p>
     * <p>
     * To exclude DocumentationParts from the import, set <code>parameters</code> as <code>ignore=documentation</code>.
     * </p>
     * <p>
     * To configure the endpoint type, set <code>parameters</code> as <code>endpointConfigurationTypes=EDGE</code>,
     * <code>endpointConfigurationTypes=REGIONAL</code>, or <code>endpointConfigurationTypes=PRIVATE</code>. The default
     * endpoint type is <code>EDGE</code>.
     * </p>
     * <p>
     * To handle imported <code>basepath</code>, set <code>parameters</code> as <code>basepath=ignore</code>,
     * <code>basepath=prepend</code> or <code>basepath=split</code>.
     * </p>
     * <p>
     * For example, the AWS CLI command to exclude documentation from the imported API is:
     * </p>
     * <p>
     * The AWS CLI command to set the regional endpoint on the imported API is:
     * </p>
     * 
     * @param parameters
     *        A key-value map of context-specific query string parameters specifying the behavior of different API
     *        importing operations. The following shows operation-specific parameters and their supported values.</p>
     *        <p>
     *        To exclude DocumentationParts from the import, set <code>parameters</code> as
     *        <code>ignore=documentation</code>.
     *        </p>
     *        <p>
     *        To configure the endpoint type, set <code>parameters</code> as
     *        <code>endpointConfigurationTypes=EDGE</code>, <code>endpointConfigurationTypes=REGIONAL</code>, or
     *        <code>endpointConfigurationTypes=PRIVATE</code>. The default endpoint type is <code>EDGE</code>.
     *        </p>
     *        <p>
     *        To handle imported <code>basepath</code>, set <code>parameters</code> as <code>basepath=ignore</code>,
     *        <code>basepath=prepend</code> or <code>basepath=split</code>.
     *        </p>
     *        <p>
     *        For example, the AWS CLI command to exclude documentation from the imported API is:
     *        </p>
     *        <p>
     *        The AWS CLI command to set the regional endpoint on the imported API is:
     * @return Returns a reference to this object so that method calls can be chained together.
     */

    public ImportRestApiRequest withParameters(java.util.Map<String, String> parameters) {
        setParameters(parameters);
        return this;
    }

    /**
     * Add a single Parameters entry
     *
     * @see ImportRestApiRequest#withParameters
     * @returns a reference to this object so that method calls can be chained together.
     */

    public ImportRestApiRequest addParametersEntry(String key, String value) {
        if (null == this.parameters) {
            this.parameters = new java.util.HashMap<String, String>();
        }
        if (this.parameters.containsKey(key))
            throw new IllegalArgumentException("Duplicated keys (" + key.toString() + ") are provided.");
        this.parameters.put(key, value);
        return this;
    }

    /**
     * Removes all the entries added into Parameters.
     *
     * @return Returns a reference to this object so that method calls can be chained together.
     */

    public ImportRestApiRequest clearParametersEntries() {
        this.parameters = null;
        return this;
    }

    /**
     * <p>
     * The POST request body containing external API definitions. Currently, only OpenAPI definition JSON/YAML files are
     * supported. The maximum size of the API definition file is 6MB.
     * </p>
     * <p>
     * The AWS SDK for Java performs a Base64 encoding on this field before sending this request to the AWS service.
     * Users of the SDK should not perform Base64 encoding on this field.
     * </p>
     * <p>
     * Warning: ByteBuffers returned by the SDK are mutable. Changes to the content or position of the byte buffer will
     * be seen by all objects that have a reference to this object. It is recommended to call ByteBuffer.duplicate() or
     * ByteBuffer.asReadOnlyBuffer() before using or reading from the buffer. This behavior will be changed in a future
     * major version of the SDK.
     * </p>
     * 
     * @param body
     *        The POST request body containing external API definitions. Currently, only OpenAPI definition JSON/YAML
     *        files are supported. The maximum size of the API definition file is 6MB.
     */

    public void setBody(java.nio.ByteBuffer body) {
        this.body = body;
    }

    /**
     * <p>
     * The POST request body containing external API definitions. Currently, only OpenAPI definition JSON/YAML files are
     * supported. The maximum size of the API definition file is 6MB.
     * </p>
     * <p>
     * {@code ByteBuffer}s are stateful. Calling their {@code get} methods changes their {@code position}. We recommend
     * using {@link java.nio.ByteBuffer#asReadOnlyBuffer()} to create a read-only view of the buffer with an independent
     * {@code position}, and calling {@code get} methods on this rather than directly on the returned {@code ByteBuffer}.
     * Doing so will ensure that anyone else using the {@code ByteBuffer} will not be affected by changes to the
     * {@code position}.
     * </p>
     * 
     * @return The POST request body containing external API definitions. Currently, only OpenAPI definition JSON/YAML
     *         files are supported. The maximum size of the API definition file is 6MB.
     */

    public java.nio.ByteBuffer getBody() {
        return this.body;
    }

    /**
     * <p>
     * The POST request body containing external API definitions. Currently, only OpenAPI definition JSON/YAML files are
     * supported. The maximum size of the API definition file is 6MB.
     * </p>
     * <p>
     * The AWS SDK for Java performs a Base64 encoding on this field before sending this request to the AWS service.
     * Users of the SDK should not perform Base64 encoding on this field.
     * </p>
     * <p>
     * Warning: ByteBuffers returned by the SDK are mutable. Changes to the content or position of the byte buffer will
     * be seen by all objects that have a reference to this object. It is recommended to call ByteBuffer.duplicate() or
     * ByteBuffer.asReadOnlyBuffer() before using or reading from the buffer. This behavior will be changed in a future
     * major version of the SDK.
     * </p>
     * 
     * @param body
     *        The POST request body containing external API definitions. Currently, only OpenAPI definition JSON/YAML
     *        files are supported. The maximum size of the API definition file is 6MB.
     * @return Returns a reference to this object so that method calls can be chained together.
     */

    public ImportRestApiRequest withBody(java.nio.ByteBuffer body) {
        setBody(body);
        return this;
    }

    /**
     * Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be
     * redacted from this string using a placeholder value.
     *
     * @return A string representation of this object.
     *
     * @see java.lang.Object#toString()
     */
    @Override
    public String toString() {
        StringBuilder sb = new StringBuilder();
        sb.append("{");
        if (getFailOnWarnings() != null)
            sb.append("FailOnWarnings: ").append(getFailOnWarnings()).append(",");
        if (getParameters() != null)
            sb.append("Parameters: ").append(getParameters()).append(",");
        if (getBody() != null)
            sb.append("Body: ").append(getBody());
        sb.append("}");
        return sb.toString();
    }

    @Override
    public boolean equals(Object obj) {
        if (this == obj)
            return true;
        if (obj == null)
            return false;

        if (obj instanceof ImportRestApiRequest == false)
            return false;
        ImportRestApiRequest other = (ImportRestApiRequest) obj;
        if (other.getFailOnWarnings() == null ^ this.getFailOnWarnings() == null)
            return false;
        if (other.getFailOnWarnings() != null && other.getFailOnWarnings().equals(this.getFailOnWarnings()) == false)
            return false;
        if (other.getParameters() == null ^ this.getParameters() == null)
            return false;
        if (other.getParameters() != null && other.getParameters().equals(this.getParameters()) == false)
            return false;
        if (other.getBody() == null ^ this.getBody() == null)
            return false;
        if (other.getBody() != null && other.getBody().equals(this.getBody()) == false)
            return false;
        return true;
    }

    @Override
    public int hashCode() {
        final int prime = 31;
        int hashCode = 1;

        hashCode = prime * hashCode + ((getFailOnWarnings() == null) ? 0 : getFailOnWarnings().hashCode());
        hashCode = prime * hashCode + ((getParameters() == null) ? 0 : getParameters().hashCode());
        hashCode = prime * hashCode + ((getBody() == null) ? 0 : getBody().hashCode());
        return hashCode;
    }

    @Override
    public ImportRestApiRequest clone() {
        return (ImportRestApiRequest) super.clone();
    }

}