HttpsURLConnection (Java Platform SE 8 )

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。有两类定义的默认实现。然而，实现可以被替换为一个类（静态）或每一个实例的基础上。所有新的HttpsURLConnections实例将被分配的“默认”的静态值在创建实例，但它们可以被调用适当的每个实例的设置方法（S）在connecting。

从以下版本开始：

一点四

Field Summary

Fields
Modifier and Type	Field and Description
`protected HostnameVerifier`	`hostnameVerifier` 此对象的 `hostnameVerifier`。

Fields inherited from class java.net.HttpURLConnection
chunkLength, fixedContentLength, fixedContentLengthLong, 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

Fields inherited from class java.net.URLConnection
allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`HttpsURLConnection(URL url)` 创建一个 `HttpsURLConnection`使用指定的URL。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`abstract String`	`getCipherSuite()` 返回此连接使用的密码套件。
`static HostnameVerifier`	`getDefaultHostnameVerifier()` 获取默认 `HostnameVerifier`是由这类的新实例继承。
`static SSLSocketFactory`	`getDefaultSSLSocketFactory()` 获取默认静态 `SSLSocketFactory`是由这类的新实例继承。
`HostnameVerifier`	`getHostnameVerifier()` 得到 `HostnameVerifier`到位这个实例。
`abstract Certificate[]`	`getLocalCertificates()` 返回证书（S），在握手时发送到服务器。
`Principal`	`getLocalPrincipal()` 返回主是在握手时发送到服务器。
`Principal`	`getPeerPrincipal()` 返回服务器的主要部分，这是作为定义会话的一部分而建立的。
`abstract Certificate[]`	`getServerCertificates()` 返回作为定义会话的一部分而建立的服务器的证书链。
`SSLSocketFactory`	`getSSLSocketFactory()` 获取SSL套接字工厂来创建安全的HTTPS URL连接插座使用时。
`static void`	`setDefaultHostnameVerifier(HostnameVerifier v)` 设置默认 `HostnameVerifier`由这个类的一个新实例继承。
`static void`	`setDefaultSSLSocketFactory(SSLSocketFactory sf)` 设置默认 `SSLSocketFactory`这个类的新实例继承。
`void`	`setHostnameVerifier(HostnameVerifier v)` 将此实例的 `HostnameVerifier`。
`void`	`setSSLSocketFactory(SSLSocketFactory sf)` 将此实例创建时使用安全的HTTPS URL连接插座的 `SSLSocketFactory`。

Methods inherited from class java.net.URLConnection
addRequestProperty, connect, getAllowUserInteraction, getConnectTimeout, getContent, getContent, getContentEncoding, getContentLength, getContentLengthLong, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, getDoInput, getDoOutput, getExpiration, getFileNameMap, getHeaderField, getHeaderFieldInt, getHeaderFieldLong, 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

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - hostnameVerifier
```
protected HostnameVerifier hostnameVerifier
```
    此对象的 hostnameVerifier。
- Constructor Detail
  - HttpsURLConnection
```
protected HttpsURLConnection(URL url)
```
    创建一个 HttpsURLConnection使用指定的URL。
    
    参数
    
    url的URL
- 方法详细信息
  - getCipherSuite
```
public abstract String getCipherSuite()
```
    返回此连接使用的密码套件。
    
    结果
    
    的密码套件
    
    异常
    
    IllegalStateException -如果这种方法之前已建立连接称为。
  - getLocalCertificates
```
public abstract Certificate[] getLocalCertificates()
```
    返回证书（S），在握手时发送到服务器。
    注：此方法仅在使用基于证书的密码套件时是有用的。
    
    当多个证书可用于握手时，实现选择它认为“最好的”证书链可用，并将其发送到另一方。此方法允许调用方知道实际发送的证书链。
    
    结果
    
    一个有序数组的证书，与客户自己的证书首先遵循任何证书颁发机构。如果没有发送证书，则返回空值。
    
    异常
    
    IllegalStateException -如果这种方法之前已建立连接称为。
    
    另请参见：
    
    getLocalPrincipal()
  - getServerCertificates
```
public abstract Certificate[] getServerCertificates()
                                             throws SSLPeerUnverifiedException
```
    返回作为定义会话的一部分而建立的服务器的证书链。
    注：此方法可用于只有当使用基于证书的密码套件；使用基于无证书密码套件，如Kerberos，将抛出一个sslpeerunverifiedexception。
    
    结果
    
    服务器证书的有序数组，与同行的自己的证书首先遵循任何证书颁发机构。
    
    异常
    
    SSLPeerUnverifiedException如果同伴未验证。
    
    IllegalStateException -如果这种方法之前已建立连接称为。
    
    另请参见：
    
    getPeerPrincipal()
  - getPeerPrincipal
```
public Principal getPeerPrincipal()
                           throws SSLPeerUnverifiedException
```
    返回服务器的主要部分，这是作为定义会话的一部分而建立的。
    注：子类应重写此方法。如果不重写，它将默认返回服务器端实体证书的基于证书的密码套件的x500principal，或把基于无证书的密码套件sslpeerunverifiedexception，如Kerberos。
    
    结果
    
    服务器的主体。返回最后一个x500principal x509证书的实体基础密码套件，和kerberosprincipal Kerberos密码套件。
    
    异常
    
    SSLPeerUnverifiedException如果同伴没有验证
    
    IllegalStateException -如果这种方法之前已建立连接称为。
    
    从以下版本开始：
    
    一点五
    
    另请参见：
    
    getServerCertificates()， getLocalPrincipal()
  - getLocalPrincipal
```
public Principal getLocalPrincipal()
```
    返回主是在握手时发送到服务器。
    注：子类应重写此方法。如果不重写，它将默认返回的终端实体证书，被派到基于证书的密码套件服务器或x500principal，返回基于无证书无效的密码套件，如Kerberos。
    
    结果
    
    将委托人发送到服务器。返回一个x500principal为X509端实体的基于证书的密码套件，和kerberosprincipal Kerberos密码套件。如果没有发送主体，则返回空值。
    
    异常
    
    IllegalStateException -如果这种方法之前已建立连接称为。
    
    从以下版本开始：
    
    一点五
    
    另请参见：
    
    getLocalCertificates()， getPeerPrincipal()
  - setDefaultHostnameVerifier
```
public static void setDefaultHostnameVerifier(HostnameVerifier v)
```
    设置默认 HostnameVerifier由这个类的一个新实例继承。
    如果不调用此方法，默认HostnameVerifier假设连接不应允许。
    
    参数
    
    v -默认主机名验证
    
    异常
    
    IllegalArgumentException -如果 HostnameVerifier参数为空。
    
    SecurityException -如果存在一个安全管理及其 checkPermission方法不允许 SSLPermission("setHostnameVerifier")
    
    另请参见：
    
    getDefaultHostnameVerifier()
  - getDefaultHostnameVerifier
```
public static HostnameVerifier getDefaultHostnameVerifier()
```
    获取默认 HostnameVerifier是由这类的新实例继承。
    
    结果
    
    默认主机名验证
    
    另请参见：
    
    setDefaultHostnameVerifier(HostnameVerifier)
  - setHostnameVerifier
```
public void setHostnameVerifier(HostnameVerifier v)
```
    将此实例的 HostnameVerifier。
    这一类的新实例继承默认静态主机名验证通过setDefaultHostnameVerifier。调用此方法替换此对象的HostnameVerifier。
    
    参数
    
    v -主机名验证
    
    异常
    
    IllegalArgumentException -如果 HostnameVerifier参数为空。
    
    另请参见：
    
    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参数为空。
    
    SecurityException -如果存在一个安全管理及其 checkSetFactory方法不允许一个套接字工厂被指定。
    
    另请参见：
    
    getDefaultSSLSocketFactory()
  - getDefaultSSLSocketFactory
```
public static SSLSocketFactory getDefaultSSLSocketFactory()
```
    获取默认静态 SSLSocketFactory是由这类的新实例继承。
    套接字工厂创建安全的HTTPS URL连接插座使用时。
    
    结果
    
    默认 SSLSocketFactory
    
    另请参见：
    
    setDefaultSSLSocketFactory(SSLSocketFactory)
  - setSSLSocketFactory
```
public void setSSLSocketFactory(SSLSocketFactory sf)
```
    将此实例创建时使用安全的HTTPS URL连接插座的 SSLSocketFactory。
    这一类的新实例继承默认静态SSLSocketFactory由setDefaultSSLSocketFactory。调用此方法替换此对象的SSLSocketFactory。
    
    参数
    
    sf - SSL套接字工厂
    
    异常
    
    IllegalArgumentException -如果 SSLSocketFactory参数为空。
    
    SecurityException -如果存在一个安全管理及其 checkSetFactory方法不允许一个套接字工厂被指定。
    
    另请参见：
    
    getSSLSocketFactory()
  - getSSLSocketFactory
```
public SSLSocketFactory getSSLSocketFactory()
```
    获取SSL套接字工厂来创建安全的HTTPS URL连接插座使用时。
    
    结果
    
    的 SSLSocketFactory
    
    另请参见：
    
    setSSLSocketFactory(SSLSocketFactory)

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class HttpsURLConnection

Field Summary

Fields inherited from class java.net.HttpURLConnection

Fields inherited from class java.net.URLConnection

构造方法摘要

方法摘要

Methods inherited from class java.net.HttpURLConnection

Methods inherited from class java.net.URLConnection

Methods inherited from class java.lang.Object

Field Detail

hostnameVerifier

Constructor Detail

HttpsURLConnection

方法详细信息

getCipherSuite

getLocalCertificates

getServerCertificates

getPeerPrincipal

getLocalPrincipal

setDefaultHostnameVerifier

getDefaultHostnameVerifier

setHostnameVerifier

getHostnameVerifier

setDefaultSSLSocketFactory

getDefaultSSLSocketFactory

setSSLSocketFactory

getSSLSocketFactory