java.lang.Objectjava.net.URLConnection
java.net.HttpURLConnection
javax.net.ssl.HttpsURLConnection
HttpsURLConnection
extends HttpURLConnection
with support for https-specific features.
See http://www.w3.org/pub/WWW/Protocols/ and RFC 2818 for more details on the https specification.
This class uses HostnameVerifier
and
SSLSocketFactory
.
There are default implementations defined for both classes.
However, the implementations can be replaced on a per-class (static) or
per-instance basis. All new HttpsURLConnection
s instances
will be assigned
the "default" static values at instance creation, but they can be overriden
by calling the appropriate per-instance set method(s) before
connect
ing.
1.4
- Field Summary | ||
---|---|---|
protected HostnameVerifier | hostnameVerifier | The hostnameVerifier for this object. |
Fields inherited from java.net.URLConnection: |
---|
url, doInput, doOutput, allowUserInteraction, useCaches, ifModifiedSince, connected, factory |
Constructor: |
---|
HttpsURLConnection using the
URL specified.
|
Method from javax.net.ssl.HttpsURLConnection Summary: |
---|
getCipherSuite, getDefaultHostnameVerifier, getDefaultSSLSocketFactory, getHostnameVerifier, getLocalCertificates, getLocalPrincipal, getPeerPrincipal, getSSLSocketFactory, getServerCertificates, setDefaultHostnameVerifier, setDefaultSSLSocketFactory, setHostnameVerifier, setSSLSocketFactory |
Methods from java.lang.Object: |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method from javax.net.ssl.HttpsURLConnection Detail: |
---|
|
HostnameVerifier that is inherited
by new instances of this class. |
SSLSocketFactory that is
inherited by new instances of this class.
The socket factories are used when creating sockets for secure https URL connections. |
HostnameVerifier in place on this instance. |
Note: This method is useful only when using certificate-based cipher suites. When multiple certificates are available for use in a handshake, the implementation chooses what it considers the "best" certificate chain available, and transmits that to the other side. This method allows the caller to know which certificate chain was actually sent. |
Note: Subclasses should override this method. If not overridden, it will default to returning the X500Principal of the end-entity certificate that was sent to the server for certificate-based ciphersuites or, return null for non-certificate based ciphersuites, such as Kerberos. |
Note: Subclasses should override this method. If not overridden, it will default to returning the X500Principal of the server's end-entity certificate for certificate-based ciphersuites, or throw an SSLPeerUnverifiedException for non-certificate based ciphersuites, such as Kerberos. |
|
Note: This method can be used only when using certificate-based cipher suites; using it with non-certificate-based cipher suites, such as Kerberos, will throw an SSLPeerUnverifiedException. |
HostnameVerifier inherited by a
new instance of this class.
If this method is not called, the default
|
SSLSocketFactory inherited by new
instances of this class.
The socket factories are used when creating sockets for secure https URL connections. |
HostnameVerifier for this instance.
New instances of this class inherit the default static hostname
verifier set by setDefaultHostnameVerifier . Calls to this method replace
this object's |
SSLSocketFactory to be used when this instance
creates sockets for secure https URL connections.
New instances of this class inherit the default static
|