Package io.grpc.internal

Class ProxyDetectorImpl

java.lang.Object

io.grpc.internal.ProxyDetectorImpl

All Implemented Interfaces:

ProxyDetector

class ProxyDetectorImpl
extends Object
implements ProxyDetector

A utility class that detects proxies using ProxySelector and detects authentication credentials using Authenticator.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static interface	ProxyDetectorImpl.AuthenticationProvider	This interface makes unit testing easier by avoiding direct calls to static methods.

Field Summary

Fields

Modifier and Type	Field	Description
private final ProxyDetectorImpl.AuthenticationProvider	authenticationProvider
private static final ProxyDetectorImpl.AuthenticationProvider	DEFAULT_AUTHENTICATOR
private static final com.google.common.base.Supplier<ProxySelector>	DEFAULT_PROXY_SELECTOR
private static final String	GRPC_PROXY_ENV_VAR	Deprecated. Use the standard Java proxy configuration instead with flags such as: -Dhttps.proxyHost=HOST -Dhttps.proxyPort=PORT
private static final Logger	log
private final InetSocketAddress	overrideProxyAddress
(package private) static final String	PROXY_SCHEME
private final com.google.common.base.Supplier<ProxySelector>	proxySelector

Constructor Summary

Constructors

Constructor	Description
ProxyDetectorImpl()	A proxy selector that uses the global ProxySelector.getDefault() and ProxyDetectorImpl.AuthenticationProvider to detect proxy parameters.
ProxyDetectorImpl(com.google.common.base.Supplier<ProxySelector> proxySelector, ProxyDetectorImpl.AuthenticationProvider authenticationProvider, String proxyEnvString)

Method Summary

Modifier and Type	Method	Description
private ProxiedSocketAddress	detectProxy(InetSocketAddress targetAddr)
private static InetSocketAddress	overrideProxy(String proxyHostPort)	GRPC_PROXY_EXP is deprecated but let's maintain compatibility for now.
ProxiedSocketAddress	proxyFor(SocketAddress targetServerAddress)	Given a target address, returns a proxied address if a proxy should be used.

Methods inherited from class java.lang.Object

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

Field Details

log

private static final Logger log

DEFAULT_AUTHENTICATOR

private static final ProxyDetectorImpl.AuthenticationProvider DEFAULT_AUTHENTICATOR

DEFAULT_PROXY_SELECTOR

private static final com.google.common.base.Supplier<ProxySelector> DEFAULT_PROXY_SELECTOR

GRPC_PROXY_ENV_VAR

@Deprecated
private static final String GRPC_PROXY_ENV_VAR

Deprecated.

Use the standard Java proxy configuration instead with flags such as: -Dhttps.proxyHost=HOST -Dhttps.proxyPort=PORT

Experimental environment variable name for enabling proxy support.

See Also:

• Constant Field Values

proxySelector

private final com.google.common.base.Supplier<ProxySelector> proxySelector

authenticationProvider

private final ProxyDetectorImpl.AuthenticationProvider authenticationProvider

overrideProxyAddress

private final InetSocketAddress overrideProxyAddress

PROXY_SCHEME

static final String PROXY_SCHEME

See Also:

• Constant Field Values

Constructor Details

ProxyDetectorImpl

public ProxyDetectorImpl()

A proxy selector that uses the global ProxySelector.getDefault() and ProxyDetectorImpl.AuthenticationProvider to detect proxy parameters.

ProxyDetectorImpl

ProxyDetectorImpl(com.google.common.base.Supplier<ProxySelector> proxySelector,
 ProxyDetectorImpl.AuthenticationProvider authenticationProvider,
 @Nullable
 String proxyEnvString)

Method Details

proxyFor

@Nullable
public ProxiedSocketAddress proxyFor(SocketAddress targetServerAddress)
                              throws IOException

Description copied from interface: ProxyDetector

Given a target address, returns a proxied address if a proxy should be used. If no proxy should be used, then return value will be null.

If the returned ProxiedSocketAddress contains any address that needs to be resolved locally, it should be resolved before it's returned, and this method throws if unable to resolve it.

Specified by:

proxyFor in interface ProxyDetector

Parameters:

targetServerAddress - the target address, which is generally unresolved, because the proxy will resolve it.

Throws:

IOException

detectProxy

private ProxiedSocketAddress detectProxy(InetSocketAddress targetAddr)
                                  throws IOException

Throws:

IOException

overrideProxy

private static InetSocketAddress overrideProxy(String proxyHostPort)

GRPC_PROXY_EXP is deprecated but let's maintain compatibility for now.