Interface ProxyConfigProvider

All Known Implementing Classes:

ProxyEnvironmentVariableConfigProvider, ProxySystemPropertyConfigProvider

@SdkProtectedApi
public interface ProxyConfigProvider

Interface for providing proxy configuration settings. Implementations of this interface can retrieve proxy configuration from various sources such as system properties and environment variables.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	HTTPS	Constant representing the HTTPS scheme.

Method Summary

Modifier and Type	Method	Description
static ProxyConfigProvider	fromEnvironmentSettings(String scheme)	Returns a new ProxyConfigProvider that retrieves proxy configuration from environment variables.
static ProxyConfigProvider	fromSystemEnvironmentSettings(Boolean useSystemPropertyValues, Boolean useEnvironmentVariableValues, String scheme)	Returns a ProxyConfigProvider based on the specified settings for using system properties, environment variables, and the scheme.
static ProxyConfigProvider	fromSystemPropertySettings(String scheme)	Returns a new ProxyConfigProvider that retrieves proxy configuration from system properties.
String	host()	Gets the proxy host.
Set<String>	nonProxyHosts()	Gets the set of non-proxy hosts.
Optional<String>	password()	Gets the proxy password if available.
int	port()	Gets the proxy port.
default Set<String>	rawNonProxyHosts()	Gets the set of non-proxy hosts as raw tokens, i.e.
Optional<String>	userName()	Gets the proxy username if available.

Field Details

HTTPS

static final String HTTPS

Constant representing the HTTPS scheme.

See Also:

• Constant Field Values

Method Details

fromSystemPropertySettings

static ProxyConfigProvider fromSystemPropertySettings(String scheme)

Returns a new ProxyConfigProvider that retrieves proxy configuration from system properties.

Parameters:

scheme - The URI scheme for which the proxy configuration is needed (e.g., "http" or "https").

Returns:

A ProxyConfigProvider for system property-based proxy configuration.

fromEnvironmentSettings

static ProxyConfigProvider fromEnvironmentSettings(String scheme)

Returns a new ProxyConfigProvider that retrieves proxy configuration from environment variables.

Parameters:

scheme - The URI scheme for which the proxy configuration is needed (e.g., "http" or "https").

Returns:

A ProxyConfigProvider for environment variable-based proxy configuration.

fromSystemEnvironmentSettings

static ProxyConfigProvider fromSystemEnvironmentSettings(Boolean useSystemPropertyValues,
 Boolean useEnvironmentVariableValues,
 String scheme)

Returns a ProxyConfigProvider based on the specified settings for using system properties, environment variables, and the scheme.

Parameters:

useSystemPropertyValues - A Boolean indicating whether to use system property values.

useEnvironmentVariableValues - A Boolean indicating whether to use environment variable values.

scheme - The URI scheme for which the proxy configuration is needed (e.g., "http" or "https").

Returns:

A ProxyConfigProvider based on the specified settings.

port

int port()

Gets the proxy port.

Returns:

The proxy port.

userName

Optional<String> userName()

Gets the proxy username if available.

Returns:

An optional containing the proxy username, if available.

password

Optional<String> password()

Gets the proxy password if available.

Returns:

An optional containing the proxy password, if available.

host

String host()

Gets the proxy host.

Returns:

The proxy host.

nonProxyHosts

Set<String> nonProxyHosts()

Gets the set of non-proxy hosts.

Returns:

A set containing the non-proxy host names.

rawNonProxyHosts

default Set<String> rawNonProxyHosts()

Gets the set of non-proxy hosts as raw tokens, i.e. without the * -> .*? Java-regex rewrite that nonProxyHosts() applies for system-property and environment-variable sources. Consumers whose matcher expects the raw nonProxyHosts tokens (such as the CRT client's curl-style native matcher) must use this instead of nonProxyHosts().

The default throws UnsupportedOperationException rather than falling back to nonProxyHosts(): a fallback would silently feed Java-regex tokens into a curl-style matcher and reintroduce incorrect proxy bypass. Implementations consumed by CRT-based clients must override it.

Returns:

A set containing the raw non-proxy host tokens.