public abstract class

AbstractDelegateHttpsURLConnection

extends HttpURLConnection

java.lang.Object
↳	java.net.URLConnection
	↳	java.net.HttpURLConnection
		↳	sun.net.www.protocol.http.HttpURLConnection
			↳	sun.net.www.protocol.https.AbstractDelegateHttpsURLConnection

Known Direct Subclasses

DelegateHttpsURLConnection

Class Overview

HTTPS URL connection support. We need this delegate because HttpsURLConnection is a subclass of java.net.HttpURLConnection. We will avoid copying over the code from sun.net.www.protocol.http.HttpURLConnection by having this class

Summary

[Expand]

Inherited Constants

From class java.net.HttpURLConnection

[Expand]

Inherited Fields

From class sun.net.www.protocol.http.HttpURLConnection

From class java.net.HttpURLConnection

From class java.net.URLConnection

Protected Constructors
	AbstractDelegateHttpsURLConnection(URL url, Handler handler)
	AbstractDelegateHttpsURLConnection(URL url, Proxy p, Handler handler)

Public Methods
void	connect() Implements the HTTP protocol handler's "connect" method, establishing an SSL connection to the server as necessary.
String	getCipherSuite() Returns the cipher suite in use on this connection.
Certificate[]	getLocalCertificates() Returns the certificate chain the client sent to the server, or null if the client did not authenticate.
X509Certificate[]	getServerCertificateChain() Returns the server's X.509 certificate chain, or null if the server did not authenticate.
Certificate[]	getServerCertificates() Returns the server's certificate chain, or throws SSLPeerUnverified Exception if the server did not authenticate.
boolean	isConnected() Used by subclass to access "connected" variable.
void	setConnected(boolean conn) Used by subclass to access "connected" variable.
void	setNewClient(URL url) Create a new HttpClient object, bypassing the cache of HTTP client objects/connections.
void	setNewClient(URL url, boolean useCache) Obtain a HttpClient object.
void	setProxiedClient(URL url, String proxyHost, int proxyPort) Create a new HttpClient object, set up so that it uses per-instance proxying to the given HTTP proxy.
void	setProxiedClient(URL url, String proxyHost, int proxyPort, boolean useCache) Obtain a HttpClient object, set up so that it uses per-instance proxying to the given HTTP proxy.

Protected Methods
abstract HostnameVerifier	getHostnameVerifier()
HttpClient	getNewHttpClient(URL url, Proxy p, int connectTimeout)
HttpClient	getNewHttpClient(URL url, Proxy p, int connectTimeout, boolean useCache)
abstract SSLSocketFactory	getSSLSocketFactory()
void	proxiedConnect(URL url, String proxyHost, int proxyPort, boolean useCache)

[Expand]

Inherited Methods

From class sun.net.www.protocol.http.HttpURLConnection

void	addRequestProperty(String key, String value) Adds a general request property specified by a key-value pair.
void	connect() Opens a communications link to the resource referenced by this URL, if such a connection has not already been established.
void	disconnect() Disconnect from the server (public API)
synchronized void	doTunneling() establish a tunnel through proxy server
void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
int	getConnectTimeout() Returns setting for connect timeout.
InputStream	getErrorStream() Returns the error stream if the connection failed but the server sent useful data nonetheless.
String	getHeaderField(String name) Gets a header field by name.
String	getHeaderField(int n) Gets a header field by index.
String	getHeaderFieldKey(int n) Gets a header field by index.
Map	getHeaderFields() Returns an unmodifiable Map of the header fields.
synchronized InputStream	getInputStream() Returns an input stream that reads from this open connection.
HttpClient	getNewHttpClient(URL url, Proxy p, int connectTimeout)
HttpClient	getNewHttpClient(URL url, Proxy p, int connectTimeout, boolean useCache)
synchronized OutputStream	getOutputStream() Returns an output stream that writes to this connection.
int	getReadTimeout() Returns setting for read timeout.
synchronized Map	getRequestProperties() Returns an unmodifiable Map of general request properties for this connection.
String	getRequestProperty(String key) Returns the value of the named general request property for this connection.
static InputStream	openConnectionCheckRedirects(URLConnection c) opens a stream allowing redirects only to the same host.
void	plainConnect()
void	proxiedConnect(URL url, String proxyHost, int proxyPort, boolean useCache)
void	setConnectTimeout(int timeout) Sets a specified timeout value, in milliseconds, to be used when opening a communications link to the resource referenced by this URLConnection.
static void	setDefaultAuthenticator(HttpAuthenticator a)
void	setNewClient(URL url, boolean useCache) Obtain a HttpsClient object.
void	setNewClient(URL url) Create a new HttpClient object, bypassing the cache of HTTP client objects/connections.
void	setProxiedClient(URL url, String proxyHost, int proxyPort) Create a new HttpClient object, set up so that it uses per-instance proxying to the given HTTP proxy.
void	setProxiedClient(URL url, String proxyHost, int proxyPort, boolean useCache) Obtain a HttpClient object, set up so that it uses per-instance proxying to the given HTTP proxy.
void	setReadTimeout(int timeout) Sets the read timeout to a specified timeout, in milliseconds.
void	setRequestProperty(String key, String value) Sets request property.
boolean	usingProxy() Indicates if the connection is going through a proxy.

From class java.net.HttpURLConnection

abstract void	disconnect() Indicates that other requests to the server are unlikely in the near future.
InputStream	getErrorStream() Returns the error stream if the connection failed but the server sent useful data nonetheless.
static boolean	getFollowRedirects() Returns a `boolean` indicating whether or not HTTP redirects (3xx) should be automatically followed.
String	getHeaderField(int n) Returns the value for the `n`^th header field.
long	getHeaderFieldDate(String name, long Default) Returns the value of the named field parsed as date.
String	getHeaderFieldKey(int n) Returns the key for the `n`^th header field.
boolean	getInstanceFollowRedirects() Returns the value of this `HttpURLConnection`'s `instanceFollowRedirects` field.
Permission	getPermission() Returns a permission object representing the permission necessary to make the connection represented by this object.
String	getRequestMethod() Get the request method.
int	getResponseCode() Gets the status code from an HTTP response message.
String	getResponseMessage() Gets the HTTP response message, if any, returned along with the response code from a server.
void	setChunkedStreamingMode(int chunklen) This method is used to enable streaming of a HTTP request body without internal buffering, when the content length is not known in advance.
void	setFixedLengthStreamingMode(int contentLength) This method is used to enable streaming of a HTTP request body without internal buffering, when the content length is known in advance.
static void	setFollowRedirects(boolean set) Sets whether HTTP redirects (requests with response code 3xx) should be automatically followed by this class.
void	setInstanceFollowRedirects(boolean followRedirects) Sets whether HTTP redirects (requests with response code 3xx) should be automatically followed by this `HttpURLConnection` instance.
void	setRequestMethod(String method) Set the method for the URL request, one of: GET POST HEAD OPTIONS PUT DELETE TRACE are legal, subject to protocol restrictions.
abstract boolean	usingProxy() Indicates if the connection is going through a proxy.

From class java.net.URLConnection

void	addRequestProperty(String key, String value) Adds a general request property specified by a key-value pair.
abstract void	connect() Opens a communications link to the resource referenced by this URL, if such a connection has not already been established.
boolean	getAllowUserInteraction() Returns the value of the `allowUserInteraction` field for this object.
int	getConnectTimeout() Returns setting for connect timeout.
Object	getContent() Retrieves the contents of this URL connection.
Object	getContent(Class[] classes) Retrieves the contents of this URL connection.
String	getContentEncoding() Returns the value of the `content-encoding` header field.
int	getContentLength() Returns the value of the `content-length` header field.
String	getContentType() Returns the value of the `content-type` header field.
long	getDate() Returns the value of the `date` header field.
static boolean	getDefaultAllowUserInteraction() Returns the default value of the `allowUserInteraction` field.
static String	getDefaultRequestProperty(String key) This method is deprecated. The instance specific getRequestProperty method should be used after an appropriate instance of URLConnection is obtained.
boolean	getDefaultUseCaches() Returns the default value of a `URLConnection`'s `useCaches` flag.
boolean	getDoInput() Returns the value of this `URLConnection`'s `doInput` flag.
boolean	getDoOutput() Returns the value of this `URLConnection`'s `doOutput` flag.
long	getExpiration() Returns the value of the `expires` header field.
synchronized static FileNameMap	getFileNameMap() Loads filename map (a mimetable) from a data file.
String	getHeaderField(String name) Returns the value of the named header field.
String	getHeaderField(int n) Returns the value for the `n`^th header field.
long	getHeaderFieldDate(String name, long Default) Returns the value of the named field parsed as date.
int	getHeaderFieldInt(String name, int Default) Returns the value of the named field parsed as a number.
String	getHeaderFieldKey(int n) Returns the key for the `n`^th header field.
Map<String, List<String>>	getHeaderFields() Returns an unmodifiable Map of the header fields.
long	getIfModifiedSince() Returns the value of this object's `ifModifiedSince` field.
InputStream	getInputStream() Returns an input stream that reads from this open connection.
long	getLastModified() Returns the value of the `last-modified` header field.
OutputStream	getOutputStream() Returns an output stream that writes to this connection.
Permission	getPermission() Returns a permission object representing the permission necessary to make the connection represented by this object.
int	getReadTimeout() Returns setting for read timeout.
Map<String, List<String>>	getRequestProperties() Returns an unmodifiable Map of general request properties for this connection.
String	getRequestProperty(String key) Returns the value of the named general request property for this connection.
URL	getURL() Returns the value of this `URLConnection`'s `URL` field.
boolean	getUseCaches() Returns the value of this `URLConnection`'s `useCaches` field.
static String	guessContentTypeFromName(String fname) Tries to determine the content type of an object, based on the specified "file" component of a URL.
static String	guessContentTypeFromStream(InputStream is) Tries to determine the type of an input stream based on the characters at the beginning of the input stream.
void	setAllowUserInteraction(boolean allowuserinteraction) Set the value of the `allowUserInteraction` field of this `URLConnection`.
void	setConnectTimeout(int timeout) Sets a specified timeout value, in milliseconds, to be used when opening a communications link to the resource referenced by this URLConnection.
synchronized static void	setContentHandlerFactory(ContentHandlerFactory fac) Sets the `ContentHandlerFactory` of an application.
static void	setDefaultAllowUserInteraction(boolean defaultallowuserinteraction) Sets the default value of the `allowUserInteraction` field for all future `URLConnection` objects to the specified value.
static void	setDefaultRequestProperty(String key, String value) This method is deprecated. The instance specific setRequestProperty method should be used after an appropriate instance of URLConnection is obtained. Invoking this method will have no effect.
void	setDefaultUseCaches(boolean defaultusecaches) Sets the default value of the `useCaches` field to the specified value.
void	setDoInput(boolean doinput) Sets the value of the `doInput` field for this `URLConnection` to the specified value.
void	setDoOutput(boolean dooutput) Sets the value of the `doOutput` field for this `URLConnection` to the specified value.
static void	setFileNameMap(FileNameMap map) Sets the FileNameMap.
void	setIfModifiedSince(long ifmodifiedsince) Sets the value of the `ifModifiedSince` field of this `URLConnection` to the specified value.
void	setReadTimeout(int timeout) Sets the read timeout to a specified timeout, in milliseconds.
void	setRequestProperty(String key, String value) Sets the general request property.
void	setUseCaches(boolean usecaches) Sets the value of the `useCaches` field of this `URLConnection` to the specified value.
String	toString() Returns a `String` representation of this URL connection.

From class java.lang.Object

Object	clone() Creates and returns a copy of this object.
boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
final Class<?>	getClass() Returns the runtime class of this `Object`.
int	hashCode() Returns a hash code value for the object.
final void	notify() Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll() Wakes up all threads that are waiting on this object's monitor.
String	toString() Returns a string representation of the object.
final void	wait() Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.
final void	wait(long timeout, int nanos) Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.

Protected Constructors

protected AbstractDelegateHttpsURLConnection (URL url, Handler handler)

Throws

IOException

protected AbstractDelegateHttpsURLConnection (URL url, Proxy p, Handler handler)

Throws

IOException

Public Methods

public void connect ()

Implements the HTTP protocol handler's "connect" method, establishing an SSL connection to the server as necessary.

Throws

IOException

public String getCipherSuite ()

Returns the cipher suite in use on this connection.

public Certificate[] getLocalCertificates ()

Returns the certificate chain the client sent to the server, or null if the client did not authenticate.

public X509Certificate[] getServerCertificateChain ()

Returns the server's X.509 certificate chain, or null if the server did not authenticate.

Throws

SSLPeerUnverifiedException

public Certificate[] getServerCertificates ()

Returns the server's certificate chain, or throws SSLPeerUnverified Exception if the server did not authenticate.

Throws

SSLPeerUnverifiedException

public boolean isConnected ()

Used by subclass to access "connected" variable.

public void setConnected (boolean conn)

Used by subclass to access "connected" variable.

public void setNewClient (URL url)

Create a new HttpClient object, bypassing the cache of HTTP client objects/connections. Note: this method is changed from protected to public because the com.sun.ssl.internal.www.protocol.https handler reuses this class for its actual implemantation

Parameters

url	the URL being accessed

Throws

IOException

public void setNewClient (URL url, boolean useCache)

Obtain a HttpClient object. Use the cached copy if specified. Note: this method is changed from protected to public because the com.sun.ssl.internal.www.protocol.https handler reuses this class for its actual implemantation

Parameters

url	the URL being accessed
useCache	whether the cached connection should be used if present

Throws

IOException

public void setProxiedClient (URL url, String proxyHost, int proxyPort)

Create a new HttpClient object, set up so that it uses per-instance proxying to the given HTTP proxy. This bypasses the cache of HTTP client objects/connections. Note: this method is changed from protected to public because the com.sun.ssl.internal.www.protocol.https handler reuses this class for its actual implemantation

Parameters

url	the URL being accessed
proxyHost	the proxy host to use
proxyPort	the proxy port to use

Throws

IOException

public void setProxiedClient (URL url, String proxyHost, int proxyPort, boolean useCache)

Obtain a HttpClient object, set up so that it uses per-instance proxying to the given HTTP proxy. Use the cached copy of HTTP client objects/connections if specified. Note: this method is changed from protected to public because the com.sun.ssl.internal.www.protocol.https handler reuses this class for its actual implemantation

Parameters

url	the URL being accessed
proxyHost	the proxy host to use
proxyPort	the proxy port to use
useCache	whether the cached connection should be used if present

Throws

IOException

Protected Methods

protected abstract HostnameVerifier getHostnameVerifier ()

protected HttpClient getNewHttpClient (URL url, Proxy p, int connectTimeout)

Throws

IOException

protected HttpClient getNewHttpClient (URL url, Proxy p, int connectTimeout, boolean useCache)

Throws

IOException

protected abstract SSLSocketFactory getSSLSocketFactory ()

protected void proxiedConnect (URL url, String proxyHost, int proxyPort, boolean useCache)

Throws

IOException

Classes

AbstractDelegateHttpsURLConnection

Class Overview

Summary

Protected Constructors

protected AbstractDelegateHttpsURLConnection (URL url, Handler handler)

Throws

protected AbstractDelegateHttpsURLConnection (URL url, Proxy p, Handler handler)

Throws

Public Methods

public void connect ()

Throws

public String getCipherSuite ()

public Certificate[] getLocalCertificates ()

public X509Certificate[] getServerCertificateChain ()

Throws

public Certificate[] getServerCertificates ()

Throws

public boolean isConnected ()

public void setConnected (boolean conn)

public void setNewClient (URL url)

Parameters

Throws

public void setNewClient (URL url, boolean useCache)

Parameters

Throws

public void setProxiedClient (URL url, String proxyHost, int proxyPort)

Parameters

Throws

public void setProxiedClient (URL url, String proxyHost, int proxyPort, boolean useCache)

Parameters

Throws

Protected Methods

protected abstract HostnameVerifier getHostnameVerifier ()

protected HttpClient getNewHttpClient (URL url, Proxy p, int connectTimeout)

Throws

protected HttpClient getNewHttpClient (URL url, Proxy p, int connectTimeout, boolean useCache)

Throws

protected abstract SSLSocketFactory getSSLSocketFactory ()

protected void proxiedConnect (URL url, String proxyHost, int proxyPort, boolean useCache)

Throws