250 lines
9.1 KiB
Java
250 lines
9.1 KiB
Java
|
/*
|
||
|
|
* Copyright (C) 2007 The Android Open Source Project
|
||
|
|
*
|
||
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||
|
|
* you may not use this file except in compliance with the License.
|
||
|
|
* You may obtain a copy of the License at
|
||
|
|
*
|
||
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
*
|
||
|
|
* Unless required by applicable law or agreed to in writing, software
|
||
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
|
|
* See the License for the specific language governing permissions and
|
||
|
|
* limitations under the License.
|
||
|
|
*/
|
||
|
|
|
||
|
|
package android.net;
|
||
|
|
|
||
|
|
import android.annotation.Nullable;
|
||
|
|
import android.annotation.SdkConstant;
|
||
|
|
import android.annotation.SdkConstant.SdkConstantType;
|
||
|
|
import android.annotation.SystemApi;
|
||
|
|
import android.compat.annotation.UnsupportedAppUsage;
|
||
|
|
import android.content.Context;
|
||
|
|
import android.os.Build;
|
||
|
|
import android.text.TextUtils;
|
||
|
|
import android.util.Log;
|
||
|
|
|
||
|
|
import com.android.net.module.util.ProxyUtils;
|
||
|
|
|
||
|
|
import java.net.InetSocketAddress;
|
||
|
|
import java.net.ProxySelector;
|
||
|
|
import java.net.URI;
|
||
|
|
import java.util.List;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* A convenience class for accessing the user and default proxy
|
||
|
|
* settings.
|
||
|
|
*/
|
||
|
|
public final class Proxy {
|
||
|
|
|
||
|
|
private static final String TAG = "Proxy";
|
||
|
|
|
||
|
|
private static final ProxySelector sDefaultProxySelector;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* 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 {@link ConnectivityManager#getDefaultProxy()}.
|
||
|
|
*
|
||
|
|
* <p class="note">This is a protected intent that can only be sent by the system
|
||
|
|
*/
|
||
|
|
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
|
||
|
|
public static final String PROXY_CHANGE_ACTION = "android.intent.action.PROXY_CHANGE";
|
||
|
|
/**
|
||
|
|
* Intent extra included with {@link #PROXY_CHANGE_ACTION} intents.
|
||
|
|
* It describes the new proxy being used (as a {@link ProxyInfo} object).
|
||
|
|
* @deprecated Because {@code PROXY_CHANGE_ACTION} is sent whenever the proxy
|
||
|
|
* for any network on the system changes, applications should always use
|
||
|
|
* {@link ConnectivityManager#getDefaultProxy()} or
|
||
|
|
* {@link ConnectivityManager#getLinkProperties(Network)}.{@link LinkProperties#getHttpProxy()}
|
||
|
|
* to get the proxy for the Network(s) they are using.
|
||
|
|
* @removed
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public static final String EXTRA_PROXY_INFO = "android.intent.extra.PROXY_INFO";
|
||
|
|
|
||
|
|
private static ConnectivityManager sConnectivityManager = null;
|
||
|
|
|
||
|
|
static {
|
||
|
|
sDefaultProxySelector = ProxySelector.getDefault();
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Return the proxy object to be used for the URL given as parameter.
|
||
|
|
* @param ctx A Context used to get the settings for the proxy host.
|
||
|
|
* @param url A URL to be accessed. Used to evaluate exclusion list.
|
||
|
|
* @return Proxy (java.net) object containing the host name. If the
|
||
|
|
* user did not set a hostname it returns the default host.
|
||
|
|
* A null value means that no host is to be used.
|
||
|
|
* {@hide}
|
||
|
|
*/
|
||
|
|
@UnsupportedAppUsage
|
||
|
|
public static final java.net.Proxy getProxy(Context ctx, String url) {
|
||
|
|
String host = "";
|
||
|
|
if ((url != null) && !isLocalHost(host)) {
|
||
|
|
URI uri = URI.create(url);
|
||
|
|
ProxySelector proxySelector = ProxySelector.getDefault();
|
||
|
|
|
||
|
|
List<java.net.Proxy> proxyList = proxySelector.select(uri);
|
||
|
|
|
||
|
|
if (proxyList.size() > 0) {
|
||
|
|
return proxyList.get(0);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return java.net.Proxy.NO_PROXY;
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Return the proxy host set by the user.
|
||
|
|
* @param ctx A Context used to get the settings for the proxy host.
|
||
|
|
* @return 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.
|
||
|
|
* @deprecated Use standard java vm proxy values to find the host, port
|
||
|
|
* and exclusion list. This call ignores the exclusion list.
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public static final String getHost(Context ctx) {
|
||
|
|
java.net.Proxy proxy = getProxy(ctx, null);
|
||
|
|
if (proxy == java.net.Proxy.NO_PROXY) return null;
|
||
|
|
try {
|
||
|
|
return ((InetSocketAddress)(proxy.address())).getHostName();
|
||
|
|
} catch (Exception e) {
|
||
|
|
return null;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Return the proxy port set by the user.
|
||
|
|
* @param ctx A Context used to get the settings for the proxy port.
|
||
|
|
* @return The port number to use or -1 if no proxy is to be used.
|
||
|
|
* @deprecated Use standard java vm proxy values to find the host, port
|
||
|
|
* and exclusion list. This call ignores the exclusion list.
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public static final int getPort(Context ctx) {
|
||
|
|
java.net.Proxy proxy = getProxy(ctx, null);
|
||
|
|
if (proxy == java.net.Proxy.NO_PROXY) return -1;
|
||
|
|
try {
|
||
|
|
return ((InetSocketAddress)(proxy.address())).getPort();
|
||
|
|
} catch (Exception e) {
|
||
|
|
return -1;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Return the default proxy host specified by the carrier.
|
||
|
|
* @return String containing the host name or null if there is no proxy for
|
||
|
|
* this carrier.
|
||
|
|
* @deprecated 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.
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public static final String getDefaultHost() {
|
||
|
|
String host = System.getProperty("http.proxyHost");
|
||
|
|
if (TextUtils.isEmpty(host)) return null;
|
||
|
|
return host;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Return the default proxy port specified by the carrier.
|
||
|
|
* @return The port number to be used with the proxy host or -1 if there is
|
||
|
|
* no proxy for this carrier.
|
||
|
|
* @deprecated 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.
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public static final int getDefaultPort() {
|
||
|
|
if (getDefaultHost() == null) return -1;
|
||
|
|
try {
|
||
|
|
return Integer.parseInt(System.getProperty("http.proxyPort"));
|
||
|
|
} catch (NumberFormatException e) {
|
||
|
|
return -1;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
private static final boolean isLocalHost(String host) {
|
||
|
|
if (host == null) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
try {
|
||
|
|
if (host != null) {
|
||
|
|
if (host.equalsIgnoreCase("localhost")) {
|
||
|
|
return true;
|
||
|
|
}
|
||
|
|
if (InetAddresses.parseNumericAddress(host).isLoopbackAddress()) {
|
||
|
|
return true;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
} catch (IllegalArgumentException iex) {
|
||
|
|
}
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @hide */
|
||
|
|
@UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
|
||
|
|
@Deprecated
|
||
|
|
public static void setHttpProxySystemProperty(ProxyInfo p) {
|
||
|
|
setHttpProxyConfiguration(p);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Set HTTP proxy configuration for the process to match the provided ProxyInfo.
|
||
|
|
*
|
||
|
|
* If the provided ProxyInfo is null, the proxy configuration will be cleared.
|
||
|
|
* @hide
|
||
|
|
*/
|
||
|
|
@SystemApi(client = SystemApi.Client.MODULE_LIBRARIES)
|
||
|
|
public static void setHttpProxyConfiguration(@Nullable ProxyInfo p) {
|
||
|
|
String host = null;
|
||
|
|
String port = null;
|
||
|
|
String exclList = null;
|
||
|
|
Uri pacFileUrl = Uri.EMPTY;
|
||
|
|
if (p != null) {
|
||
|
|
host = p.getHost();
|
||
|
|
port = Integer.toString(p.getPort());
|
||
|
|
exclList = ProxyUtils.exclusionListAsString(p.getExclusionList());
|
||
|
|
pacFileUrl = p.getPacFileUrl();
|
||
|
|
}
|
||
|
|
setHttpProxyConfiguration(host, port, exclList, pacFileUrl);
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @hide */
|
||
|
|
public static void setHttpProxyConfiguration(String host, String port, String exclList,
|
||
|
|
Uri pacFileUrl) {
|
||
|
|
if (exclList != null) exclList = exclList.replace(",", "|");
|
||
|
|
if (false) Log.d(TAG, "setHttpProxySystemProperty :"+host+":"+port+" - "+exclList);
|
||
|
|
if (host != null) {
|
||
|
|
System.setProperty("http.proxyHost", host);
|
||
|
|
System.setProperty("https.proxyHost", host);
|
||
|
|
} else {
|
||
|
|
System.clearProperty("http.proxyHost");
|
||
|
|
System.clearProperty("https.proxyHost");
|
||
|
|
}
|
||
|
|
if (port != null) {
|
||
|
|
System.setProperty("http.proxyPort", port);
|
||
|
|
System.setProperty("https.proxyPort", port);
|
||
|
|
} else {
|
||
|
|
System.clearProperty("http.proxyPort");
|
||
|
|
System.clearProperty("https.proxyPort");
|
||
|
|
}
|
||
|
|
if (exclList != null) {
|
||
|
|
System.setProperty("http.nonProxyHosts", exclList);
|
||
|
|
System.setProperty("https.nonProxyHosts", exclList);
|
||
|
|
} else {
|
||
|
|
System.clearProperty("http.nonProxyHosts");
|
||
|
|
System.clearProperty("https.nonProxyHosts");
|
||
|
|
}
|
||
|
|
if (!Uri.EMPTY.equals(pacFileUrl)) {
|
||
|
|
ProxySelector.setDefault(new PacProxySelector());
|
||
|
|
} else {
|
||
|
|
ProxySelector.setDefault(sDefaultProxySelector);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|