sun.net.www.protocol.https

Class HttpsURLConnectionImpl

java.lang.Object

java.net.URLConnection

java.net.HttpURLConnection

javax.net.ssl.HttpsURLConnection

sun.net.www.protocol.https.HttpsURLConnectionImpl

public class HttpsURLConnectionImpl
extends HttpsURLConnection

A class to represent an HTTP connection to a remote object. Ideally, this class should subclass and inherit the http handler implementation, but it can't do so because that class have the wrong Java Type. Thus it uses the delegate (aka, the Adapter/Wrapper design pattern) to reuse code from the http handler. Since it would use a delegate to access sun.net.www.protocol.http.HttpURLConnection functionalities, it needs to implement all public methods in it's super class and all the way to Object.

Field Summary

Fields

Modifier and Type	Field and Description
protected DelegateHttpsURLConnection	delegate

Fields inherited from class java.net.HttpURLConnection

chunkLength, fixedContentLength, fixedContentLengthLong, HTTP_ACCEPTED, HTTP_BAD_GATEWAY, HTTP_BAD_METHOD, HTTP_BAD_REQUEST, HTTP_CLIENT_TIMEOUT, HTTP_CONFLICT, HTTP_CREATED, HTTP_ENTITY_TOO_LARGE, HTTP_FORBIDDEN, HTTP_GATEWAY_TIMEOUT, HTTP_GONE, HTTP_INTERNAL_ERROR, HTTP_LENGTH_REQUIRED, HTTP_MOVED_PERM, HTTP_MOVED_TEMP, HTTP_MULT_CHOICE, HTTP_NO_CONTENT, HTTP_NOT_ACCEPTABLE, HTTP_NOT_AUTHORITATIVE, HTTP_NOT_FOUND, HTTP_NOT_IMPLEMENTED, HTTP_NOT_MODIFIED, HTTP_OK, HTTP_PARTIAL, HTTP_PAYMENT_REQUIRED, HTTP_PRECON_FAILED, HTTP_PROXY_AUTH, HTTP_REQ_TOO_LONG, HTTP_RESET, HTTP_SEE_OTHER, HTTP_SERVER_ERROR, HTTP_UNAUTHORIZED, HTTP_UNAVAILABLE, HTTP_UNSUPPORTED_TYPE, HTTP_USE_PROXY, HTTP_VERSION, instanceFollowRedirects, method, responseCode, responseMessage

Fields inherited from class java.net.URLConnection

allowUserInteraction, connected, doInput, doOutput, url, useCaches

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	HttpsURLConnectionImpl(java.net.URL u)

Method Summary

Modifier and Type	Method and Description
void	addRequestProperty(java.lang.String key, java.lang.String value) Adds a general request property specified by a key-value pair.
void	connect() Implements the HTTP protocol handler's "connect" method, establishing an SSL connection to the server as necessary.
void	disconnect() Disconnect from the server.
boolean	equals(java.lang.Object obj)
boolean	getAllowUserInteraction()
int	getConnectTimeout()
java.lang.Object	getContent()
java.lang.Object	getContent(java.lang.Class[] classes)
java.lang.String	getContentEncoding()
int	getContentLength()
long	getContentLengthLong()
java.lang.String	getContentType()
boolean	getDefaultUseCaches()
boolean	getDoInput()
boolean	getDoOutput()
java.io.InputStream	getErrorStream()
java.lang.String	getHeaderField(int n) Gets a header field by index.
java.lang.String	getHeaderField(java.lang.String name) Gets a header field by name.
int	getHeaderFieldInt(java.lang.String name, int Default)
java.lang.String	getHeaderFieldKey(int n) Gets a header field by index.
long	getHeaderFieldLong(java.lang.String name, long Default)
java.util.Map<java.lang.String,java.util.List<java.lang.String>>	getHeaderFields() Returns an unmodifiable Map of the header fields.
java.io.InputStream	getInputStream()
boolean	getInstanceFollowRedirects()
java.io.OutputStream	getOutputStream()
java.security.Permission	getPermission()
int	getReadTimeout()
java.lang.String	getRequestMethod()
java.util.Map<java.lang.String,java.util.List<java.lang.String>>	getRequestProperties() Returns an unmodifiable Map of general request properties for this connection.
java.lang.String	getRequestProperty(java.lang.String key)
int	getResponseCode() Overwrite super class method
java.lang.String	getResponseMessage()
java.net.URL	getURL()
boolean	getUseCaches()
int	hashCode()
protected boolean	isConnected() Used by subclass to access "connected" variable.
void	setAllowUserInteraction(boolean allowuserinteraction)
void	setChunkedStreamingMode(int chunklen)
protected void	setConnected(boolean conn) Used by subclass to access "connected" variable.
void	setConnectTimeout(int timeout)
void	setDefaultUseCaches(boolean defaultusecaches)
void	setDoInput(boolean doinput)
void	setDoOutput(boolean dooutput)
void	setFixedLengthStreamingMode(int contentLength)
void	setFixedLengthStreamingMode(long contentLength)
void	setInstanceFollowRedirects(boolean shouldFollow)
protected void	setNewClient(java.net.URL url) Create a new HttpClient object, bypassing the cache of HTTP client objects/connections.
void	setReadTimeout(int timeout)
void	setRequestMethod(java.lang.String method)
void	setRequestProperty(java.lang.String key, java.lang.String value) Sets request property.
void	setUseCaches(boolean usecaches)
java.lang.String	toString()
boolean	usingProxy()

Methods inherited from class javax.net.ssl.HttpsURLConnection

getDefaultSSLSocketFactory, getSSLSocketFactory, setDefaultSSLSocketFactory, setSSLSocketFactory

Methods inherited from class java.net.HttpURLConnection

getFollowRedirects, setFollowRedirects

Methods inherited from class java.net.URLConnection

getDefaultAllowUserInteraction, getDefaultRequestProperty, setContentHandlerFactory, setDefaultAllowUserInteraction, setDefaultRequestProperty

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, wait, wait, wait

Field Detail

delegate

protected DelegateHttpsURLConnection delegate

Constructor Detail

HttpsURLConnectionImpl

protected HttpsURLConnectionImpl(java.net.URL u)
                          throws java.io.IOException

Throws:

java.io.IOException

Method Detail

setNewClient

protected void setNewClient(java.net.URL url)
                     throws java.io.IOException

Create a new HttpClient object, bypassing the cache of HTTP client objects/connections.

Parameters:

url - the URL being accessed

Throws:

java.io.IOException

connect

public void connect()
             throws java.io.IOException

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

Specified by:

connect in class java.net.URLConnection

Throws:

java.io.IOException

isConnected

protected boolean isConnected()

Used by subclass to access "connected" variable. Since we are delegating the actual implementation to "delegate", we need to delegate the access of "connected" as well.

setConnected

protected void setConnected(boolean conn)

Used by subclass to access "connected" variable. Since we are delegating the actual implementation to "delegate", we need to delegate the access of "connected" as well.

getOutputStream

public java.io.OutputStream getOutputStream()
                                     throws java.io.IOException

Overrides:

getOutputStream in class java.net.URLConnection

Throws:

java.io.IOException

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.io.IOException

Overrides:

getInputStream in class java.net.URLConnection

Throws:

java.io.IOException

getErrorStream

@Nullable
public java.io.InputStream getErrorStream()

Overrides:

getErrorStream in class java.net.HttpURLConnection

disconnect

public void disconnect()

Disconnect from the server.

Specified by:

disconnect in class java.net.HttpURLConnection

usingProxy

public boolean usingProxy()

Specified by:

usingProxy in class java.net.HttpURLConnection

getHeaderFields

public java.util.Map<java.lang.String,java.util.List<java.lang.String>> getHeaderFields()

Returns an unmodifiable Map of the header fields. The Map keys are Strings that represent the response-header field names. Each Map value is an unmodifiable List of Strings that represents the corresponding field values.

Overrides:

getHeaderFields in class java.net.URLConnection

Returns:

a Map of header fields

Since:

1.4

getHeaderField

@Nullable
public java.lang.String getHeaderField(java.lang.String name)

Gets a header field by name. Returns null if not known.

Overrides:

getHeaderField in class java.net.URLConnection

Parameters:

name - the name of the header field

getHeaderField

@Nullable
public java.lang.String getHeaderField(int n)

Gets a header field by index. Returns null if not known.

Overrides:

getHeaderField in class java.net.HttpURLConnection

Parameters:

n - the index of the header field

getHeaderFieldKey

@Nullable
public java.lang.String getHeaderFieldKey(int n)

Gets a header field by index. Returns null if not known.

Overrides:

getHeaderFieldKey in class java.net.HttpURLConnection

Parameters:

n - the index of the header field

setRequestProperty

public void setRequestProperty(java.lang.String key,
                               java.lang.String value)

Sets request property. If a property with the key already exists, overwrite its value with the new value.

Overrides:

setRequestProperty in class java.net.URLConnection

Parameters:

value - the value to be set

addRequestProperty

public void addRequestProperty(java.lang.String key,
                               java.lang.String value)

Adds a general request property specified by a key-value pair. This method will not overwrite existing values associated with the same key.

Overrides:

addRequestProperty in class java.net.URLConnection

Parameters:

key - the keyword by which the request is known (e.g., "accept").

value - the value associated with it.

Since:

1.4

See Also:

getRequestProperties()

getResponseCode

public int getResponseCode()
                    throws java.io.IOException

Overwrite super class method

Overrides:

getResponseCode in class java.net.HttpURLConnection

Throws:

java.io.IOException

getRequestProperty

@Nullable
public java.lang.String getRequestProperty(java.lang.String key)

Overrides:

getRequestProperty in class java.net.URLConnection

getRequestProperties

public java.util.Map<java.lang.String,java.util.List<java.lang.String>> getRequestProperties()

Returns an unmodifiable Map of general request properties for this connection. The Map keys are Strings that represent the request-header field names. Each Map value is a unmodifiable List of Strings that represents the corresponding field values.

Overrides:

getRequestProperties in class java.net.URLConnection

Returns:

a Map of the general request properties for this connection.

Throws:

java.lang.IllegalStateException - if already connected

Since:

1.4

setInstanceFollowRedirects

public void setInstanceFollowRedirects(boolean shouldFollow)

Overrides:

setInstanceFollowRedirects in class java.net.HttpURLConnection

getInstanceFollowRedirects

public boolean getInstanceFollowRedirects()

Overrides:

getInstanceFollowRedirects in class java.net.HttpURLConnection

setRequestMethod

public void setRequestMethod(java.lang.String method)
                      throws java.net.ProtocolException

Overrides:

setRequestMethod in class java.net.HttpURLConnection

Throws:

java.net.ProtocolException

getRequestMethod

public java.lang.String getRequestMethod()

Overrides:

getRequestMethod in class java.net.HttpURLConnection

getResponseMessage

@Nullable
public java.lang.String getResponseMessage()
                                               throws java.io.IOException

Overrides:

getResponseMessage in class java.net.HttpURLConnection

Throws:

java.io.IOException

getPermission

public java.security.Permission getPermission()
                                       throws java.io.IOException

Overrides:

getPermission in class java.net.HttpURLConnection

Throws:

java.io.IOException

getURL

public java.net.URL getURL()

Overrides:

getURL in class java.net.URLConnection

getContentLength

public int getContentLength()

Overrides:

getContentLength in class java.net.URLConnection

getContentLengthLong

public long getContentLengthLong()

Overrides:

getContentLengthLong in class java.net.URLConnection

getContentType

@Nullable
public java.lang.String getContentType()

Overrides:

getContentType in class java.net.URLConnection

getContentEncoding

@Nullable
public java.lang.String getContentEncoding()

Overrides:

getContentEncoding in class java.net.URLConnection

getHeaderFieldInt

public int getHeaderFieldInt(java.lang.String name,
                             int Default)

Overrides:

getHeaderFieldInt in class java.net.URLConnection

getHeaderFieldLong

public long getHeaderFieldLong(java.lang.String name,
                               long Default)

Overrides:

getHeaderFieldLong in class java.net.URLConnection

getContent

public java.lang.Object getContent()
                            throws java.io.IOException

Overrides:

getContent in class java.net.URLConnection

Throws:

java.io.IOException

getContent

@Nullable
public java.lang.Object getContent(java.lang.Class[] classes)
                                       throws java.io.IOException

Overrides:

getContent in class java.net.URLConnection

Throws:

java.io.IOException

toString

public java.lang.String toString()

Overrides:

toString in class java.net.URLConnection

setDoInput

public void setDoInput(boolean doinput)

Overrides:

setDoInput in class java.net.URLConnection

getDoInput

public boolean getDoInput()

Overrides:

getDoInput in class java.net.URLConnection

setDoOutput

public void setDoOutput(boolean dooutput)

Overrides:

setDoOutput in class java.net.URLConnection

getDoOutput

public boolean getDoOutput()

Overrides:

getDoOutput in class java.net.URLConnection

setAllowUserInteraction

public void setAllowUserInteraction(boolean allowuserinteraction)

Overrides:

setAllowUserInteraction in class java.net.URLConnection

getAllowUserInteraction

public boolean getAllowUserInteraction()

Overrides:

getAllowUserInteraction in class java.net.URLConnection

setUseCaches

public void setUseCaches(boolean usecaches)

Overrides:

setUseCaches in class java.net.URLConnection

getUseCaches

public boolean getUseCaches()

Overrides:

getUseCaches in class java.net.URLConnection

getDefaultUseCaches

public boolean getDefaultUseCaches()

Overrides:

getDefaultUseCaches in class java.net.URLConnection

setDefaultUseCaches

public void setDefaultUseCaches(boolean defaultusecaches)

Overrides:

setDefaultUseCaches in class java.net.URLConnection

equals

public boolean equals(@Nullable
                      java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

setConnectTimeout

public void setConnectTimeout(int timeout)

Overrides:

setConnectTimeout in class java.net.URLConnection

getConnectTimeout

public int getConnectTimeout()

Overrides:

getConnectTimeout in class java.net.URLConnection

setReadTimeout

public void setReadTimeout(int timeout)

Overrides:

setReadTimeout in class java.net.URLConnection

getReadTimeout

public int getReadTimeout()

Overrides:

getReadTimeout in class java.net.URLConnection

setFixedLengthStreamingMode

public void setFixedLengthStreamingMode(int contentLength)

Overrides:

setFixedLengthStreamingMode in class java.net.HttpURLConnection

setFixedLengthStreamingMode

public void setFixedLengthStreamingMode(long contentLength)

Overrides:

setFixedLengthStreamingMode in class java.net.HttpURLConnection

setChunkedStreamingMode

public void setChunkedStreamingMode(int chunklen)

Overrides:

setChunkedStreamingMode in class java.net.HttpURLConnection