/*
* Copyright 2010 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;
import java.net.URI;
import java.util.Map;
/**
* Represents a request being sent to an Amazon Web Service, including the
* parameters being sent as part of the request, the endpoint to which the
* request should be sent, etc.
* <p>
* This class is only intended for internal use inside the AWS client libraries.
* Callers shouldn't ever interact directly with objects of this class.
*
* @param <T>
* The type of original, user facing request represented by this
* request.
*/
public interface Request<T> {
/**
* Adds the specified header to this request.
*
* @param name
* The name of the header to add.
* @param value
* The header's value.
*/
public void addHeader(String name, String value);
/**
* Returns a map of all the headers included in this request.
*
* @return A map of all the headers included in this request.
*/
public Map<String, String> getHeaders();
/**
* Sets the path to the resource being requested.
*
* @param path
* The path to the resource being requested.
*/
public void setResourcePath(String path);
/**
* Returns the path to the resource being requested.
*
* @return The path to the resource being requested.
*/
public String getResourcePath();
/**
* Adds the specified request parameter to this request.
*
* @param name
* The name of the request parameter.
* @param value
* The value of the request parameter.
*/
public void addParameter(String name, String value);
/**
* Adds the specified request parameter to this request, and returns the
* updated request object.
*
* @param name
* The name of the request parameter.
* @param value
* The value of the request parameter.
*
* @return The updated request object.
*/
public Request<T> withParameter(String name, String value);
/**
* Returns a map of all parameters in this request.
*
* @return A map of all parameters in this request.
*/
public Map<String, String> getParameters();
/**
* Returns the service endpoint (ex: "https://ec2.amazonaws.com") to which
* this request should be sent.
*
* @return The service endpoint to which this request should be sent.
*/
public URI getEndpoint();
/**
* Sets the service endpoint (ex: "https://ec2.amazonaws.com") to which this
* request should be sent.
*
* @param endpoint
* The service endpoint to which this request should be sent.
*/
public void setEndpoint(URI endpoint);
/**
* Returns the name of the Amazon service this request is for.
*
* @return The name of the Amazon service this request is for.
*/
public String getServiceName();
/**
* Returns the original, user facing request object which this internal
* request object is representing.
*
* @return The original, user facing request object which this request
* object is representing.
*/
public AmazonWebServiceRequest getOriginalRequest();
}