OpenJDK 27 · sun.net.www.protocol.http.HttpURLConnection

Modifier and Type	Class and Description
pack-priv static class	HttpURLConnection.ErrorStream
pack-priv class	HttpURLConnection.HttpInputStream
pack-priv class	HttpURLConnection.StreamingOutputStream
public static enum	HttpURLConnection.TunnelState

Modifier and Type	Field and Description
pack-priv static final String	acceptString
private static final boolean	allowRestrictedHeaders
protected volatile AuthCacheImpl	authCache
protected volatile Authenticator	authenticator
private Object	authObj
private static final int	bufSize4ES
private MessageHeader	cachedHeaders
private InputStream	cachedInputStream
protected CacheResponse	cachedResponse
private final ResponseCache	cacheHandler
pack-priv byte[]	cdata
private boolean	connecting
private final ReentrantLock	connectionLock
private int	connectTimeout Hides java.net.URLConnection.connectTimeout.
private CookieHandler	cookieHandler
pack-priv AuthenticationInfo	currentProxyCredentials
pack-priv AuthenticationInfo	currentServerCredentials
pack-priv static final int	defaultmaxRedirects
pack-priv DigestAuthentication.Parameters	digestparams
pack-priv static final Set<String>	disabledProxyingSchemes A, possibly empty, set of authentication schemes that are disabled when proxying plain HTTP ( not HTTPS ).
pack-priv static final Set<String>	disabledTunnelingSchemes A, possibly empty, set of authentication schemes that are disabled when setting up a tunnel for HTTPS ( HTTP CONNECT ).
private boolean	doingNTLM2ndStage
private boolean	doingNTLMp2ndStage
pack-priv String	domain
private static final boolean	enableESBuffer
private InputStream	errorStream
private static final String[]	EXCLUDE_HEADERS
private static final String[]	EXCLUDE_HEADERS2
private boolean	failedOnce
private Map<String, List<String>>	filteredHeaders
protected Handler	handler
protected HttpClient	http
pack-priv static final String	HTTP_CONNECT
pack-priv static final String	httpVersion
private InputStream	inputStream
protected Proxy	instProxy
pack-priv boolean	isUserProxyAuth
pack-priv boolean	isUserServerAuth
private Proxy	lastProxy
private static final PlatformLogger	logger
private static final int	maxHeaderSize
pack-priv static final int	maxRedirects
pack-priv boolean	needToCheck
private PosterOutputStream	poster
pack-priv String	proxyAuthKey
protected PrintStream	ps
private int	readTimeout Hides java.net.URLConnection.readTimeout.
private Exception	rememberedException
private Exception	rememberedExceptionOut
private MessageHeader	requests Hides java.net.URLConnection.requests.
pack-priv String	requestURI
private MessageHeader	responses
private static final String[]	restrictedHeaders
private static final Set<String>	restrictedHeaderSet
private static final String	RETRY_MSG1
private static final String	RETRY_MSG2
private static final String	RETRY_MSG3
private HttpClient	reuseClient
pack-priv String	serverAuthKey
private static final String	SET_COOKIE
private static final String	SET_COOKIE2
private boolean	setRequests
private boolean	setUserCookies
private HttpURLConnection.StreamingOutputStream	strOutputStream
private static final int	timeout4ESBuffer
private boolean	tryTransparentNTLMProxy
private boolean	tryTransparentNTLMServer
private HttpURLConnection.TunnelState	tunnelState
private boolean	useProxyResponseCode
public static final String	userAgent
private String	userCookies
private String	userCookies2
private final MessageHeader	userHeaders
private volatile boolean	usingProxy
pack-priv static final boolean	validateProxy
pack-priv static final boolean	validateServer
pack-priv static final String	version

Access	Constructor and Description
protected	HttpURLConnection(URL u, Handler handler)
public	HttpURLConnection(URL u, String host, int port)
public	HttpURLConnection(URL u, Proxy p) this constructor is used by other protocol handlers such as ftp that want to use http to fetch urls on their behalf.
protected	HttpURLConnection(URL u, Proxy p, Handler handler)

Method Summary

Modifier and Type	Method and Description
public void	addRequestProperty(String the keyword by which the request is known (e.g., "`accept`"). key, String the value associated with it. value) Overrides java.net.URLConnection.addRequestProperty. Adds a general request property specified by a key-value pair.
public Object	authObj()
public void	authObj(Object authObj)
private static String	checkHost(String h)
private void	checkMessageHeader(String key, String value)
private void	checkResponseCredentials(boolean inClose)
private boolean	checkReuseConnection()
private static URL	checkURL(URL u)
public void	connect() Implements abstract java.net.URLConnection.connect. Opens a communications link to the resource referenced by this URL, if such a connection has not already been established.
pack-priv static String	connectRequestURI(URL url)
public void	disconnect() Implements abstract java.net.HttpURLConnection.disconnect. Disconnect from the server (public API)
private void	disconnectInternal() Disconnect from the server (for internal use)
private void	disconnectWeb() Disconnect from the web server at the first 401 error.
public void	doTunneling() establish a tunnel through proxy server
private void	doTunneling0()
private void	expect100Continue()
private String	filterHeaderField(String name, String value) Returns a filtered version of the given headers value.
private boolean	followRedirect()
private boolean	followRedirect0(String loc, int stat, URL locUrl)
public AuthCacheImpl	getAuthCache()
private IOException	getChainedException(final IOException rememberedException)
public int	Returns: an `int` that indicates the connect timeout value in milliseconds getConnectTimeout() Overrides java.net.URLConnection.getConnectTimeout. Returns setting for connect timeout.
public CookieHandler	getCookieHandler()
public InputStream	getErrorStream() Overrides java.net.HttpURLConnection.getErrorStream. Returns the error stream if the connection failed but the server sent useful data nonetheless.
private Map<String, List<String>>	getFilteredHeaderFields()
public String	getHeaderField(String the name of the header field name) Overrides java.net.URLConnection.getHeaderField. Gets a header field by name.
public String	getHeaderField(int the index of the header field n) Overrides java.net.HttpURLConnection.getHeaderField. Gets a header field by index.
public String	getHeaderFieldKey(int the index of the header field n) Overrides java.net.HttpURLConnection.getHeaderFieldKey. Gets a header field by index.
public Map<String, List<String>>	Returns: a Map of header fields getHeaderFields() Overrides java.net.URLConnection.getHeaderFields. Returns an unmodifiable Map of the header fields.
protected HttpCallerInfo	getHttpCallerInfo(URL url, String proxy, int port, Authenticator authenticator) Overridden in https to also include the server certificate
protected HttpCallerInfo	getHttpCallerInfo(URL url, Authenticator authenticator) Overridden in https to also include the server certificate
public static PlatformLogger	getHttpLogger()
private AuthenticationInfo	getHttpProxyAuthentication(AuthenticationHeader authhdr) Gets the authentication for an HTTP proxy, and applies it to the connection.
public InputStream	getInputStream() Overrides java.net.URLConnection.getInputStream. Returns an input stream that reads from this open connection.
private InputStream	getInputStream0()
pack-priv String	getMethod()
protected HttpClient	getNewHttpClient(URL url, Proxy p, int connectTimeout)
protected HttpClient	getNewHttpClient(URL url, Proxy p, int connectTimeout, boolean useCache)
public OutputStream	getOutputStream() Overrides java.net.URLConnection.getOutputStream. Returns an output stream that writes to this connection.
private OutputStream	getOutputStream0()
public int	Returns: an `int` that indicates the read timeout value in milliseconds getReadTimeout() Overrides java.net.URLConnection.getReadTimeout. Returns setting for read timeout.
public Map<String, List<String>>	Returns: a Map of the general request properties for this connection. getRequestProperties() Overrides java.net.URLConnection.getRequestProperties. Returns an unmodifiable Map of general request properties for this connection.
public String	getRequestProperty(String key) Overrides java.net.URLConnection.getRequestProperty. Returns the value of the named general request property for this connection.
pack-priv String	getRequestURI()
private AuthenticationInfo	getServerAuthentication(AuthenticationHeader the AuthenticationHeader which tells what auth scheme is preferred. authhdr) Gets the authentication for an HTTP server, and applies it to the connection.
pack-priv MessageHeader	getUserSetHeaders()
private boolean	isExternalMessageHeaderAllowed(String key, String value)
public final boolean	isLockHeldByCurrentThread()
private boolean	isRestrictedHeader(String key, String value)
private final void	lock()
private MessageHeader	mapToMessageHeader(Map<String, List<String>> map)
private static URL	newURL(String spec)
private static URL	newURL(URL context, String spec)
protected void	noResponseBody() This method is called when a response with no response body is received, and arrange for the http client to be returned to the pool (or released) immediately when possible.
private static int	parseConnectResponseCode(final String statusLine)
protected void	plainConnect()
protected void	plainConnect0()
protected void	proxiedConnect(URL url, String proxyHost, int proxyPort, boolean useCache)
private static PasswordAuthentication	requestPassword(final Authenticator authenticator, final String host, final InetAddress addr, final int port, final String protocol, final String prompt, final String scheme, final URL url, final Authenticator.RequestorType authType)
private void	reset() Reset (without disconnecting the TCP conn) in order to do another transaction with this instance
private AuthenticationInfo	resetProxyAuthentication(AuthenticationInfo proxyAuthentication, AuthenticationHeader auth) set or reset proxy authentication info in request headers after receiving a 407 error.
private static boolean	sameDestination(URL firstURL, URL secondURL)
private static Set<String>	schemesListToSet(String list)
private void	sendCONNECTRequest() send a CONNECT request for establishing a tunnel to proxy server
public void	setAuthenticationProperty(String key, String value)
public void	setAuthenticator(Authenticator auth) Overrides java.net.HttpURLConnection.setAuthenticator. Supplies an `Authenticator` to be used when authentication is requested through the HTTP protocol for this `HttpURLConnection`.
public void	setConnectTimeout(int timeout) Overrides java.net.URLConnection.setConnectTimeout. Sets a specified timeout value, in milliseconds, to be used when opening a communications link to the resource referenced by this URLConnection.
private void	setCookieHeader()
protected void	setNewClient(URL the URL being accessed url) Create a new HttpClient object, bypassing the cache of HTTP client objects/connections.
protected void	setNewClient(URL the URL being accessed url, boolean whether the cached connection should be used if present useCache) Obtain a HttpsClient object.
private void	setPreemptiveProxyAuthentication(MessageHeader requests) Sets pre-emptive proxy authentication in header
protected void	setProxiedClient(URL the URL being accessed url, String the proxy host to use proxyHost, int the proxy port to use proxyPort) Create a new HttpClient object, set up so that it uses per-instance proxying to the given HTTP proxy.
protected void	setProxiedClient(URL the URL being accessed url, String the proxy host to use proxyHost, int the proxy port to use proxyPort, boolean whether the cached connection should be used if present useCache) Obtain a HttpClient object, set up so that it uses per-instance proxying to the given HTTP proxy.
public void	setReadTimeout(int an `int` that specifies the timeout value to be used in milliseconds timeout) Overrides java.net.URLConnection.setReadTimeout. Sets the read timeout to a specified timeout, in milliseconds.
public void	setRequestMethod(String method) Overrides java.net.HttpURLConnection.setRequestMethod. Set the method for the URL request, one of: GET POST HEAD OPTIONS PUT DELETE TRACE
public void	setRequestProperty(String key, String the value to be set value) Overrides java.net.URLConnection.setRequestProperty. Sets request property.
public void	setTunnelState(HttpURLConnection.TunnelState the state tunnelState) Set the tunneling status.
public boolean	streaming()
pack-priv static String	Returns: host address without Zone Id stripIPv6ZoneId(String host address (not null, not empty) host) Returns the given host, without the IPv6 Zone Id, if present.
pack-priv HttpURLConnection.TunnelState	Returns: the state tunnelState() Returns the tunnel state.
private final void	unlock()
public boolean	usingProxy() Implements abstract java.net.HttpURLConnection.usingProxy. Returns true if the established connection is using a proxy or if a proxy is specified for the inactive connection
pack-priv boolean	usingProxyInternal() Returns true only if the established connection is using a proxy
private static void	validateNTLMCredentials(PasswordAuthentication pw)
private void	writeRequests()

Inherited from java.net.HttpURLConnection:: getFollowRedirects getHeaderFieldDate getInstanceFollowRedirects getPermission getRequestMethod getResponseCode getResponseMessage setChunkedStreamingMode setFixedLengthStreamingMode setFixedLengthStreamingMode setFollowRedirects setInstanceFollowRedirects

public Class HttpURLConnection

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary