com.ibm.cloud.objectstorage.Request Maven / Gradle / Ivy
Show all versions of ibm-cos-java-sdk-core Show documentation
/*
* Copyright 2010-2017 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.ibm.cloud.objectstorage;
import java.net.URI;
import java.util.List;
import java.util.Map;
import com.ibm.cloud.objectstorage.http.HttpMethodName;
import com.ibm.cloud.objectstorage.util.AWSRequestMetrics;
/**
* 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 use inside the AWS client libraries and
* request handlers. Users of the AWS SDK for Java should not implement this
* interface.
*
* @param
* The type of original, user facing request represented by this
* request.
*/
public interface Request extends SignableRequest, HandlerContextAware {
/**
* Sets all headers, clearing any existing ones.
*/
void setHeaders(Map headers);
/**
* Sets the path to the resource being requested.
*
* @param path
* The path to the resource being requested.
*/
void setResourcePath(String path);
/**
* 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.
*/
Request withParameter(String name, String value);
/**
* Sets all parameters, clearing any existing values.
*
* Note that List values within the parameters Map must use an implementation that supports null
* values.
*/
void setParameters(Map> parameters);
/**
* Adds the specified request parameter and list of values to this request.
*
* @param name
* The name of the request parameter.
* @param values
* The value of the request parameter.
*/
void addParameters(String name, List values);
/**
* 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.
*/
void setEndpoint(URI endpoint);
/**
* Sets the HTTP method (GET, POST, etc) to use when sending this request.
*
* @param httpMethod
* The HTTP method to use when sending this request.
*/
void setHttpMethod(HttpMethodName httpMethod);
/**
* @return The name of the Amazon service this request is for. This is used
* as the service name set in request metrics and service
* exceptions. This is NOT the same as the service name returned by
* {@link AmazonWebServiceClient#getServiceName()} which is used for
* signing purpose.
*
* @see {@link AmazonServiceException#getServiceName()}
* @see {@link AWSRequestMetrics.Field#ServiceName}
*/
String getServiceName();
/**
* Returns the original, user facing request object which this internal
* request object is representing.
*/
AmazonWebServiceRequest getOriginalRequest();
/**
* 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.
*
* @param timeOffset
* The optional value for time offset (in seconds) for this request.
*/
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.
*
* @return The updated request object.
*/
Request withTimeOffset(int timeOffset);
/**
* Returns the request metrics.
*/
AWSRequestMetrics getAWSRequestMetrics();
/**
* 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
*/
void setAWSRequestMetrics(AWSRequestMetrics metrics);
}