Package software.amazon.awssdk.http.urlconnection

Class UrlConnectionHttpClient

java.lang.Object

software.amazon.awssdk.http.urlconnection.UrlConnectionHttpClient

All Implemented Interfaces:

AutoCloseable, SdkHttpClient, SdkAutoCloseable

@SdkPublicApi
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	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	Description
static UrlConnectionHttpClient.Builder	builder()
String	clientName()
void	close()
static SdkHttpClient	create()	Create a HttpURLConnection client with the default properties
static SdkHttpClient	create(UrlConnectionFactory connectionFactory)	Use this method if you want to control the way a HttpURLConnection is created.
ExecutableHttpRequest	prepareRequest(HttpExecuteRequest request)

Methods inherited from class java.lang.Object

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

Method Details

builder

public static UrlConnectionHttpClient.Builder builder()

create

public static SdkHttpClient create()

Create a HttpURLConnection client with the default properties

Returns:

an UrlConnectionHttpClient

create

public static SdkHttpClient create(UrlConnectionFactory connectionFactory)

Use this method if you want to control the way a HttpURLConnection is created. This will ignore SDK defaults like SdkHttpConfigurationOption.CONNECTION_TIMEOUT and SdkHttpConfigurationOption.READ_TIMEOUT

Parameters:

connectionFactory - a function that, given a URI will create an HttpURLConnection

Returns:

an UrlConnectionHttpClient

prepareRequest

public ExecutableHttpRequest prepareRequest(HttpExecuteRequest request)

Specified by:

prepareRequest in interface SdkHttpClient

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface SdkAutoCloseable

clientName

public String clientName()

Specified by:

clientName in interface SdkHttpClient