Java in a Nutshell, 5th Edition [Electronic resources] نسخه متنی

This class is a
java.net.URLConnection for a
URL
that uses the https: protocol. It extends
java.net.HttpURLConnection and, in addition to
inheriting the methods of its superclasses, it defines methods for
specifying the SSLSocketFactory and
HostnameVerifier to use when establishing the
connection. Static versions of these methods allow you to specify a
default factory and verifier objects for use with all
HttpsURLConnection objects. After the connection
has been established, several other methods exist to obtain
information (such as the cipher suite and the server certificates)
about the connection itself.

Obtain a HttpsURLConnection object by calling the
openConnection(
) method of a
URL that uses the https:// protocol specifier, and
casting the returned value to this type. The
HttpsURLConnection object is unconnected at this
point, and you can call setHostnameVerifier(
) and setSSLSocketFactory( )
to customize the way the connection is made. (If you do not specify a
HostnameVerifier for the instance, or a default
one for the class, then hostname mismatches will always cause the
connection to fail. If you do not specify an
SSLSocketFactory for the instance or class, then a
default one will be used.) To connect, call the inherited
connect( ) method, and then call the inherited
getContent( ) to retrieve the content of the URL
as an object, or use the inherited getInputStream(
) to obtain a java.io.InputStream with
which you can read the content of the URL.

Figure 18-4. javax.net.ssl.HttpsURLConnection

public abstract class

HttpsURLConnection extends java.net.HttpURLConnection {
// Protected Constructors
protected

HttpsURLConnection (java.net.URL

url );
// Public Class Methods
public static HostnameVerifier

getDefaultHostnameVerifier ( );
public static SSLSocketFactory

getDefaultSSLSocketFactory ( );
public static void

setDefaultHostnameVerifier (HostnameVerifier

v );
public static void

setDefaultSSLSocketFactory (SSLSocketFactory

sf );
// Public Instance Methods
public abstract String

getCipherSuite ( );
public HostnameVerifier

getHostnameVerifier ( );
public abstract java.security.cert.Certificate[ ]

getLocalCertificates ( );

5.0 public java.security.Principal

getLocalPrincipal ( );

5.0 public java.security.Principal

getPeerPrincipal ( )
throws SSLPeerUnverifiedException;
public abstract java.security.cert.Certificate[ ]

getServerCertificates ( )
throws SSLPeerUnverifiedException;
public SSLSocketFactory

getSSLSocketFactory ( );
public void

setHostnameVerifier (HostnameVerifier

v );
public void

setSSLSocketFactory (SSLSocketFactory

sf );
// Protected Instance Fields
protected HostnameVerifier

hostnameVerifier ;
}