software.amazon.awssdk.http.urlconnection

Class UrlConnectionHttpClient

java.lang.Object

software.amazon.awssdk.http.urlconnection.UrlConnectionHttpClient

All Implemented Interfaces:

AutoCloseable, ConfigurationProvider, SdkHttpClient, SdkAutoCloseable

public final class UrlConnectionHttpClient
extends Object
implements SdkHttpClient

An implementation of SdkHttpClient that uses HttpURLConnection to communicate with the service. This is the leanest synchronous client that optimizes for minimum dependencies and startup latency in exchange for having less functionality than other implementations.

See software.amazon.awssdk.http.apache.ApacheHttpClient for an alternative implementation.

This can be created via builder()

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	UrlConnectionHttpClient.Builder A builder for an instance of SdkHttpClient that uses JDKs build-in URLConnection HTTP implementation.

Method Summary

Modifier and Type	Method and Description
static UrlConnectionHttpClient.Builder	builder()
void	close()
<T> Optional<T>	getConfigurationValue(SdkHttpConfigurationOption<T> key) Retrieve the current value of the configuration option, if present.
AbortableCallable<SdkHttpFullResponse>	prepareRequest(SdkHttpFullRequest request, SdkRequestContext requestContext) Create a AbortableCallable that can be used to execute the HTTP request.

Methods inherited from class java.lang.Object

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

Method Detail

builder

public static UrlConnectionHttpClient.Builder builder()

prepareRequest

public AbortableCallable<SdkHttpFullResponse> prepareRequest(SdkHttpFullRequest request,
                                                             SdkRequestContext requestContext)

Description copied from interface: SdkHttpClient

Create a AbortableCallable that can be used to execute the HTTP request.

Specified by:

prepareRequest in interface SdkHttpClient

Parameters:

request - Representation of an HTTP request.

requestContext - Contains any extra dependencies needed.

Returns:

Task that can execute an HTTP request and can be aborted.

getConfigurationValue

public <T> Optional<T> getConfigurationValue(SdkHttpConfigurationOption<T> key)

Description copied from interface: ConfigurationProvider

Retrieve the current value of the configuration option, if present.

Specified by:

getConfigurationValue in interface ConfigurationProvider

Type Parameters:

T - Type of configuration value.

Parameters:

key - Key of configuration value to retrieve.

Returns:

Empty Optional if configuration option is not supported, otherwise a fulfilled Optional containing the current value.

close

public void close()

Description copied from interface: SdkAutoCloseable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface SdkAutoCloseable