Most visited

Recently visited

Results for

Added in API level 1

HttpsURLConnection

public abstract class HttpsURLConnection
extends HttpURLConnection

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

HttpsURLConnection扩展了 HttpURLConnection ，支持https特定功能。

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

本课使用HostnameVerifier和SSLSocketFactory 。为这两个类定义了默认实现。但是，可以在每个类（静态）或每个实例的基础上替换实现。所有新的HttpsURLConnection实例将在实例创建时被分配“默认”静态值，但是它们可以通过在connect之前调用适当的每个实例设置方法来重写。

Summary

Inherited constants

From class java.net.HttpURLConnection

`int`	`HTTP_ACCEPTED` HTTP状态码202：接受。
`int`	`HTTP_BAD_GATEWAY` HTTP状态码502：错误的网关。
`int`	`HTTP_BAD_METHOD` HTTP状态码405：方法不允许。
`int`	`HTTP_BAD_REQUEST` HTTP状态码400：错误的请求。
`int`	`HTTP_CLIENT_TIMEOUT` HTTP状态代码408：请求超时。
`int`	`HTTP_CONFLICT` HTTP状态码409：冲突。
`int`	`HTTP_CREATED` HTTP状态码201：已创建。
`int`	`HTTP_ENTITY_TOO_LARGE` HTTP状态码413：请求实体太大。
`int`	`HTTP_FORBIDDEN` HTTP状态码403：禁止。
`int`	`HTTP_GATEWAY_TIMEOUT` HTTP状态码504：网关超时。
`int`	`HTTP_GONE` HTTP状态码410：去。
`int`	`HTTP_INTERNAL_ERROR` HTTP状态代码500：内部服务器错误。
`int`	`HTTP_LENGTH_REQUIRED` HTTP状态码411：需要的长度。
`int`	`HTTP_MOVED_PERM` HTTP状态码301：永久移动。
`int`	`HTTP_MOVED_TEMP` HTTP状态码302：临时重定向。
`int`	`HTTP_MULT_CHOICE` HTTP状态码300：多种选择。
`int`	`HTTP_NOT_ACCEPTABLE` HTTP状态码406：不可接受。
`int`	`HTTP_NOT_AUTHORITATIVE` HTTP状态码203：非权威性信息。
`int`	`HTTP_NOT_FOUND` HTTP状态码404：未找到。
`int`	`HTTP_NOT_IMPLEMENTED` HTTP状态码501：未实现。
`int`	`HTTP_NOT_MODIFIED` HTTP状态码304：未修改。
`int`	`HTTP_NO_CONTENT` HTTP状态码204：无内容。
`int`	`HTTP_OK` HTTP状态码200：确定。
`int`	`HTTP_PARTIAL` HTTP状态码206：部分内容。
`int`	`HTTP_PAYMENT_REQUIRED` HTTP状态码402：需要付款。
`int`	`HTTP_PRECON_FAILED` HTTP状态代码412：先决条件失败。
`int`	`HTTP_PROXY_AUTH` HTTP状态码407：需要代理验证。
`int`	`HTTP_REQ_TOO_LONG` HTTP状态码414：请求URI太大。
`int`	`HTTP_RESET` HTTP状态码205：重置内容。
`int`	`HTTP_SEE_OTHER` HTTP状态代码303：请参阅其他。
`int`	`HTTP_SERVER_ERROR` 这个常数在API级别1中被弃用。它被放错了位置并且不应该存在。
`int`	`HTTP_UNAUTHORIZED` HTTP状态码401：未经授权。
`int`	`HTTP_UNAVAILABLE` HTTP状态码503：服务不可用。
`int`	`HTTP_UNSUPPORTED_TYPE` HTTP状态码415：不支持的媒体类型。
`int`	`HTTP_USE_PROXY` HTTP状态代码305：使用代理。
`int`	`HTTP_VERSION` HTTP状态代码505：不支持HTTP版本。

Fields
`protected HostnameVerifier`	`hostnameVerifier` 该对象的 `hostnameVerifier` 。

Inherited fields

From class java.net.HttpURLConnection

From class java.net.URLConnection

Protected constructors
`HttpsURLConnection(URL url)` 使用指定的URL创建一个 `HttpsURLConnection` 。

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

Inherited methods

From class java.net.HttpURLConnection

`abstract void`	`disconnect()` 表示在不久的将来，对服务器的其他请求不太可能。
`InputStream`	`getErrorStream()` 如果连接失败，则返回错误流，但服务器发送有用数据。
`static boolean`	`getFollowRedirects()` 返回一个 `boolean`指示是否应该自动跟随HTTP重定向（3xx）。
`String`	`getHeaderField(int n)` 返回第 `n` ^个标题字段的值。
`long`	`getHeaderFieldDate(String name, long Default)` 返回解析为日期的命名字段的值。
`String`	`getHeaderFieldKey(int n)` 返回第 `n` ^个标题字段的键。
`boolean`	`getInstanceFollowRedirects()` 返回此 `HttpURLConnection`的 `instanceFollowRedirects`字段的值。
`Permission`	`getPermission()` 返回代表连接到目标主机和端口所需权限的 `SocketPermission`对象。
`String`	`getRequestMethod()` 获取请求方法。
`int`	`getResponseCode()` 从HTTP响应消息中获取状态码。
`String`	`getResponseMessage()` 获取HTTP响应消息（如果有）与服务器的响应代码一起返回。
`void`	`setChunkedStreamingMode(int chunklen)` 这种方法被用于使HTTP请求正文的流没有进行内部缓冲，当内容长度事先不知道。
`void`	`setFixedLengthStreamingMode(int contentLength)` 当预先知道内容长度时，此方法用于在不进行内部缓冲的情况下启用HTTP请求体的流式传输。
`void`	`setFixedLengthStreamingMode(long contentLength)` 当预先知道内容长度时，此方法用于在不进行内部缓冲的情况下启用HTTP请求体的流式传输。
`static void`	`setFollowRedirects(boolean set)` 应设置此类是否自动跟随HTTP重定向（具有响应代码3xx的请求）。
`void`	`setInstanceFollowRedirects(boolean followRedirects)` 设置此 `HttpURLConnection`实例是否应自动跟随HTTP重定向（具有响应代码3xx的请求）。
`void`	`setRequestMethod(String method)` 设置URL请求的方法，其中之一： GET POST HEAD OPTIONS PUT DELETE TRACE are legal, subject to protocol restrictions.
`abstract boolean`	`usingProxy()` 指示连接是否通过代理。

From class java.net.URLConnection

`void`	`addRequestProperty(String key, String value)` 添加由键值对指定的常规请求属性。
`abstract void`	`connect()` 如果此连接尚未建立，则打开通向该URL所引用资源的通信链接。
`boolean`	`getAllowUserInteraction()` 返回此对象的 `allowUserInteraction`字段的值。
`int`	`getConnectTimeout()` 返回连接超时的设置。
`Object`	`getContent()` 检索此URL连接的内容。
`Object`	`getContent(Class[] classes)` 检索此URL连接的内容。
`String`	`getContentEncoding()` 返回 `content-encoding`标题字段的值。
`int`	`getContentLength()` 返回 `content-length`标题字段的值。
`long`	`getContentLengthLong()` 作为long返回 `content-length`标题字段的值。
`String`	`getContentType()` 返回 `content-type`标题字段的值。
`long`	`getDate()` 返回 `date`标题字段的值。
`static boolean`	`getDefaultAllowUserInteraction()` 返回 `allowUserInteraction`字段的默认值。
`static String`	`getDefaultRequestProperty(String key)` 此方法在API级别1中已弃用。应在获得URLConnection的相应实例后使用特定于实例的getRequestProperty方法。
`boolean`	`getDefaultUseCaches()` 返回 `URLConnection`的 `useCaches`标志的默认值。
`boolean`	`getDoInput()` 返回此 `URLConnection`的 `doInput`标志的值。
`boolean`	`getDoOutput()` 返回此 `URLConnection`的 `doOutput`标志的值。
`long`	`getExpiration()` 返回 `expires`标题字段的值。
`static FileNameMap`	`getFileNameMap()` 从数据文件加载文件名映射（一个mimetable）。
`String`	`getHeaderField(String name)` 返回指定标题字段的值。
`String`	`getHeaderField(int n)` 返回第 `n` ^个标题字段的值。
`long`	`getHeaderFieldDate(String name, long Default)` 返回解析为日期的命名字段的值。
`int`	`getHeaderFieldInt(String name, int Default)` 返回解析为数字的命名字段的值。
`String`	`getHeaderFieldKey(int n)` 返回第 `n` ^个标题字段的密钥。
`long`	`getHeaderFieldLong(String name, long Default)` 返回解析为数字的命名字段的值。
`Map<String, List<String>>`	`getHeaderFields()` 返回标题字段的不可修改的映射。
`long`	`getIfModifiedSince()` 返回此对象的 `ifModifiedSince`字段的值。
`InputStream`	`getInputStream()` 返回从此打开的连接读取的输入流。
`long`	`getLastModified()` 返回 `last-modified`标题字段的值。
`OutputStream`	`getOutputStream()` 返回写入此连接的输出流。
`Permission`	`getPermission()` 返回一个权限对象，表示建立由此对象表示的连接所需的权限。
`int`	`getReadTimeout()` 返回读取超时的设置。
`Map<String, List<String>>`	`getRequestProperties()` 返回此连接的一般请求属性的不可修改的映射。
`String`	`getRequestProperty(String key)` 返回此连接的指定常规请求属性的值。
`URL`	`getURL()` 返回此 `URLConnection`的 `URL`字段的值。
`boolean`	`getUseCaches()` 返回此 `URLConnection`的 `useCaches`字段的值。
`static String`	`guessContentTypeFromName(String fname)` 尝试根据URL的指定“文件”组件确定对象的内容类型。
`static String`	`guessContentTypeFromStream(InputStream is)` 尝试根据输入流开始处的字符确定输入流的类型。
`void`	`setAllowUserInteraction(boolean allowuserinteraction)` 设置此 `URLConnection`的 `allowUserInteraction`字段的 `URLConnection` 。
`void`	`setConnectTimeout(int timeout)` 设置打开到此URLConnection引用的资源的通信链接时要使用的指定超时值（以毫秒为单位）。
`static void`	`setContentHandlerFactory(ContentHandlerFactory fac)` 设置应用程序的 `ContentHandlerFactory` 。
`static void`	`setDefaultAllowUserInteraction(boolean defaultallowuserinteraction)` 将所有将来的 `URLConnection`对象的 `allowUserInteraction`字段的默认值设置为指定的值。
`static void`	`setDefaultRequestProperty(String key, String value)` 此方法在API级别1中已弃用。在获得URLConnection的相应实例后应使用特定于实例的setRequestProperty方法。调用此方法将不起作用。
`void`	`setDefaultUseCaches(boolean defaultusecaches)` 将 `useCaches`字段的默认值设置为指定的值。
`void`	`setDoInput(boolean doinput)` 将此 `URLConnection`的 `doInput`字段的值设置为指定的值。
`void`	`setDoOutput(boolean dooutput)` 将此 `URLConnection`的 `doOutput`字段的值设置为指定的值。
`static void`	`setFileNameMap(FileNameMap map)` 设置FileNameMap。
`void`	`setIfModifiedSince(long ifmodifiedsince)` 将此 `URLConnection`的 `ifModifiedSince`字段的值设置为指定的值。
`void`	`setReadTimeout(int timeout)` 将读取超时设置为指定的超时，以毫秒为单位。
`void`	`setRequestProperty(String key, String value)` 设置一般请求属性。
`void`	`setUseCaches(boolean usecaches)` 将此 `URLConnection`的 `useCaches`字段的值设置为指定的值。
`String`	`toString()` 返回此URL连接的 `String`表示形式。

From class java.lang.Object

Fields

hostnameVerifier

Added in API level 1

HostnameVerifier hostnameVerifier

该对象的 hostnameVerifier 。

Protected constructors

HttpsURLConnection

Added in API level 1

HttpsURLConnection (URL url)

使用指定的URL创建一个 HttpsURLConnection 。

Parameters
`url`	`URL`: the URL

Public methods

getCipherSuite

Added in API level 1

String getCipherSuite ()

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

Returns
`String`	the cipher suite

Throws
`IllegalStateException`	if this method is called before the connection has been established.

getDefaultHostnameVerifier

Added in API level 1

HostnameVerifier getDefaultHostnameVerifier ()

获取由此类的新实例继承的默认 HostnameVerifier 。

Returns
`HostnameVerifier`	the default host name verifier

也可以看看：

setDefaultHostnameVerifier(HostnameVerifier)

getDefaultSSLSocketFactory

Added in API level 1

SSLSocketFactory getDefaultSSLSocketFactory ()

获取由此类的新实例继承的默认静态 SSLSocketFactory 。

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

Returns
`SSLSocketFactory`	the default `SSLSocketFactory`

也可以看看：

setDefaultSSLSocketFactory(SSLSocketFactory)

getHostnameVerifier

Added in API level 1

HostnameVerifier getHostnameVerifier ()

在此实例上获取 HostnameVerifier 。

Returns
`HostnameVerifier`	the host name verifier

也可以看看：

getLocalCertificates

Added in API level 1

Certificate[] getLocalCertificates ()

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

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

当多个证书可用于握手时，实现选择它认为可用的“最佳”证书链，并将其传递给另一方。该方法允许调用者知道实际发送了哪个证书链。

Returns
`Certificate[]`	an ordered array of certificates, with the client's own certificate first followed by any certificate authorities. If no certificates were sent, then null is returned.

Throws
`IllegalStateException`	if this method is called before the connection has been established.

也可以看看：

getLocalPrincipal()

getLocalPrincipal

Added in API level 1

Principal getLocalPrincipal ()

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

注意：子类应该重写此方法。如果未被覆盖，它将默认返回已发送到服务器的最终实体证书的X500Principal以获得基于证书的密码组，或者对于基于非证书的密码组（例如Kerberos）返回null。

Returns
`Principal`	the principal sent to the server. Returns an X500Principal of the end-entity certificate for X509-based cipher suites, and KerberosPrincipal for Kerberos cipher suites. If no principal was sent, then null is returned.

Throws
`IllegalStateException`	if this method is called before the connection has been established.

也可以看看：

getPeerPrincipal

Added in API level 1

Principal getPeerPrincipal ()

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

注意：子类应该重写此方法。如果不重写，它将默认返回基于证书的密码组的服务器的最终实体证书的X500Principal，或者为基于非证书的密码组（例如Kerberos）引发SSLPeerUnverifiedException。

Returns
`Principal`	the server's principal. Returns an X500Principal of the end-entity certiticate for X509-based cipher suites, and KerberosPrincipal for Kerberos cipher suites.

Throws
`SSLPeerUnverifiedException`	if the peer was not verified
`IllegalStateException`	if this method is called before the connection has been established.

也可以看看：

getSSLSocketFactory

Added in API level 1

SSLSocketFactory getSSLSocketFactory ()

在为安全https URL连接创建套接字时获取SSL套接字工厂。

Returns
`SSLSocketFactory`	the `SSLSocketFactory`

也可以看看：

setSSLSocketFactory(SSLSocketFactory)

getServerCertificates

Added in API level 1

Certificate[] getServerCertificates ()

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

注意：只有在使用基于证书的密码套件时才能使用此方法; 将它与非基于证书的密码套件（如Kerberos）一起使用时，将引发SSLPeerUnverifiedException。

Returns
`Certificate[]`	an ordered array of server certificates, with the peer's own certificate first followed by any certificate authorities.

Throws
`SSLPeerUnverifiedException`	if the peer is not verified.
`IllegalStateException`	if this method is called before the connection has been established.

也可以看看：

getPeerPrincipal()

setDefaultHostnameVerifier

Added in API level 1

void setDefaultHostnameVerifier (HostnameVerifier v)

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

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

Parameters
`v`	`HostnameVerifier`: the default host name verifier

Throws
`IllegalArgumentException`	if the `HostnameVerifier` parameter is null.
`SecurityException`	if a security manager exists and its `checkPermission` method does not allow `SSLPermission("setHostnameVerifier")`

也可以看看：

getDefaultHostnameVerifier()

setDefaultSSLSocketFactory

Added in API level 1

void setDefaultSSLSocketFactory (SSLSocketFactory sf)

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

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

Parameters
`sf`	`SSLSocketFactory`: the default SSL socket factory

Throws
`IllegalArgumentException`	if the SSLSocketFactory parameter is null.
`SecurityException`	if a security manager exists and its `checkSetFactory` method does not allow a socket factory to be specified.

也可以看看：

getDefaultSSLSocketFactory()

setHostnameVerifier

Added in API level 1

void setHostnameVerifier (HostnameVerifier v)

为此实例设置 HostnameVerifier 。

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

Parameters
`v`	`HostnameVerifier`: the host name verifier

Throws
`IllegalArgumentException`	if the `HostnameVerifier` parameter is null.

也可以看看：

setSSLSocketFactory

Added in API level 1

void setSSLSocketFactory (SSLSocketFactory sf)

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

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

Parameters
`sf`	`SSLSocketFactory`: the SSL socket factory

Throws
`IllegalArgumentException`	if the `SSLSocketFactory` parameter is null.

也可以看看：

getSSLSocketFactory()

Interfaces

Classes

Enums

Exceptions

Most visited

Recently visited

Results for

HttpsURLConnection

Summary

Inherited constants

Fields

Inherited fields

Protected constructors

Public methods

Inherited methods

Fields

hostnameVerifier

Protected constructors

HttpsURLConnection

Public methods

getCipherSuite

getDefaultHostnameVerifier

getDefaultSSLSocketFactory

getHostnameVerifier

getLocalCertificates

getLocalPrincipal

getPeerPrincipal

getSSLSocketFactory

getServerCertificates

setDefaultHostnameVerifier

setDefaultSSLSocketFactory

setHostnameVerifier

setSSLSocketFactory