|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.net.URLConnection
java.net.HttpURLConnection
javax.net.ssl.HttpsURLConnection
public abstract class HttpsURLConnection
A URL connection that connects via the Secure Socket Layer (SSL) for HTTPS connections.
This class may be used in the same way as HttpURLConnection
, and it will transparently negotiate the SSL
connection.
Field Summary | |
---|---|
protected HostnameVerifier |
hostnameVerifier
The hostname verifier used for this connection. |
Fields inherited from class java.net.URLConnection |
---|
allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches |
Constructor Summary | |
---|---|
protected |
HttpsURLConnection(URL url)
Creates a new HTTPS URL connection. |
Method Summary | |
---|---|
abstract String |
getCipherSuite()
Returns the cipher name negotiated for this connection. |
static HostnameVerifier |
getDefaultHostnameVerifier()
Returns the default hostname verifier used in all new connections. |
static SSLSocketFactory |
getDefaultSSLSocketFactory()
Returns the default SSL socket factory used in all new connections. |
HostnameVerifier |
getHostnameVerifier()
Returns the current hostname verifier for this instance. |
abstract Certificate[] |
getLocalCertificates()
Returns the certificates used on the local side in this connection. |
Principal |
getLocalPrincipal()
Returns the local principal for this connection. |
Principal |
getPeerPrincipal()
Returns the remote peer's principal for this connection. |
abstract Certificate[] |
getServerCertificates()
Returns the certificates sent by the other party. |
SSLSocketFactory |
getSSLSocketFactory()
Returns the current SSL socket factory for this instance. |
static void |
setDefaultHostnameVerifier(HostnameVerifier newDefault)
Sets the default hostname verifier to be used in all new connections. |
static void |
setDefaultSSLSocketFactory(SSLSocketFactory newDefault)
Sets the default SSL socket factory to be used in all new connections. |
void |
setHostnameVerifier(HostnameVerifier hostnameVerifier)
Sets the hostname verifier for this instance. |
void |
setSSLSocketFactory(SSLSocketFactory factory)
Sets the SSL socket factory for this instance. |
Methods inherited from class java.net.HttpURLConnection |
---|
disconnect, getErrorStream, getFollowRedirects, getHeaderFieldDate, getInstanceFollowRedirects, getPermission, getRequestMethod, getResponseCode, getResponseMessage, setFollowRedirects, setInstanceFollowRedirects, setRequestMethod, usingProxy |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
protected HostnameVerifier hostnameVerifier
Constructor Detail |
---|
protected HttpsURLConnection(URL url)
url
- The URL of the connection being established.Method Detail |
---|
public static HostnameVerifier getDefaultHostnameVerifier()
public static void setDefaultHostnameVerifier(HostnameVerifier newDefault)
newDefault
- The new default hostname verifier.
IllegalArgumentException
- If newDefault is null.
SecurityException
- If there is a security manager
currently installed and the caller does not have the SSLPermission
"setHostnameVerifier".public static SSLSocketFactory getDefaultSSLSocketFactory()
public static void setDefaultSSLSocketFactory(SSLSocketFactory newDefault)
newDefault
- The new socket factory.
IllegalArgumentException
- If newDefault is null.
SecurityException
- If there is a security manager
installed and a call to SecurityManager.checkSetFactory()
fails.public HostnameVerifier getHostnameVerifier()
public void setHostnameVerifier(HostnameVerifier hostnameVerifier)
hostnameVerifier
- The new verifier.
IllegalArgumentException
- If hostnameVerifier is
null.public SSLSocketFactory getSSLSocketFactory()
public void setSSLSocketFactory(SSLSocketFactory factory)
factory
- The new factory.
IllegalArgumentException
- If factory is null.public Principal getLocalPrincipal()
The default implementation will return the javax.security.x500.X500Principal
for the end entity certificate
in the local certificate chain if those certificates are of type
X509Certificate
. Otherwise, this
method returns null
.
public Principal getPeerPrincipal() throws SSLPeerUnverifiedException
The default implementation will return the javax.security.x500.X500Principal
for the end entity certificate
in the remote peer's certificate chain if those certificates are
of type X509Certificate
. Otherwise,
this method returns null
.
SSLPeerUnverifiedException
- If the remote peer has not
been verified.public abstract String getCipherSuite()
IllegalStateException
- If the connection has not yet been
established.public abstract Certificate[] getLocalCertificates()
IllegalStateException
- If the connection has not yet been
established.public abstract Certificate[] getServerCertificates() throws SSLPeerUnverifiedException
IllegalStateException
- If the connection has not yet been
established.
SSLPeerUnverifiedException
- If the peer could not be
verified.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |