Proxy

public final class Proxy
extends Object

java.lang.Object
   ↳ android.net.Proxy


A convenience class for accessing the user and default proxy settings.

Summary

Constants

String EXTRA_PROXY_INFO

This constant was deprecated in API level 23. Because PROXY_CHANGE_ACTION is sent whenever the proxy for any network on the system changes, applications should always use ConnectivityManager.getDefaultProxy() or ConnectivityManager.getLinkProperties(Network).LinkProperties.getHttpProxy() to get the proxy for the Network(s) they are using.

String PROXY_CHANGE_ACTION

Used to notify an app that's caching the proxy that either the default connection has changed or any connection's proxy has changed.

Public constructors

Proxy()

Public methods

static String getDefaultHost()

This method was deprecated in API level 11. Use standard java vm proxy values to find the host, port and exclusion list. This call ignores the exclusion list and no longer reports only mobile-data apn-based proxy values.

static int getDefaultPort()

This method was deprecated in API level 11. Use standard java vm proxy values to find the host, port and exclusion list. This call ignores the exclusion list and no longer reports only mobile-data apn-based proxy values.

static String getHost(Context ctx)

This method was deprecated in API level 11. Use standard java vm proxy values to find the host, port and exclusion list. This call ignores the exclusion list.

static int getPort(Context ctx)

This method was deprecated in API level 11. Use standard java vm proxy values to find the host, port and exclusion list. This call ignores the exclusion list.

Inherited methods

Constants

EXTRA_PROXY_INFO

added in API level 21
public static final String EXTRA_PROXY_INFO

This constant was deprecated in API level 23.
Because PROXY_CHANGE_ACTION is sent whenever the proxy for any network on the system changes, applications should always use ConnectivityManager.getDefaultProxy() or ConnectivityManager.getLinkProperties(Network).LinkProperties.getHttpProxy() to get the proxy for the Network(s) they are using.

Intent extra included with PROXY_CHANGE_ACTION intents. It describes the new proxy being used (as a ProxyInfo object).

Constant Value: "android.intent.extra.PROXY_INFO"

PROXY_CHANGE_ACTION

added in API level 1
public static final String PROXY_CHANGE_ACTION

Used to notify an app that's caching the proxy that either the default connection has changed or any connection's proxy has changed. The new proxy should be queried using ConnectivityManager.getDefaultProxy().

This is a protected intent that can only be sent by the system

Constant Value: "android.intent.action.PROXY_CHANGE"

Public constructors

Proxy

added in API level 1
public Proxy ()

Public methods

getDefaultHost

added in API level 1
public static String getDefaultHost ()

This method was deprecated in API level 11.
Use standard java vm proxy values to find the host, port and exclusion list. This call ignores the exclusion list and no longer reports only mobile-data apn-based proxy values.

Return the default proxy host specified by the carrier.

Returns
String String containing the host name or null if there is no proxy for this carrier.

getDefaultPort

added in API level 1
public static int getDefaultPort ()

This method was deprecated in API level 11.
Use standard java vm proxy values to find the host, port and exclusion list. This call ignores the exclusion list and no longer reports only mobile-data apn-based proxy values.

Return the default proxy port specified by the carrier.

Returns
int The port number to be used with the proxy host or -1 if there is no proxy for this carrier.

getHost

added in API level 1
public static String getHost (Context ctx)

This method was deprecated in API level 11.
Use standard java vm proxy values to find the host, port and exclusion list. This call ignores the exclusion list.

Return the proxy host set by the user.

Parameters
ctx Context: A Context used to get the settings for the proxy host.

Returns
String String containing the host name. If the user did not set a host name it returns the default host. A null value means that no host is to be used.

getPort

added in API level 1
public static int getPort (Context ctx)

This method was deprecated in API level 11.
Use standard java vm proxy values to find the host, port and exclusion list. This call ignores the exclusion list.

Return the proxy port set by the user.

Parameters
ctx Context: A Context used to get the settings for the proxy port.

Returns
int The port number to use or -1 if no proxy is to be used.