Request (AWS SDK for Java - Core 1.9.3 API)

Type Parameters:
T - The type of original, user facing request represented by this request.

All Known Implementing Classes:

DefaultRequest
```
public interface Request<T>
```
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.
This class is only intended for internal use inside the AWS client libraries. Callers shouldn't ever interact directly with objects of this class.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addHeader(String name, String value)` Sets the specified header for this request.
`void`	`addParameter(String name, String value)` Adds the specified request parameter to this request.
`AWSRequestMetrics`	`getAWSRequestMetrics()` Returns the request metrics.
`InputStream`	`getContent()` Returns the optional stream containing the payload data to include for this request.
`URI`	`getEndpoint()` Returns the service endpoint (ex: "https://ec2.amazonaws.com") to which this request should be sent.
`Map<String,String>`	`getHeaders()` Returns a map of all the headers included in this request.
`HttpMethodName`	`getHttpMethod()` Returns the HTTP method (GET, POST, etc) to use when sending this request.
`AmazonWebServiceRequest`	`getOriginalRequest()` Returns the original, user facing request object which this internal request object is representing.
`Map<String,String>`	`getParameters()` Returns a map of all parameters in this request.
`String`	`getResourcePath()` Returns the path to the resource being requested.
`String`	`getServiceName()` Returns the name of the Amazon service this request is for.
`int`	`getTimeOffset()` Returns the optional value for time offset for this request.
`void`	`setAWSRequestMetrics(AWSRequestMetrics metrics)` Bind the request metrics to the request.
`void`	`setContent(InputStream content)` Sets the optional stream containing the payload data to include for this request.
`void`	`setEndpoint(URI endpoint)` Sets the service endpoint (ex: "https://ec2.amazonaws.com") to which this request should be sent.
`void`	`setHeaders(Map<String,String> headers)` Sets all headers, clearing any existing ones.
`void`	`setHttpMethod(HttpMethodName httpMethod)` Sets the HTTP method (GET, POST, etc) to use when sending this request.
`void`	`setParameters(Map<String,String> parameters)` Sets all parameters, clearing any existing values.
`void`	`setResourcePath(String path)` Sets the path to the resource being requested.
`void`	`setTimeOffset(int timeOffset)` Sets the optional value for time offset for this request.
`Request<T>`	`withParameter(String name, String value)` Adds the specified request parameter to this request, and returns the updated request object.
`Request<T>`	`withTimeOffset(int timeOffset)` Sets the optional value for time offset for this request.

- Method Detail
  - addHeader
```
void addHeader(String name,
             String value)
```
    Sets the specified header for this request.
    
    Parameters:
    name - The name of the header to set.
    value - The header's value.
  - getHeaders
```
Map<String,String> getHeaders()
```
    Returns a map of all the headers included in this request.
    
    Returns:
    A map of all the headers included in this request.
  - setHeaders
```
void setHeaders(Map<String,String> headers)
```
    Sets all headers, clearing any existing ones.
  - setResourcePath
```
void setResourcePath(String path)
```
    Sets the path to the resource being requested.
    
    Parameters:
    path - The path to the resource being requested.
  - getResourcePath
```
String getResourcePath()
```
    Returns the path to the resource being requested.
    
    Returns:
    The path to the resource being requested.
  - addParameter
```
void addParameter(String name,
                String value)
```
    Adds the specified request parameter to this request.
    
    Parameters:
    name - The name of the request parameter.
    value - The value of the request parameter.
  - withParameter
```
Request<T> withParameter(String name,
                       String value)
```
    Adds the specified request parameter to this request, and returns the updated request object.
    
    Parameters:
    name - The name of the request parameter.
    value - The value of the request parameter.
    
    Returns:
    The updated request object.
  - getParameters
```
Map<String,String> getParameters()
```
    Returns a map of all parameters in this request.
    
    Returns:
    A map of all parameters in this request.
  - setParameters
```
void setParameters(Map<String,String> parameters)
```
    Sets all parameters, clearing any existing values.
  - getEndpoint
```
URI getEndpoint()
```
    Returns the service endpoint (ex: "https://ec2.amazonaws.com") to which this request should be sent.
    
    Returns:
    The service endpoint to which this request should be sent.
  - setEndpoint
```
void setEndpoint(URI endpoint)
```
    Sets the service endpoint (ex: "https://ec2.amazonaws.com") to which this request should be sent.
    
    Parameters:
    endpoint - The service endpoint to which this request should be sent.
  - getHttpMethod
```
HttpMethodName getHttpMethod()
```
    Returns the HTTP method (GET, POST, etc) to use when sending this request.
    
    Returns:
    The HTTP method to use when sending this request.
  - setHttpMethod
```
void setHttpMethod(HttpMethodName httpMethod)
```
    Sets the HTTP method (GET, POST, etc) to use when sending this request.
    
    Parameters:
    httpMethod - The HTTP method to use when sending this request.
  - getContent
```
InputStream getContent()
```
    Returns the optional stream containing the payload data to include for this request. Not all requests will contain payload data.
    
    Returns:
    The optional stream containing the payload data to include for this request.
  - setContent
```
void setContent(InputStream content)
```
    Sets the optional stream containing the payload data to include for this request. Not all requests will contain payload data.
    
    Parameters:
    content - The optional stream containing the payload data to include for this request.
  - getServiceName
```
String getServiceName()
```
    Returns the name of the Amazon service this request is for.
    
    Returns:
    The name of the Amazon service this request is for.
  - getOriginalRequest
```
AmazonWebServiceRequest getOriginalRequest()
```
    Returns the original, user facing request object which this internal request object is representing.
    
    Returns:
    The original, user facing request object which this request object is representing.
  - getTimeOffset
```
int getTimeOffset()
```
    Returns the optional value for time offset for this request. This will be used by the signer to adjust for potential clock skew. Value is in seconds, positive values imply the current clock is "fast", negative values imply clock is slow.
    
    Returns:
    The optional value for time offset (in seconds) for this request.
  - setTimeOffset
```
void setTimeOffset(int timeOffset)
```
    Sets the optional value for time offset for this request. This will be used by the signer to adjust for potential clock skew. Value is in seconds, positive values imply the current clock is "fast", negative values imply clock is slow.
    
    Parameters:
    timeOffset - The optional value for time offset (in seconds) for this request.
  - withTimeOffset
```
Request<T> withTimeOffset(int timeOffset)
```
    Sets the optional value for time offset for this request. This will be used by the signer to adjust for potential clock skew. Value is in seconds, positive values imply the current clock is "fast", negative values imply clock is slow.
    
    Returns:
    The updated request object.
  - getAWSRequestMetrics
```
AWSRequestMetrics getAWSRequestMetrics()
```
    Returns the request metrics.
  - setAWSRequestMetrics
```
void setAWSRequestMetrics(AWSRequestMetrics metrics)
```
    Bind the request metrics to the request. Note metrics can be captured before the request is created.
    
    Throws:
    
    IllegalStateException - if the binding has already occurred

Interface Request<T>

Method Summary

Method Detail

addHeader

getHeaders

setHeaders

setResourcePath

getResourcePath

addParameter

withParameter

getParameters

setParameters

getEndpoint

setEndpoint

getHttpMethod

setHttpMethod

getContent

setContent

getServiceName

getOriginalRequest

getTimeOffset

setTimeOffset

withTimeOffset

getAWSRequestMetrics

setAWSRequestMetrics