software.amazon.awssdk.core.internal.http.timers.client

Class ClientExecutionTimer

java.lang.Object

software.amazon.awssdk.core.internal.http.timers.client.ClientExecutionTimer

All Implemented Interfaces:

AutoCloseable, SdkAutoCloseable

@ThreadSafe
public class ClientExecutionTimer
extends Object
implements SdkAutoCloseable

Represents a timer to enforce a timeout on the total client execution time. That is the time spent executing request handlers, any HTTP request including retries, unmarshalling, etc. Essentially all the time spent in AmazonHttpClient

Constructor Summary

Constructors

Constructor and Description
ClientExecutionTimer()

Method Summary

Modifier and Type	Method and Description
void	close() Shutdown the underlying ScheduledThreadPoolExecutor.
ScheduledThreadPoolExecutor	getExecutor() This method is current exposed for testing purposes
ClientExecutionAbortTrackerTask	startTimer(long clientExecutionTimeoutMillis) Start the timer with the specified timeout and return a object that can be used to track the state of the timer and cancel it if need be.

Methods inherited from class java.lang.Object

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

Constructor Detail

ClientExecutionTimer

public ClientExecutionTimer()

Method Detail

startTimer

public ClientExecutionAbortTrackerTask startTimer(long clientExecutionTimeoutMillis)

Start the timer with the specified timeout and return a object that can be used to track the state of the timer and cancel it if need be.

Parameters:

clientExecutionTimeoutMillis - A positive value here enables the timer, a non-positive value disables it and returns a dummy tracker task

Returns:

Implementation of ClientExecutionAbortTrackerTaskImpl to query the state of the task, provide it with up to date context, and cancel it if appropriate

getExecutor

public ScheduledThreadPoolExecutor getExecutor()

This method is current exposed for testing purposes

Returns:

The underlying ScheduledThreadPoolExecutor

close

public void close()

Shutdown the underlying ScheduledThreadPoolExecutor. Should be invoked when AmazonHttpClient is shutdown

Specified by:

close in interface AutoCloseable

Specified by:

close in interface SdkAutoCloseable