Package software.amazon.awssdk.http

Class ExecutionContext

java.lang.Object

software.amazon.awssdk.http.ExecutionContext

@NotThreadSafe
public class ExecutionContext
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ExecutionContext.Builder

Constructor Summary

Constructors

Constructor	Description
ExecutionContext()	For testing purposes.
ExecutionContext(boolean isMetricEnabled)	For testing purposes.
ExecutionContext(List<RequestHandler> requestHandlers, boolean isMetricEnabled, AmazonWebServiceClient awsClient)	Deprecated.

Method Summary

Modifier and Type	Method	Description
static ExecutionContext.Builder	builder()
AwsRequestMetrics	getAwsRequestMetrics()
ClientExecutionAbortTrackerTask	getClientExecutionTrackerTask()
AwsCredentialsProvider	getCredentialsProvider()	Returns the credentials provider used for fetching the credentials.
List<RequestHandler>	getRequestHandlers()
Signer	getSigner(SignerProviderContext context)	Passes in the provided SignerProviderContext into a SignerProvider and returns a Signer instance.
Signer	getSignerByUri(URI uri)	Deprecated.
SignerProvider	getSignerProvider()
void	markRetryCapacityConsumed()	Marks that a retry during this request lifecycle has consumed retry capacity.
boolean	retryCapacityConsumed()	Returns whether retry capacity was consumed during this request lifecycle.
void	setClientExecutionTrackerTask(ClientExecutionAbortTrackerTask clientExecutionTrackerTask)
void	setCredentialsProvider(AwsCredentialsProvider credentialsProvider)	Sets the credentials provider used for fetching the credentials.
void	setSigner(Signer signer)	Deprecated.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ExecutionContext

public ExecutionContext(boolean isMetricEnabled)

For testing purposes.

ExecutionContext

public ExecutionContext()

For testing purposes.

ExecutionContext

@Deprecated
public ExecutionContext(List<RequestHandler> requestHandlers,
                        boolean isMetricEnabled,
                        AmazonWebServiceClient awsClient)

Deprecated.

Method Detail

builder

public static ExecutionContext.Builder builder()

getRequestHandlers

public List<RequestHandler> getRequestHandlers()

getAwsRequestMetrics

public AwsRequestMetrics getAwsRequestMetrics()

setSigner

@Deprecated
public void setSigner(Signer signer)

Deprecated.

There is in general no need to set the signer in the execution context, since the signer for each request may differ depending on the URI of the request. The exception is S3 where the signer is currently determined only when the S3 client is constructed. Hence the need for this method. We may consider supporting a per request level signer determination for S3 later on.

retryCapacityConsumed

public boolean retryCapacityConsumed()

Returns whether retry capacity was consumed during this request lifecycle. This can be inspected to determine whether capacity should be released if a retry succeeds.

Returns:

true if retry capacity was consumed

markRetryCapacityConsumed

public void markRetryCapacityConsumed()

Marks that a retry during this request lifecycle has consumed retry capacity. This is inspected when determining if capacity should be released if a retry succeeds.

getSigner

public Signer getSigner(SignerProviderContext context)

Passes in the provided SignerProviderContext into a SignerProvider and returns a Signer instance.

getSignerByUri

@Deprecated
public Signer getSignerByUri(URI uri)

Deprecated.

Returns the signer for the given uri. Note S3 in particular overrides this method.

getCredentialsProvider

public AwsCredentialsProvider getCredentialsProvider()

Returns the credentials provider used for fetching the credentials. The credentials fetched is used for signing the request. If there is no credential provider, then the runtime will not attempt to sign (or resign on retries) requests.

Returns:

the credentials provider to fetch AwsCredentials

setCredentialsProvider

public void setCredentialsProvider(AwsCredentialsProvider credentialsProvider)

Sets the credentials provider used for fetching the credentials. The credentials fetched is used for signing the request. If there is no credential provider, then the runtime will not attempt to sign (or resign on retries) requests.

Parameters:

credentialsProvider - the credentials provider to fetch AwsCredentials

getClientExecutionTrackerTask

public ClientExecutionAbortTrackerTask getClientExecutionTrackerTask()

setClientExecutionTrackerTask

public void setClientExecutionTrackerTask(ClientExecutionAbortTrackerTask clientExecutionTrackerTask)

getSignerProvider

public SignerProvider getSignerProvider()