software.amazon.awssdk.http.urlconnection

Interface ProxyConfiguration.Builder

All Superinterfaces:

Buildable, CopyableBuilder<ProxyConfiguration.Builder,ProxyConfiguration>, SdkBuilder<ProxyConfiguration.Builder,ProxyConfiguration>

Enclosing class:

ProxyConfiguration

public static interface ProxyConfiguration.Builder
extends CopyableBuilder<ProxyConfiguration.Builder,ProxyConfiguration>

A builder for ProxyConfiguration.

All implementations of this interface are mutable and not thread safe.

Method Summary

Modifier and Type	Method and Description
ProxyConfiguration.Builder	addNonProxyHost(String nonProxyHost) Add a host that the client is allowed to access without going through the proxy.
ProxyConfiguration.Builder	endpoint(URI endpoint) Configure the endpoint of the proxy server that the SDK should connect through.
ProxyConfiguration.Builder	nonProxyHosts(Set<String> nonProxyHosts) Configure the hosts that the client is allowed to access without going through the proxy.
ProxyConfiguration.Builder	password(String password) Configure the password to use when connecting through a proxy.
ProxyConfiguration.Builder	scheme(String scheme) The HTTP scheme to use for connecting to the proxy.
ProxyConfiguration.Builder	useEnvironmentVariablesValues(Boolean useEnvironmentVariablesValues) Option whether to use environment variable values from ProxyEnvironmentSetting if any of the config options are missing.
ProxyConfiguration.Builder	username(String username) Configure the username to use when connecting through a proxy.
ProxyConfiguration.Builder	useSystemPropertyValues(Boolean useSystemPropertyValues) Option whether to use system property values from ProxySystemSetting if any of the config options are missing.

Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder

copy

Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder

applyMutation, build

Method Detail

endpoint

ProxyConfiguration.Builder endpoint(URI endpoint)

Configure the endpoint of the proxy server that the SDK should connect through. Currently, the endpoint is limited to a host and port. Any other URI components will result in an exception being raised.

username

ProxyConfiguration.Builder username(String username)

Configure the username to use when connecting through a proxy.

password

ProxyConfiguration.Builder password(String password)

Configure the password to use when connecting through a proxy.

nonProxyHosts

ProxyConfiguration.Builder nonProxyHosts(Set<String> nonProxyHosts)

Configure the hosts that the client is allowed to access without going through the proxy.

addNonProxyHost

ProxyConfiguration.Builder addNonProxyHost(String nonProxyHost)

Add a host that the client is allowed to access without going through the proxy.

See Also:

ProxyConfiguration.nonProxyHosts()

useSystemPropertyValues

ProxyConfiguration.Builder useSystemPropertyValues(Boolean useSystemPropertyValues)

Option whether to use system property values from ProxySystemSetting if any of the config options are missing.

This value is set to "true" by default which means SDK will automatically use system property values for options that are not provided during building the ProxyConfiguration object. To disable this behavior, set this value to "false".It is important to note that when this property is set to "true," all proxy settings will exclusively originate from system properties, and no partial settings will be obtained from EnvironmentVariableValues

useEnvironmentVariablesValues

ProxyConfiguration.Builder useEnvironmentVariablesValues(Boolean useEnvironmentVariablesValues)

Option whether to use environment variable values from ProxyEnvironmentSetting if any of the config options are missing. This value is set to "true" by default, which means SDK will automatically use environment variable values for options that are not provided during building the ProxyConfiguration object. To disable this behavior, set this value to "false".It is important to note that when this property is set to "true," all proxy settings will exclusively originate from environment variableValues, and no partial settings will be obtained from SystemPropertyValues.

Parameters:

useEnvironmentVariablesValues - The option whether to use environment variable values

Returns:

This object for method chaining.

scheme

ProxyConfiguration.Builder scheme(String scheme)

The HTTP scheme to use for connecting to the proxy. Valid values are http and https.

The client defaults to http if none is given.

Parameters:

scheme - The proxy scheme.

Returns:

This object for method chaining.