javax.net.ssl
public abstract class HttpsURLConnection extends HttpURLConnection
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. |
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.
|
Parameters: url The URL of the connection being established.
UNKNOWN: This was marked as throwing IOException in 1.4, but this was removed in 1.5.
Returns: The cipher name.
Throws: IllegalStateException If the connection has not yet been established.
Returns: The default hostname verifier.
Returns: The default SSL socket factory.
Returns: The hostname verifier.
Returns: The local certificates.
Throws: IllegalStateException If the connection has not yet been established.
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
java.security.cert.X509Certificate. Otherwise, this
method returns null
.
Returns: The local principal.
Since: 1.5
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 java.security.cert.X509Certificate. Otherwise,
this method returns null
.
Returns: The remote principal.
Throws: SSLPeerUnverifiedException If the remote peer has not been verified.
Since: 1.5
Returns: The peer's certificates.
Throws: IllegalStateException If the connection has not yet been established. SSLPeerUnverifiedException If the peer could not be verified.
Returns: The current SSL socket factory.
Parameters: newDefault The new default hostname verifier.
Throws: IllegalArgumentException If newDefault is null. SecurityException If there is a security manager currently installed and the caller does not have the SSLPermission "setHostnameVerifier".
Parameters: newDefault The new socket factory.
Throws: IllegalArgumentException If newDefault is null. SecurityException If there is a security manager installed and a call to SecurityManager#checkSetFactory() fails.
Parameters: hostnameVerifier The new verifier.
Throws: IllegalArgumentException If hostnameVerifier is null.
Parameters: factory The new factory.
Throws: IllegalArgumentException If factory is null.