当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

HttpsURLConnection (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

javax.net.ssl
类 HttpsURLConnection

java.lang.Object
  java.net.URLConnection
      java.net.HttpURLConnection
          javax.net.ssl.HttpsURLConnection

---

public abstract class HttpsURLConnection
extends HttpURLConnection

HttpsURLConnection 扩展 HttpURLConnection，支持各种特定于 https 功能。

有关 https 规范的更多详细信息，请参见 http://www.w3.org/pub/WWW/Protocols/ 和 RFC 2818。

此类使用 HostnameVerifier 和 SSLSocketFactory。为这两个类都定义了默认实现。但是，可以根据每个类（静态的）或每个实例来替换该实现。所有新 HttpsURLConnection 实例在创建时将被分配“默认的”静态值，通过在 connect 前调用每个实例适当的 set 方法可以重写这些值。

从以下版本开始：

1.4

---

字段摘要
protected  HostnameVerifier	hostnameVerifier           此对象的 hostnameVerifier。

 

从类 java.net.HttpURLConnection 继承的字段

chunkLength, fixedContentLength, 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_SERVER_ERROR, HTTP_UNAUTHORIZED, HTTP_UNAVAILABLE, HTTP_UNSUPPORTED_TYPE, HTTP_USE_PROXY, HTTP_VERSION, instanceFollowRedirects, method, responseCode, responseMessage

 

从类 java.net.URLConnection 继承的字段
allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches

 

构造方法摘要
protected	HttpsURLConnection(URL url)           使用指定的 URL 创建 HttpsURLConnection。

 

方法摘要
abstract  String	getCipherSuite()           返回在此连接上使用的密码套件。
static HostnameVerifier	getDefaultHostnameVerifier()           获得此类的新实例所继承的默认 HostnameVerifier。
static SSLSocketFactory	getDefaultSSLSocketFactory()           获得此类的新实例所继承的默认静态 SSLSocketFactory。
HostnameVerifier	getHostnameVerifier()           获得此实例适当的 HostnameVerifier。
abstract  Certificate[]	getLocalCertificates()           返回握手期间发送给服务器的证书。
Principal	getLocalPrincipal()           返回握手期间发送到服务器的主体。
Principal	getPeerPrincipal()           返回服务器的主体，它是作为定义会话的一部分而建立的。
abstract  Certificate[]	getServerCertificates()           返回服务器的证书链，它是作为定义会话的一部分而建立的。
SSLSocketFactory	getSSLSocketFactory()           获得为安全 https URL 连接创建套接字时使用的 SSL 套接字工厂。
static void	setDefaultHostnameVerifier(HostnameVerifier v)           设置此类的新实例所继承的默认 HostnameVerifier。
static void	setDefaultSSLSocketFactory(SSLSocketFactory sf)           设置此类的新实例所继承的默认 SSLSocketFactory。
void	setHostnameVerifier(HostnameVerifier v)           设置此实例的 HostnameVerifier。
void	setSSLSocketFactory(SSLSocketFactory sf)           设置当此实例为安全 https URL 连接创建套接字时使用的 SSLSocketFactory。

 

从类 java.net.HttpURLConnection 继承的方法
disconnect, getErrorStream, getFollowRedirects, getHeaderField, getHeaderFieldDate, getHeaderFieldKey, getInstanceFollowRedirects, getPermission, getRequestMethod, getResponseCode, getResponseMessage, setChunkedStreamingMode, setFixedLengthStreamingMode, setFollowRedirects, setInstanceFollowRedirects, setRequestMethod, usingProxy

 

从类 java.net.URLConnection 继承的方法

addRequestProperty, connect, getAllowUserInteraction, getConnectTimeout, getContent, getContent, getContentEncoding, getContentLength, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, getDoInput, getDoOutput, getExpiration, getFileNameMap, getHeaderField, getHeaderFieldInt, getHeaderFields, getIfModifiedSince, getInputStream, getLastModified, getOutputStream, getReadTimeout, getRequestProperties, getRequestProperty, getURL, getUseCaches, guessContentTypeFromName, guessContentTypeFromStream, setAllowUserInteraction, setConnectTimeout, setContentHandlerFactory, setDefaultAllowUserInteraction, setDefaultRequestProperty, setDefaultUseCaches, setDoInput, setDoOutput, setFileNameMap, setIfModifiedSince, setReadTimeout, setRequestProperty, setUseCaches, toString

 

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

 

字段详细信息

hostnameVerifier

protected HostnameVerifier hostnameVerifier

此对象的 hostnameVerifier。

构造方法详细信息

HttpsURLConnection

protected HttpsURLConnection(URL url)

使用指定的 URL 创建 HttpsURLConnection。

参数：

url - URL

方法详细信息

getCipherSuite

public abstract String getCipherSuite()

返回在此连接上使用的密码套件。

返回：

密码套件

抛出：

IllegalStateException - 如果在连接建立前调用此方法。

---

getLocalCertificates

public abstract Certificate[] getLocalCertificates()

返回握手期间发送给服务器的证书。

注：仅当使用基于证书的密码套件时此方法才有用。

当在一次握手中有多个证书可供使用时，实现选择它认为是“最好的”可用证书链，并把它传输到另一方。此方法允许调用方知道实际发送的证书链。

返回：

证书的有序数组，客户端的证书在前，后跟所有证书颁发机构。如果没有发送任何证书，则返回 null。

抛出：

IllegalStateException - 如果在连接建立前调用此方法。

另请参见：

getLocalPrincipal()

---

getServerCertificates

public abstract Certificate[] getServerCertificates()
                                             throws SSLPeerUnverifiedException

返回服务器的证书链，它是作为定义会话的一部分而建立的。

注：仅当使用基于证书的密码套件时才可以使用此方法；将它与非基于证书的密码套件（如 Kerberos）一起使用将抛出 SSLPeerUnverifiedException。

返回：

服务器证书的有序数组，同位体的证书在前，后跟所有证书颁发机构。

抛出：

SSLPeerUnverifiedException - 如果没有验证同位体。

IllegalStateException - 如果在连接建立前调用此方法。

另请参见：

getPeerPrincipal()

---

getPeerPrincipal

public Principal getPeerPrincipal()
                           throws SSLPeerUnverifiedException

返回服务器的主体，它是作为定义会话的一部分而建立的。

注：子类应重写此方法。如果没有重写此方法，则对于基于证书的密码套件，它将默认返回服务器终端实体证书的 X500Principal，对于非基于证书的密码套件（如 Kerberos），则抛出 SSLPeerUnverifiedException。

返回：

服务器的主体。返回基于 X509 的密码套件的最终实体证书的 X500Principal，以及 Kerberos 的密码套件的 KerberosPrincipal。

抛出：

SSLPeerUnverifiedException - 如果没有验证同位体

IllegalStateException - 如果在连接建立前调用此方法。

从以下版本开始：

1.5

另请参见：

getServerCertificates(), getLocalPrincipal()

---

getLocalPrincipal

public Principal getLocalPrincipal()

返回握手期间发送到服务器的主体。

注：子类应重写此方法。如果没有重写此方法，则对于基于证书的密码套件，它将默认返回发送到服务器的终端实体证书的 X500Principal，对于非基于证书的密码套件（如 Kerberos），则返回 null。

返回：

发送到服务器的主体。返回基于 X509 的密码套件的最终实体证书的 X500Principal，以及 Kerberos 的密码套件的 KerberosPrincipal。如果没有发送任何主体，则返回 null。

抛出：

IllegalStateException - 如果在连接建立前调用此方法。

从以下版本开始：

1.5

另请参见：

getLocalCertificates(), getPeerPrincipal()

---

setDefaultHostnameVerifier

public static void setDefaultHostnameVerifier(HostnameVerifier v)

设置此类的新实例所继承的默认 HostnameVerifier。

如果不调用此方法，则默认的 HostnameVerifier 假定连接不应该被允许。

参数：

v - 默认的主机名校验器

抛出：

IllegalArgumentException - 如果 HostnameVerifier 参数为 null。

另请参见：

getDefaultHostnameVerifier()

---

getDefaultHostnameVerifier

public static HostnameVerifier getDefaultHostnameVerifier()

获得此类的新实例所继承的默认 HostnameVerifier。

返回：

默认的主机名校验器

另请参见：

setDefaultHostnameVerifier(HostnameVerifier)

---

setHostnameVerifier

public void setHostnameVerifier(HostnameVerifier v)

设置此实例的 HostnameVerifier。

此类的新实例继承由 setDefaultHostnameVerifier 设置的默认静态主机名校验器。调用此方法会替换此对象的 HostnameVerifier。

参数：

v - 主机名校验器

抛出：

IllegalArgumentException - 如果 HostnameVerifier 参数为 null。

另请参见：

getHostnameVerifier(), setDefaultHostnameVerifier(HostnameVerifier)

---

getHostnameVerifier

public HostnameVerifier getHostnameVerifier()

获得此实例适当的 HostnameVerifier。

返回：

主机名校验器

另请参见：

setHostnameVerifier(HostnameVerifier), setDefaultHostnameVerifier(HostnameVerifier)

---

setDefaultSSLSocketFactory

public static void setDefaultSSLSocketFactory(SSLSocketFactory sf)

设置此类的新实例所继承的默认 SSLSocketFactory。

当为安全 https URL 连接创建套接字时使用套接字工厂。

参数：

sf - 默认的 SSL 套接字工厂

抛出：

IllegalArgumentException - 如果 SSLSocketFactory 参数为 null。

另请参见：

getDefaultSSLSocketFactory()

---

getDefaultSSLSocketFactory

public static SSLSocketFactory getDefaultSSLSocketFactory()

获得此类的新实例所继承的默认静态 SSLSocketFactory。

当为安全 https URL 连接创建套接字时使用套接字工厂。

返回：

默认的 SSLSocketFactory

另请参见：

setDefaultSSLSocketFactory(SSLSocketFactory)

---

setSSLSocketFactory

public void setSSLSocketFactory(SSLSocketFactory sf)

设置当此实例为安全 https URL 连接创建套接字时使用的 SSLSocketFactory。

此类的新实例继承由 setDefaultSSLSocketFactory 设置的默认静态 SSLSocketFactory。调用此方法会替换此对象的 SSLSocketFactory。

参数：

sf - SSL 套接字工厂

抛出：

IllegalArgumentException - 如果 SSLSocketFactory 参数为 null。

另请参见：

getSSLSocketFactory()

---

getSSLSocketFactory

public SSLSocketFactory getSSLSocketFactory()

获得为安全 https URL 连接创建套接字时使用的 SSL 套接字工厂。

返回：

SSLSocketFactory

另请参见：

setSSLSocketFactory(SSLSocketFactory)

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。