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_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

Fields
Modifier and Type	Field and Description
`protected DelegateHttpsURLConnection`	`delegate`

Constructor Summary

Constructors
Modifier Constructor and Description

protected HttpsURLConnectionImpl(URL u)

Constructors
Modifier	Constructor and Description
`protected`	`HttpsURLConnectionImpl(URL u)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addRequestProperty(String key, 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(Object obj)` Indicates whether some other object is "equal to" this one.
`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.
`long`	`getContentLengthLong()` Returns the value of the `content-length` header field as a long.
`String`	`getContentType()` Returns the value of the `content-type` header field.
`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.
`InputStream`	`getErrorStream()` Returns the error stream if the connection failed but the server sent useful data nonetheless.
`String`	`getHeaderField(int n)` Gets a header field by index.
`String`	`getHeaderField(String name)` Gets a header field by name.
`int`	`getHeaderFieldInt(String name, int Default)` Returns the value of the named field parsed as a number.
`String`	`getHeaderFieldKey(int n)` Gets a header field by index.
`long`	`getHeaderFieldLong(String name, long Default)` Returns the value of the named field parsed as a number.
`Map<String,List<String>>`	`getHeaderFields()` Returns an unmodifiable Map of the header fields.
`InputStream`	`getInputStream()` Returns an input stream that reads from this open connection.
`boolean`	`getInstanceFollowRedirects()` Returns the value of this `HttpURLConnection`'s `instanceFollowRedirects` field.
`OutputStream`	`getOutputStream()` Returns an output stream that writes to this connection.
`Permission`	`getPermission()` Returns a `SocketPermission` object representing the permission necessary to connect to the destination host and port.
`int`	`getReadTimeout()` Returns setting for read timeout.
`String`	`getRequestMethod()` Get the request method.
`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.
`int`	`getResponseCode()` Overwrite super class method
`String`	`getResponseMessage()` Gets the HTTP response message, if any, returned along with the response code from a server.
`URL`	`getURL()` Returns the value of this `URLConnection`'s `URL` field.
`boolean`	`getUseCaches()` Returns the value of this `URLConnection`'s `useCaches` field.
`int`	`hashCode()` Returns a hash code value for the object.
`protected boolean`	`isConnected()` Used by subclass to access "connected" variable.
`void`	`setAllowUserInteraction(boolean allowuserinteraction)` Set the value of the `allowUserInteraction` field of this `URLConnection`.
`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.
`protected void`	`setConnected(boolean conn)` Used by subclass to access "connected" variable.
`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.
`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.
`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.
`void`	`setFixedLengthStreamingMode(long contentLength)` This method is used to enable streaming of a HTTP request body without internal buffering, when the content length is known in advance.
`void`	`setInstanceFollowRedirects(boolean shouldFollow)` Sets whether HTTP redirects (requests with response code 3xx) should be automatically followed by this `HttpURLConnection` instance.
`protected void`	`setNewClient(URL url)` Create a new HttpClient object, bypassing the cache of HTTP client objects/connections.
`void`	`setReadTimeout(int timeout)` Sets the read timeout to a specified timeout, in milliseconds.
`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.
`void`	`setRequestProperty(String key, String value)` Sets 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.
`boolean`	`usingProxy()` Indicates if the connection is going through a proxy.

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, setContentHandlerFactory, setDefaultAllowUserInteraction

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(URL u)
                          throws IOException
```
    Throws:
    
    IOException
- Method Detail
  - addRequestProperty
```
public void addRequestProperty(String key,
                               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 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()
  - connect
```
public void connect()
             throws IOException
```
    Implements the HTTP protocol handler's "connect" method, establishing an SSL connection to the server as necessary.
    
    Specified by:
    
    connect in class URLConnection
    
    Throws:
    
    IOException - if an I/O error occurs while opening the connection.
    
    See Also:
    
    URLConnection.connected, URLConnection.getConnectTimeout(), URLConnection.setConnectTimeout(int)
  - disconnect
```
public void disconnect()
```
    Disconnect from the server.
    
    Specified by:
    
    disconnect in class HttpURLConnection
  - equals
```
public boolean equals(@Nullable
                      Object obj)
```
    Description copied from class: Object
    Indicates whether some other object is "equal to" this one.
    The equals method implements an equivalence relation on non-null object references:
    - It is reflexive: for any non-null reference value x, x.equals(x) should return true.
    - It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
    - It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
    - It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
    - For any non-null reference value x, x.equals(null) should return false.
    The equals method for class Object implements the most discriminating possible equivalence relation on objects; that is, for any non-null reference values x and y, this method returns true if and only if x and y refer to the same object (x == y has the value true).
    Note that it is generally necessary to override the hashCode method whenever this method is overridden, so as to maintain the general contract for the hashCode method, which states that equal objects must have equal hash codes.
    Overrides:
    
    equals in class Object
    
    Parameters:
    
    obj - the reference object with which to compare.
    
    Returns:
    
    true if this object is the same as the obj argument; false otherwise.
    
    See Also:
    
    Object.hashCode(), HashMap
  - getAllowUserInteraction
```
public boolean getAllowUserInteraction()
```
    Description copied from class: URLConnection
    
    Returns the value of the allowUserInteraction field for this object.
    
    Overrides:
    
    getAllowUserInteraction in class URLConnection
    
    Returns:
    
    the value of the allowUserInteraction field for this object.
    
    See Also:
    
    URLConnection.setAllowUserInteraction(boolean)
  - getConnectTimeout
```
public int getConnectTimeout()
```
    Description copied from class: URLConnection
    
    Returns setting for connect timeout.
    0 return implies that the option is disabled (i.e., timeout of infinity).
    
    Overrides:
    
    getConnectTimeout in class URLConnection
    
    Returns:
    
    an int that indicates the connect timeout value in milliseconds
    
    See Also:
    
    URLConnection.setConnectTimeout(int), URLConnection.connect()
  - getContent
```
public Object getContent()
                  throws IOException
```
    Description copied from class: URLConnection
    Retrieves the contents of this URL connection.
    This method first determines the content type of the object by calling the getContentType method. If this is the first time that the application has seen that specific content type, a content handler for that content type is created:
    1. If the application has set up a content handler factory instance using the setContentHandlerFactory method, the createContentHandler method of that instance is called with the content type as an argument; the result is a content handler for that content type.
    2. If no content handler factory has yet been set up, or if the factory's createContentHandler method returns null, then the application loads the class named:
      
      sun.net.www.content.<contentType>
      
      where <contentType> is formed by taking the content-type string, replacing all slash characters with a period ('.'), and all other non-alphanumeric characters with the underscore character ' _'. The alphanumeric characters are specifically the 26 uppercase ASCII letters 'A' through ' Z', the 26 lowercase ASCII letters 'a' through 'z', and the 10 ASCII digits '0' through '9'. If the specified class does not exist, or is not a subclass of ContentHandler, then an UnknownServiceException is thrown.
    Overrides:
    
    getContent in class URLConnection
    
    Returns:
    
    the object fetched. The instanceof operator should be used to determine the specific kind of object returned.
    
    Throws:
    
    IOException - if an I/O error occurs while getting the content.
    
    UnknownServiceException - if the protocol does not support the content type.
    
    See Also:
    
    ContentHandlerFactory.createContentHandler(java.lang.String), URLConnection.getContentType(), URLConnection.setContentHandlerFactory(java.net.ContentHandlerFactory)
  - getContent
```
@Nullable
public Object getContent(Class[] classes)
                            throws IOException
```
    Description copied from class: URLConnection
    
    Retrieves the contents of this URL connection.
    
    Overrides:
    
    getContent in class URLConnection
    
    Parameters:
    
    classes - the Class array indicating the requested types
    
    Returns:
    
    the object fetched that is the first match of the type specified in the classes array. null if none of the requested types are supported. The instanceof operator should be used to determine the specific kind of object returned.
    
    Throws:
    
    IOException - if an I/O error occurs while getting the content.
    
    UnknownServiceException - if the protocol does not support the content type.
    
    See Also:
    
    URLConnection.getContent(), ContentHandlerFactory.createContentHandler(java.lang.String), URLConnection.getContent(java.lang.Class[]), URLConnection.setContentHandlerFactory(java.net.ContentHandlerFactory)
  - getContentEncoding
```
@Nullable
public String getContentEncoding()
```
    Description copied from class: URLConnection
    
    Returns the value of the content-encoding header field.
    
    Overrides:
    
    getContentEncoding in class URLConnection
    
    Returns:
    
    the content encoding of the resource that the URL references, or null if not known.
    
    See Also:
    
    URLConnection.getHeaderField(java.lang.String)
  - getContentLength
```
public int getContentLength()
```
    Description copied from class: URLConnection
    
    Returns the value of the content-length header field.
    Note: getContentLengthLong() should be preferred over this method, since it returns a long instead and is therefore more portable.
    
    Overrides:
    
    getContentLength in class URLConnection
    
    Returns:
    
    the content length of the resource that this connection's URL references, -1 if the content length is not known, or if the content length is greater than Integer.MAX_VALUE.
  - getContentLengthLong
```
public long getContentLengthLong()
```
    Description copied from class: URLConnection
    
    Returns the value of the content-length header field as a long.
    
    Overrides:
    
    getContentLengthLong in class URLConnection
    
    Returns:
    
    the content length of the resource that this connection's URL references, or -1 if the content length is not known.
  - getContentType
```
@Nullable
public String getContentType()
```
    Description copied from class: URLConnection
    
    Returns the value of the content-type header field.
    
    Overrides:
    
    getContentType in class URLConnection
    
    Returns:
    
    the content type of the resource that the URL references, or null if not known.
    
    See Also:
    
    URLConnection.getHeaderField(java.lang.String)
  - getDefaultUseCaches
```
public boolean getDefaultUseCaches()
```
    Description copied from class: URLConnection
    
    Returns the default value of a URLConnection's useCaches flag.
    Ths default is "sticky", being a part of the static state of all URLConnections. This flag applies to the next, and all following URLConnections that are created.
    
    Overrides:
    
    getDefaultUseCaches in class URLConnection
    
    Returns:
    
    the default value of a URLConnection's useCaches flag.
    
    See Also:
    
    URLConnection.setDefaultUseCaches(boolean)
  - getDoInput
```
public boolean getDoInput()
```
    Description copied from class: URLConnection
    
    Returns the value of this URLConnection's doInput flag.
    
    Overrides:
    
    getDoInput in class URLConnection
    
    Returns:
    
    the value of this URLConnection's doInput flag.
    
    See Also:
    
    URLConnection.setDoInput(boolean)
  - getDoOutput
```
public boolean getDoOutput()
```
    Description copied from class: URLConnection
    
    Returns the value of this URLConnection's doOutput flag.
    
    Overrides:
    
    getDoOutput in class URLConnection
    
    Returns:
    
    the value of this URLConnection's doOutput flag.
    
    See Also:
    
    URLConnection.setDoOutput(boolean)
  - getErrorStream
```
@Nullable
public InputStream getErrorStream()
```
    Description copied from class: HttpURLConnection
    
    Returns the error stream if the connection failed but the server sent useful data nonetheless. The typical example is when an HTTP server responds with a 404, which will cause a FileNotFoundException to be thrown in connect, but the server sent an HTML help page with suggestions as to what to do.
    This method will not cause a connection to be initiated. If the connection was not connected, or if the server did not have an error while connecting or if the server had an error but no error data was sent, this method will return null. This is the default.
    
    Overrides:
    
    getErrorStream in class HttpURLConnection
    
    Returns:
    
    an error stream if any, null if there have been no errors, the connection is not connected or the server sent no useful data.
  - getHeaderField
```
@Nullable
public String getHeaderField(int n)
```
    Gets a header field by index. Returns null if not known.
    
    Overrides:
    
    getHeaderField in class HttpURLConnection
    
    Parameters:
    
    n - the index of the header field
    
    Returns:
    
    the value of the n^th header field, or null if the value does not exist.
    
    See Also:
    
    HttpURLConnection.getHeaderFieldKey(int)
  - getHeaderField
```
@Nullable
public String getHeaderField(String name)
```
    Gets a header field by name. Returns null if not known.
    
    Overrides:
    
    getHeaderField in class URLConnection
    
    Parameters:
    
    name - the name of the header field
    
    Returns:
    
    the value of the named header field, or null if there is no such field in the header.
  - getHeaderFieldInt
```
public int getHeaderFieldInt(String name,
                             int Default)
```
    Description copied from class: URLConnection
    
    Returns the value of the named field parsed as a number.
    This form of getHeaderField exists because some connection types (e.g., http-ng) have pre-parsed headers. Classes for that connection type can override this method and short-circuit the parsing.
    
    Overrides:
    
    getHeaderFieldInt in class URLConnection
    
    Parameters:
    
    name - the name of the header field.
    
    Default - the default value.
    
    Returns:
    
    the value of the named field, parsed as an integer. The Default value is returned if the field is missing or malformed.
  - getHeaderFieldKey
```
@Nullable
public String getHeaderFieldKey(int n)
```
    Gets a header field by index. Returns null if not known.
    
    Overrides:
    
    getHeaderFieldKey in class HttpURLConnection
    
    Parameters:
    
    n - the index of the header field
    
    Returns:
    
    the key for the n^th header field, or null if the key does not exist.
  - getHeaderFieldLong
```
public long getHeaderFieldLong(String name,
                               long Default)
```
    Description copied from class: URLConnection
    
    Returns the value of the named field parsed as a number.
    This form of getHeaderField exists because some connection types (e.g., http-ng) have pre-parsed headers. Classes for that connection type can override this method and short-circuit the parsing.
    
    Overrides:
    
    getHeaderFieldLong in class URLConnection
    
    Parameters:
    
    name - the name of the header field.
    
    Default - the default value.
    
    Returns:
    
    the value of the named field, parsed as a long. The Default value is returned if the field is missing or malformed.
  - getHeaderFields
```
public Map<String,List<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 URLConnection
    
    Returns:
    
    a Map of header fields
    
    Since:
    
    1.4
  - getInputStream
```
public InputStream getInputStream()
                           throws IOException
```
    Description copied from class: URLConnection
    
    Returns an input stream that reads from this open connection. A SocketTimeoutException can be thrown when reading from the returned input stream if the read timeout expires before data is available for read.
    
    Overrides:
    
    getInputStream in class URLConnection
    
    Returns:
    
    an input stream that reads from this open connection.
    
    Throws:
    
    IOException - if an I/O error occurs while creating the input stream.
    
    UnknownServiceException - if the protocol does not support input.
    
    See Also:
    
    URLConnection.setReadTimeout(int), URLConnection.getReadTimeout()
  - getInstanceFollowRedirects
```
public boolean getInstanceFollowRedirects()
```
    Description copied from class: HttpURLConnection
    
    Returns the value of this HttpURLConnection's instanceFollowRedirects field.
    
    Overrides:
    
    getInstanceFollowRedirects in class HttpURLConnection
    
    Returns:
    
    the value of this HttpURLConnection's instanceFollowRedirects field.
    
    See Also:
    
    HttpURLConnection.instanceFollowRedirects, HttpURLConnection.setInstanceFollowRedirects(boolean)
  - getOutputStream
```
public OutputStream getOutputStream()
                             throws IOException
```
    Description copied from class: URLConnection
    
    Returns an output stream that writes to this connection.
    
    Overrides:
    
    getOutputStream in class URLConnection
    
    Returns:
    
    an output stream that writes to this connection.
    
    Throws:
    
    IOException - if an I/O error occurs while creating the output stream.
    
    UnknownServiceException - if the protocol does not support output.
  - getPermission
```
public Permission getPermission()
                         throws IOException
```
    Description copied from class: HttpURLConnection
    
    Returns a SocketPermission object representing the permission necessary to connect to the destination host and port.
    
    Overrides:
    
    getPermission in class HttpURLConnection
    
    Returns:
    
    a SocketPermission object representing the permission necessary to connect to the destination host and port.
    
    Throws:
    
    IOException - if an error occurs while computing the permission.
  - getReadTimeout
```
public int getReadTimeout()
```
    Description copied from class: URLConnection
    
    Returns setting for read timeout. 0 return implies that the option is disabled (i.e., timeout of infinity).
    
    Overrides:
    
    getReadTimeout in class URLConnection
    
    Returns:
    
    an int that indicates the read timeout value in milliseconds
    
    See Also:
    
    URLConnection.setReadTimeout(int), InputStream.read()
  - getRequestMethod
```
public String getRequestMethod()
```
    Description copied from class: HttpURLConnection
    
    Get the request method.
    
    Overrides:
    
    getRequestMethod in class HttpURLConnection
    
    Returns:
    
    the HTTP request method
    
    See Also:
    
    HttpURLConnection.setRequestMethod(java.lang.String)
  - getRequestProperties
```
public Map<String,List<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 URLConnection
    
    Returns:
    
    a Map of the general request properties for this connection.
    
    Throws:
    
    IllegalStateException - if already connected
    
    Since:
    
    1.4
  - getRequestProperty
```
@Nullable
public String getRequestProperty(String key)
```
    Description copied from class: URLConnection
    
    Returns the value of the named general request property for this connection.
    
    Overrides:
    
    getRequestProperty in class URLConnection
    
    Parameters:
    
    key - the keyword by which the request is known (e.g., "Accept").
    
    Returns:
    
    the value of the named general request property for this connection. If key is null, then null is returned.
    
    See Also:
    
    URLConnection.setRequestProperty(java.lang.String, java.lang.String)
  - getResponseCode
```
public int getResponseCode()
                    throws IOException
```
    Overwrite super class method
    
    Overrides:
    
    getResponseCode in class HttpURLConnection
    
    Returns:
    
    the HTTP Status-Code, or -1
    
    Throws:
    
    IOException - if an error occurred connecting to the server.
  - getResponseMessage
```
@Nullable
public String getResponseMessage()
                                    throws IOException
```
    Description copied from class: HttpURLConnection
    Gets the HTTP response message, if any, returned along with the response code from a server. From responses like:
```
 HTTP/1.0 200 OK
 HTTP/1.0 404 Not Found
 
```
    Extracts the Strings "OK" and "Not Found" respectively. Returns null if none could be discerned from the responses (the result was not valid HTTP).
    Overrides:
    
    getResponseMessage in class HttpURLConnection
    
    Returns:
    
    the HTTP response message, or null
    
    Throws:
    
    IOException - if an error occurred connecting to the server.
  - getURL
```
public URL getURL()
```
    Description copied from class: URLConnection
    
    Returns the value of this URLConnection's URL field.
    
    Overrides:
    
    getURL in class URLConnection
    
    Returns:
    
    the value of this URLConnection's URL field.
    
    See Also:
    
    URLConnection.url
  - getUseCaches
```
public boolean getUseCaches()
```
    Description copied from class: URLConnection
    
    Returns the value of this URLConnection's useCaches field.
    
    Overrides:
    
    getUseCaches in class URLConnection
    
    Returns:
    
    the value of this URLConnection's useCaches field.
    
    See Also:
    
    URLConnection.setUseCaches(boolean)
  - hashCode
```
public int hashCode()
```
    Description copied from class: Object
    Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by HashMap.
    The general contract of hashCode is:
    - Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
    - If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.
    - It is not required that if two objects are unequal according to the Object.equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.
    As much as is reasonably practical, the hashCode method defined by class Object does return distinct integers for distinct objects. (This is typically implemented by converting the internal address of the object into an integer, but this implementation technique is not required by the Java^TM programming language.)
    Overrides:
    
    hashCode in class Object
    
    Returns:
    
    a hash code value for this object.
    
    See Also:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - 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.
  - setAllowUserInteraction
```
public void setAllowUserInteraction(boolean allowuserinteraction)
```
    Description copied from class: URLConnection
    
    Set the value of the allowUserInteraction field of this URLConnection.
    
    Overrides:
    
    setAllowUserInteraction in class URLConnection
    
    Parameters:
    
    allowuserinteraction - the new value.
    
    See Also:
    
    URLConnection.getAllowUserInteraction()
  - setChunkedStreamingMode
```
public void setChunkedStreamingMode(int chunklen)
```
    Description copied from class: HttpURLConnection
    
    This method is used to enable streaming of a HTTP request body without internal buffering, when the content length is not known in advance. In this mode, chunked transfer encoding is used to send the request body. Note, not all HTTP servers support this mode.
    When output streaming is enabled, authentication and redirection cannot be handled automatically. A HttpRetryException will be thrown when reading the response if authentication or redirection are required. This exception can be queried for the details of the error.
    This method must be called before the URLConnection is connected.
    
    Overrides:
    
    setChunkedStreamingMode in class HttpURLConnection
    
    Parameters:
    
    chunklen - The number of bytes to write in each chunk. If chunklen is less than or equal to zero, a default value will be used.
    
    See Also:
    
    HttpURLConnection.setFixedLengthStreamingMode(int)
  - 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.
  - setConnectTimeout
```
public void setConnectTimeout(int timeout)
```
    Description copied from class: URLConnection
    
    Sets a specified timeout value, in milliseconds, to be used when opening a communications link to the resource referenced by this URLConnection. If the timeout expires before the connection can be established, a java.net.SocketTimeoutException is raised. A timeout of zero is interpreted as an infinite timeout.
    Some non-standard implementation of this method may ignore the specified timeout. To see the connect timeout set, please call getConnectTimeout().
    
    Overrides:
    
    setConnectTimeout in class URLConnection
    
    Parameters:
    
    timeout - an int that specifies the connect timeout value in milliseconds
    
    See Also:
    
    URLConnection.getConnectTimeout(), URLConnection.connect()
  - setDefaultUseCaches
```
public void setDefaultUseCaches(boolean defaultusecaches)
```
    Description copied from class: URLConnection
    
    Sets the default value of the useCaches field to the specified value.
    
    Overrides:
    
    setDefaultUseCaches in class URLConnection
    
    Parameters:
    
    defaultusecaches - the new value.
    
    See Also:
    
    URLConnection.getDefaultUseCaches()
  - setDoInput
```
public void setDoInput(boolean doinput)
```
    Description copied from class: URLConnection
    
    Sets the value of the doInput field for this URLConnection to the specified value.
    A URL connection can be used for input and/or output. Set the DoInput flag to true if you intend to use the URL connection for input, false if not. The default is true.
    
    Overrides:
    
    setDoInput in class URLConnection
    
    Parameters:
    
    doinput - the new value.
    
    See Also:
    
    URLConnection.doInput, URLConnection.getDoInput()
  - setDoOutput
```
public void setDoOutput(boolean dooutput)
```
    Description copied from class: URLConnection
    
    Sets the value of the doOutput field for this URLConnection to the specified value.
    A URL connection can be used for input and/or output. Set the DoOutput flag to true if you intend to use the URL connection for output, false if not. The default is false.
    
    Overrides:
    
    setDoOutput in class URLConnection
    
    Parameters:
    
    dooutput - the new value.
    
    See Also:
    
    URLConnection.getDoOutput()
  - setFixedLengthStreamingMode
```
public void setFixedLengthStreamingMode(int contentLength)
```
    Description copied from class: HttpURLConnection
    
    This method is used to enable streaming of a HTTP request body without internal buffering, when the content length is known in advance.
    An exception will be thrown if the application attempts to write more data than the indicated content-length, or if the application closes the OutputStream before writing the indicated amount.
    When output streaming is enabled, authentication and redirection cannot be handled automatically. A HttpRetryException will be thrown when reading the response if authentication or redirection are required. This exception can be queried for the details of the error.
    This method must be called before the URLConnection is connected.
    NOTE: HttpURLConnection.setFixedLengthStreamingMode(long) is recommended instead of this method as it allows larger content lengths to be set.
    
    Overrides:
    
    setFixedLengthStreamingMode in class HttpURLConnection
    
    Parameters:
    
    contentLength - The number of bytes which will be written to the OutputStream.
    
    See Also:
    
    HttpURLConnection.setChunkedStreamingMode(int)
  - setFixedLengthStreamingMode
```
public void setFixedLengthStreamingMode(long contentLength)
```
    Description copied from class: HttpURLConnection
    
    This method is used to enable streaming of a HTTP request body without internal buffering, when the content length is known in advance.
    An exception will be thrown if the application attempts to write more data than the indicated content-length, or if the application closes the OutputStream before writing the indicated amount.
    When output streaming is enabled, authentication and redirection cannot be handled automatically. A HttpRetryException will be thrown when reading the response if authentication or redirection are required. This exception can be queried for the details of the error.
    This method must be called before the URLConnection is connected.
    The content length set by invoking this method takes precedence over any value set by HttpURLConnection.setFixedLengthStreamingMode(int).
    
    Overrides:
    
    setFixedLengthStreamingMode in class HttpURLConnection
    
    Parameters:
    
    contentLength - The number of bytes which will be written to the OutputStream.
  - setInstanceFollowRedirects
```
public void setInstanceFollowRedirects(boolean shouldFollow)
```
    Description copied from class: HttpURLConnection
    
    Sets whether HTTP redirects (requests with response code 3xx) should be automatically followed by this HttpURLConnection instance.
    The default value comes from followRedirects, which defaults to true.
    
    Overrides:
    
    setInstanceFollowRedirects in class HttpURLConnection
    
    Parameters:
    
    shouldFollow - a boolean indicating whether or not to follow HTTP redirects.
    
    See Also:
    
    HttpURLConnection.instanceFollowRedirects, HttpURLConnection.getInstanceFollowRedirects()
  - setNewClient
```
protected void setNewClient(URL url)
                     throws IOException
```
    Create a new HttpClient object, bypassing the cache of HTTP client objects/connections.
    
    Parameters:
    
    url - the URL being accessed
    
    Throws:
    
    IOException
  - setReadTimeout
```
public void setReadTimeout(int timeout)
```
    Description copied from class: URLConnection
    
    Sets the read timeout to a specified timeout, in milliseconds. A non-zero value specifies the timeout when reading from Input stream when a connection is established to a resource. If the timeout expires before there is data available for read, a java.net.SocketTimeoutException is raised. A timeout of zero is interpreted as an infinite timeout.
    Some non-standard implementation of this method ignores the specified timeout. To see the read timeout set, please call getReadTimeout().
    
    Overrides:
    
    setReadTimeout in class URLConnection
    
    Parameters:
    
    timeout - an int that specifies the timeout value to be used in milliseconds
    
    See Also:
    
    URLConnection.getReadTimeout(), InputStream.read()
  - setRequestMethod
```
public void setRequestMethod(String method)
                      throws ProtocolException
```
    Description copied from class: HttpURLConnection
    Set the method for the URL request, one of:
    - GET
    - POST
    - HEAD
    - OPTIONS
    - PUT
    - DELETE
    - TRACE
    are legal, subject to protocol restrictions. The default method is GET.
    Overrides:
    
    setRequestMethod in class HttpURLConnection
    
    Parameters:
    
    method - the HTTP method
    
    Throws:
    
    ProtocolException - if the method cannot be reset or if the requested method isn't valid for HTTP.
    
    See Also:
    
    HttpURLConnection.getRequestMethod()
  - setRequestProperty
```
public void setRequestProperty(String key,
                               String value)
```
    Sets request property. If a property with the key already exists, overwrite its value with the new value.
    
    Overrides:
    
    setRequestProperty in class URLConnection
    
    Parameters:
    
    value - the value to be set
    
    key - the keyword by which the request is known (e.g., "Accept").
    
    See Also:
    
    URLConnection.getRequestProperty(java.lang.String)
  - setUseCaches
```
public void setUseCaches(boolean usecaches)
```
    Description copied from class: URLConnection
    
    Sets the value of the useCaches field of this URLConnection to the specified value.
    Some protocols do caching of documents. Occasionally, it is important to be able to "tunnel through" and ignore the caches (e.g., the "reload" button in a browser). If the UseCaches flag on a connection is true, the connection is allowed to use whatever caches it can. If false, caches are to be ignored. The default value comes from DefaultUseCaches, which defaults to true.
    
    Overrides:
    
    setUseCaches in class URLConnection
    
    Parameters:
    
    usecaches - a boolean indicating whether or not to allow caching
    
    See Also:
    
    URLConnection.getUseCaches()
  - toString
```
public String toString()
```
    Description copied from class: URLConnection
    
    Returns a String representation of this URL connection.
    
    Overrides:
    
    toString in class URLConnection
    
    Returns:
    
    a string representation of this URLConnection.
  - usingProxy
```
public boolean usingProxy()
```
    Description copied from class: HttpURLConnection
    
    Indicates if the connection is going through a proxy.
    
    Specified by:
    
    usingProxy in class HttpURLConnection
    
    Returns:
    
    a boolean indicating if the connection is using a proxy.

Class HttpsURLConnectionImpl

Field Summary

Fields inherited from class java.net.HttpURLConnection

Fields inherited from class java.net.URLConnection

Constructor Summary

Method Summary

Methods inherited from class javax.net.ssl.HttpsURLConnection

Methods inherited from class java.net.HttpURLConnection

Methods inherited from class java.net.URLConnection

Methods inherited from class java.lang.Object

Field Detail

delegate

Constructor Detail

HttpsURLConnectionImpl

Method Detail

addRequestProperty

connect

disconnect

equals

getAllowUserInteraction

getConnectTimeout

getContent

getContent

getContentEncoding

getContentLength

getContentLengthLong

getContentType

getDefaultUseCaches

getDoInput

getDoOutput

getErrorStream

getHeaderField

getHeaderField

getHeaderFieldInt

getHeaderFieldKey

getHeaderFieldLong

getHeaderFields

getInputStream

getInstanceFollowRedirects

getOutputStream

getPermission

getReadTimeout

getRequestMethod

getRequestProperties

getRequestProperty

getResponseCode

getResponseMessage

getURL

getUseCaches

hashCode

isConnected

setAllowUserInteraction

setChunkedStreamingMode

setConnected

setConnectTimeout

setDefaultUseCaches

setDoInput

setDoOutput

setFixedLengthStreamingMode

setFixedLengthStreamingMode

setInstanceFollowRedirects

setNewClient

setReadTimeout

setRequestMethod

setRequestProperty

setUseCaches

toString

usingProxy