Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public abstract class

ProxySelector

extends Object
java.lang.Object
   ↳ java.net.ProxySelector

Class Overview

Selects the proxy server to use, if any, when connecting to a given URL.

System Properties

The default proxy selector is configured by system properties.

Hostname patterns
URL scheme property name description default
ftp ftp.nonProxyHosts Hostname pattern for FTP servers to connect to directly (without a proxy).
http http.nonProxyHosts Hostname pattern for HTTP servers to connect to directly (without a proxy).
https https.nonProxyHosts Hostname pattern for HTTPS servers to connect to directly (without a proxy).

HTTP Proxies
URL scheme property name description default
ftp ftp.proxyHost Hostname of the HTTP proxy server used for FTP requests.
ftp.proxyPort Port number of the HTTP proxy server used for FTP requests. 80
http http.proxyHost Hostname of the HTTP proxy server used for HTTP requests.
http.proxyPort Port number of the HTTP proxy server used for HTTP requests. 80
https https.proxyHost Hostname of the HTTP proxy server used for HTTPS requests.
https.proxyPort Port number of the HTTP proxy server used for HTTPS requests. 443
ftp, http or https proxyHost Hostname of the HTTP proxy server used for FTP, HTTP and HTTPS requests.
proxyPort Port number of the HTTP proxy server. 80 for FTP and HTTP
443 for HTTPS

SOCKS Proxies
URL scheme property name description default
ftp, http, https or socket socksProxyHost Hostname of the SOCKS proxy server used for FTP, HTTP, HTTPS and raw sockets.
Raw socket URLs are of the form socket:// host : port
socksProxyPort Port number of the SOCKS proxy server. 1080

Hostname patterns specify which hosts should be connected to directly, ignoring any other proxy system properties. If the URL's host matches the corresponding hostname pattern, NO_PROXY is returned.

The format of a hostname pattern is a list of hostnames that are separated by | and that use * as a wildcard. For example, setting the http.nonProxyHosts property to *.android.com|*.kernel.org will cause requests to http://developer.android.com to be made without a proxy.

The default proxy selector always returns exactly one proxy. If no proxy is applicable, NO_PROXY is returned. If multiple proxies are applicable, such as when both the proxyHost and socksProxyHost system properties are set, the result is the property listed earliest in the table above.

Alternatives

To request a URL without involving the system proxy selector, explicitly specify a proxy or NO_PROXY using openConnection(Proxy) .

Use setDefault(ProxySelector) to install a custom proxy selector.

Summary

Public Constructors
ProxySelector ()
Public Methods
abstract void connectFailed ( URI uri, SocketAddress address, IOException failure)
Notifies this ProxySelector that a connection to the proxy server could not be established.
static ProxySelector getDefault ()
Returns the default proxy selector, or null if none exists.
abstract List < Proxy > select ( URI uri)
Returns the proxy servers to use on connections to uri .
static void setDefault ( ProxySelector selector)
Sets the default proxy selector.
[Expand]
Inherited Methods
From class java.lang.Object

Public Constructors

public ProxySelector ()

Added in API level 1

Public Methods

public abstract void connectFailed ( URI uri, SocketAddress address, IOException failure)

Added in API level 1

Notifies this ProxySelector that a connection to the proxy server could not be established.

Parameters
uri the URI to which the connection could not be established.
address the address of the proxy.
failure the exception which was thrown during connection establishment.
Throws
IllegalArgumentException if any argument is null.

public static ProxySelector getDefault ()

Added in API level 1

Returns the default proxy selector, or null if none exists.

public abstract List < Proxy > select ( URI uri)

Added in API level 1

Returns the proxy servers to use on connections to uri . This list will contain NO_PROXY if no proxy server should be used.

Throws
IllegalArgumentException if uri is null.

public static void setDefault ( ProxySelector selector)

Added in API level 1

Sets the default proxy selector. If selector is null, the current proxy selector will be removed.