Package software.amazon.awssdk.core.internal.http.pipeline.stages

Class TimeoutExceptionHandlingStage<OutputT>

java.lang.Object

software.amazon.awssdk.core.internal.http.pipeline.stages.TimeoutExceptionHandlingStage<OutputT>

All Implemented Interfaces:

RequestPipeline<SdkHttpFullRequest,Response<OutputT>>, RequestToResponsePipeline<OutputT>

@SdkInternalApi
public final class TimeoutExceptionHandlingStage<OutputT>
extends Object
implements RequestToResponsePipeline<OutputT>

Check if an Exception is caused by either ApiCallTimeout or ApiAttemptTimeout and translate that exception to a more appropriate timeout related exception so that it can be handled in other stages.

Constructor Summary

Constructors

Constructor	Description
TimeoutExceptionHandlingStage(HttpClientDependencies dependencies, RequestPipeline<SdkHttpFullRequest,Response<OutputT>> requestPipeline)

Method Summary

Modifier and Type	Method	Description
Response<OutputT>	execute(SdkHttpFullRequest request, RequestExecutionContext context)	Translate an Exception caused by timeout based on the following criteria: If the Exception is caused by ClientOverrideConfiguration.apiCallTimeout(), translates it to InterruptedException so it can be handled appropriately in ApiCallTimeoutTrackingStage.

Methods inherited from class java.lang.Object

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

Constructor Details

TimeoutExceptionHandlingStage

public TimeoutExceptionHandlingStage(HttpClientDependencies dependencies,
 RequestPipeline<SdkHttpFullRequest,Response<OutputT>> requestPipeline)

Method Details

execute

public Response<OutputT> execute(SdkHttpFullRequest request,
 RequestExecutionContext context)
                          throws Exception

Translate an Exception caused by timeout based on the following criteria:

• If the Exception is caused by ClientOverrideConfiguration.apiCallTimeout(), translates it to InterruptedException so it can be handled appropriately in ApiCallTimeoutTrackingStage.
• If it is caused by ClientOverrideConfiguration.apiCallAttemptTimeout(), clear the interrupt status, translates it to ApiCallAttemptTimeoutException so that it might be retried in RetryableStage

ApiCallTimeout takes precedence because it is not retryable.

Specified by:

execute in interface RequestPipeline<SdkHttpFullRequest,Response<OutputT>>

Parameters:

request - the request

context - Context containing both request dependencies, and a container for any mutable state that must be shared between stages.

Returns:

the response

Throws:

Exception - the translated exception or the original exception