uTools-Manuals/docs/java/javax/net/ssl/HttpsURLConnection.html

660 lines
42 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
compact1, compact2, compact3
</div>
<div class="subTitle">
javax.net.ssl
</div>
<h2 class="title" title="Class HttpsURLConnection">Class HttpsURLConnection</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../java/net/URLConnection.html" title="class in java.net">java.net.URLConnection</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../java/net/HttpURLConnection.html" title="class in java.net">java.net.HttpURLConnection</a></li>
<li>
<ul class="inheritance">
<li>javax.net.ssl.HttpsURLConnection</li>
</ul> </li>
</ul> </li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">HttpsURLConnection</span>
extends <a href="../../../java/net/HttpURLConnection.html" title="class in java.net">HttpURLConnection</a></pre>
<div class="block">
<span><code>HttpsURLConnection</code>扩展了<code>HttpURLConnection</code> 支持https特定的功能。</span>
<p> <span>有关<a href="http://www.w3.org/pub/WWW/Protocols/">https</a> <a href="http://www.ietf.org/">规范</a>的更多详细信息,请参阅<a href="http://www.w3.org/pub/WWW/Protocols/">http://www.w3.org/pub/WWW/Protocols/</a>和RFC 2818。</span> </p>
<p> <span>本课程使用<code>HostnameVerifier</code><code>SSLSocketFactory</code></span> <span>为这两个类定义了默认实现。</span> <span>但是,可以在每个类(静态)或每个实例的基础上替换这些实现。</span> <span>所有新的<code>HttpsURLConnection</code>实例将在实例创建时分配“默认”静态值但可以在connect之前调用适当的每个实例集方法来<code>connect</code></span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.4
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- --> </a> <h3>Field Summary</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Field Summary table, listing fields, and an explanation">
<caption>
<span>Fields</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected <a href="../../../javax/net/ssl/HostnameVerifier.html" title="interface in javax.net.ssl">HostnameVerifier</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/HttpsURLConnection.html#hostnameVerifier">hostnameVerifier</a></span></code>
<div class="block">
这个对象的
<code>hostnameVerifier</code>
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.java.net.HttpURLConnection">
<!-- --> </a> <h3>Fields inherited from class java.net.<a href="../../../java/net/HttpURLConnection.html" title="class in java.net">HttpURLConnection</a></h3> <code><a href="../../../java/net/HttpURLConnection.html#chunkLength">chunkLength</a>, <a href="../../../java/net/HttpURLConnection.html#fixedContentLength">fixedContentLength</a>, <a href="../../../java/net/HttpURLConnection.html#fixedContentLengthLong">fixedContentLengthLong</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_ACCEPTED">HTTP_ACCEPTED</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_BAD_GATEWAY">HTTP_BAD_GATEWAY</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_BAD_METHOD">HTTP_BAD_METHOD</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_BAD_REQUEST">HTTP_BAD_REQUEST</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_CLIENT_TIMEOUT">HTTP_CLIENT_TIMEOUT</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_CONFLICT">HTTP_CONFLICT</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_CREATED">HTTP_CREATED</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_ENTITY_TOO_LARGE">HTTP_ENTITY_TOO_LARGE</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_FORBIDDEN">HTTP_FORBIDDEN</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_GATEWAY_TIMEOUT">HTTP_GATEWAY_TIMEOUT</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_GONE">HTTP_GONE</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_INTERNAL_ERROR">HTTP_INTERNAL_ERROR</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_LENGTH_REQUIRED">HTTP_LENGTH_REQUIRED</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_MOVED_PERM">HTTP_MOVED_PERM</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_MOVED_TEMP">HTTP_MOVED_TEMP</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_MULT_CHOICE">HTTP_MULT_CHOICE</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_NO_CONTENT">HTTP_NO_CONTENT</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_NOT_ACCEPTABLE">HTTP_NOT_ACCEPTABLE</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_NOT_AUTHORITATIVE">HTTP_NOT_AUTHORITATIVE</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_NOT_FOUND">HTTP_NOT_FOUND</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_NOT_IMPLEMENTED">HTTP_NOT_IMPLEMENTED</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_NOT_MODIFIED">HTTP_NOT_MODIFIED</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_OK">HTTP_OK</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_PARTIAL">HTTP_PARTIAL</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_PAYMENT_REQUIRED">HTTP_PAYMENT_REQUIRED</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_PRECON_FAILED">HTTP_PRECON_FAILED</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_PROXY_AUTH">HTTP_PROXY_AUTH</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_REQ_TOO_LONG">HTTP_REQ_TOO_LONG</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_RESET">HTTP_RESET</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_SEE_OTHER">HTTP_SEE_OTHER</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_SERVER_ERROR">HTTP_SERVER_ERROR</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_UNAUTHORIZED">HTTP_UNAUTHORIZED</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_UNAVAILABLE">HTTP_UNAVAILABLE</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_UNSUPPORTED_TYPE">HTTP_UNSUPPORTED_TYPE</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_USE_PROXY">HTTP_USE_PROXY</a>, <a href="../../../java/net/HttpURLConnection.html#HTTP_VERSION">HTTP_VERSION</a>, <a href="../../../java/net/HttpURLConnection.html#instanceFollowRedirects">instanceFollowRedirects</a>, <a href="../../../java/net/HttpURLConnection.html#method">method</a>, <a href="../../../java/net/HttpURLConnection.html#responseCode">responseCode</a>, <a href="../../../java/net/HttpURLConnection.html#responseMessage">responseMessage</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.java.net.URLConnection">
<!-- --> </a> <h3>Fields inherited from class java.net.<a href="../../../java/net/URLConnection.html" title="class in java.net">URLConnection</a></h3> <code><a href="../../../java/net/URLConnection.html#allowUserInteraction">allowUserInteraction</a>, <a href="../../../java/net/URLConnection.html#connected">connected</a>, <a href="../../../java/net/URLConnection.html#doInput">doInput</a>, <a href="../../../java/net/URLConnection.html#doOutput">doOutput</a>, <a href="../../../java/net/URLConnection.html#ifModifiedSince">ifModifiedSince</a>, <a href="../../../java/net/URLConnection.html#url">url</a>, <a href="../../../java/net/URLConnection.html#useCaches">useCaches</a></code></li>
</ul> </li>
</ul>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier</th>
<th class="colLast" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/HttpsURLConnection.html#HttpsURLConnection-java.net.URL-">HttpsURLConnection</a></span>(<a href="../../../java/net/URL.html" title="class in java.net">URL</a> url)</code>
<div class="block">
创建一个
<code>HttpsURLConnection</code>使用指定的URL。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t1"><span><a href="javascript:show(1);">静态方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t4"><span><a href="javascript:show(8);">具体的方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code>abstract <a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/HttpsURLConnection.html#getCipherSuite--">getCipherSuite</a></span>()</code>
<div class="block">
返回此连接上正在使用的密码套件。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>static <a href="../../../javax/net/ssl/HostnameVerifier.html" title="interface in javax.net.ssl">HostnameVerifier</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/HttpsURLConnection.html#getDefaultHostnameVerifier--">getDefaultHostnameVerifier</a></span>()</code>
<div class="block">
获取由此类的新实例继承的默认值
<code>HostnameVerifier</code>
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>static <a href="../../../javax/net/ssl/SSLSocketFactory.html" title="class in javax.net.ssl">SSLSocketFactory</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/HttpsURLConnection.html#getDefaultSSLSocketFactory--">getDefaultSSLSocketFactory</a></span>()</code>
<div class="block">
获取由此类的新实例继承的默认静态
<code>SSLSocketFactory</code>
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../javax/net/ssl/HostnameVerifier.html" title="interface in javax.net.ssl">HostnameVerifier</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/HttpsURLConnection.html#getHostnameVerifier--">getHostnameVerifier</a></span>()</code>
<div class="block">
获得这个实例上的
<code>HostnameVerifier</code>
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>abstract <a href="../../../java/security/cert/Certificate.html" title="class in java.security.cert">Certificate</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/HttpsURLConnection.html#getLocalCertificates--">getLocalCertificates</a></span>()</code>
<div class="block">
返回在握手期间发送到服务器的证书。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../../java/security/Principal.html" title="interface in java.security">Principal</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/HttpsURLConnection.html#getLocalPrincipal--">getLocalPrincipal</a></span>()</code>
<div class="block">
返回在握手期间发送到服务器的主体。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../../java/security/Principal.html" title="interface in java.security">Principal</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/HttpsURLConnection.html#getPeerPrincipal--">getPeerPrincipal</a></span>()</code>
<div class="block">
返回作为定义会话的一部分而建立的服务器的主体。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>abstract <a href="../../../java/security/cert/Certificate.html" title="class in java.security.cert">Certificate</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/HttpsURLConnection.html#getServerCertificates--">getServerCertificates</a></span>()</code>
<div class="block">
返回作为定义会话一部分而建立的服务器的证书链。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code><a href="../../../javax/net/ssl/SSLSocketFactory.html" title="class in javax.net.ssl">SSLSocketFactory</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/HttpsURLConnection.html#getSSLSocketFactory--">getSSLSocketFactory</a></span>()</code>
<div class="block">
获取为安全的https URL连接创建套接字时要使用的SSL套接字工厂。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>static void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/HttpsURLConnection.html#setDefaultHostnameVerifier-javax.net.ssl.HostnameVerifier-">setDefaultHostnameVerifier</a></span>(<a href="../../../javax/net/ssl/HostnameVerifier.html" title="interface in javax.net.ssl">HostnameVerifier</a> v)</code>
<div class="block">
设置由此类的新实例继承的默认值
<code>HostnameVerifier</code>
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>static void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/HttpsURLConnection.html#setDefaultSSLSocketFactory-javax.net.ssl.SSLSocketFactory-">setDefaultSSLSocketFactory</a></span>(<a href="../../../javax/net/ssl/SSLSocketFactory.html" title="class in javax.net.ssl">SSLSocketFactory</a> sf)</code>
<div class="block">
设置由此类的新实例继承的默认值
<code>SSLSocketFactory</code>
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/HttpsURLConnection.html#setHostnameVerifier-javax.net.ssl.HostnameVerifier-">setHostnameVerifier</a></span>(<a href="../../../javax/net/ssl/HostnameVerifier.html" title="interface in javax.net.ssl">HostnameVerifier</a> v)</code>
<div class="block">
设置此实例的
<code>HostnameVerifier</code>
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/HttpsURLConnection.html#setSSLSocketFactory-javax.net.ssl.SSLSocketFactory-">setSSLSocketFactory</a></span>(<a href="../../../javax/net/ssl/SSLSocketFactory.html" title="class in javax.net.ssl">SSLSocketFactory</a> sf)</code>
<div class="block">
设置
<code>SSLSocketFactory</code>当此实例创建安全https URL连接插座使用。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.net.HttpURLConnection">
<!-- --> </a> <h3>Methods inherited from class java.net.<a href="../../../java/net/HttpURLConnection.html" title="class in java.net">HttpURLConnection</a></h3> <code><a href="../../../java/net/HttpURLConnection.html#disconnect--">disconnect</a>, <a href="../../../java/net/HttpURLConnection.html#getErrorStream--">getErrorStream</a>, <a href="../../../java/net/HttpURLConnection.html#getFollowRedirects--">getFollowRedirects</a>, <a href="../../../java/net/HttpURLConnection.html#getHeaderField-int-">getHeaderField</a>, <a href="../../../java/net/HttpURLConnection.html#getHeaderFieldDate-java.lang.String-long-">getHeaderFieldDate</a>, <a href="../../../java/net/HttpURLConnection.html#getHeaderFieldKey-int-">getHeaderFieldKey</a>, <a href="../../../java/net/HttpURLConnection.html#getInstanceFollowRedirects--">getInstanceFollowRedirects</a>, <a href="../../../java/net/HttpURLConnection.html#getPermission--">getPermission</a>, <a href="../../../java/net/HttpURLConnection.html#getRequestMethod--">getRequestMethod</a>, <a href="../../../java/net/HttpURLConnection.html#getResponseCode--">getResponseCode</a>, <a href="../../../java/net/HttpURLConnection.html#getResponseMessage--">getResponseMessage</a>, <a href="../../../java/net/HttpURLConnection.html#setChunkedStreamingMode-int-">setChunkedStreamingMode</a>, <a href="../../../java/net/HttpURLConnection.html#setFixedLengthStreamingMode-int-">setFixedLengthStreamingMode</a>, <a href="../../../java/net/HttpURLConnection.html#setFixedLengthStreamingMode-long-">setFixedLengthStreamingMode</a>, <a href="../../../java/net/HttpURLConnection.html#setFollowRedirects-boolean-">setFollowRedirects</a>, <a href="../../../java/net/HttpURLConnection.html#setInstanceFollowRedirects-boolean-">setInstanceFollowRedirects</a>, <a href="../../../java/net/HttpURLConnection.html#setRequestMethod-java.lang.String-">setRequestMethod</a>, <a href="../../../java/net/HttpURLConnection.html#usingProxy--">usingProxy</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.net.URLConnection">
<!-- --> </a> <h3>Methods inherited from class java.net.<a href="../../../java/net/URLConnection.html" title="class in java.net">URLConnection</a></h3> <code><a href="../../../java/net/URLConnection.html#addRequestProperty-java.lang.String-java.lang.String-">addRequestProperty</a>, <a href="../../../java/net/URLConnection.html#connect--">connect</a>, <a href="../../../java/net/URLConnection.html#getAllowUserInteraction--">getAllowUserInteraction</a>, <a href="../../../java/net/URLConnection.html#getConnectTimeout--">getConnectTimeout</a>, <a href="../../../java/net/URLConnection.html#getContent--">getContent</a>, <a href="../../../java/net/URLConnection.html#getContent-java.lang.Class:A-">getContent</a>, <a href="../../../java/net/URLConnection.html#getContentEncoding--">getContentEncoding</a>, <a href="../../../java/net/URLConnection.html#getContentLength--">getContentLength</a>, <a href="../../../java/net/URLConnection.html#getContentLengthLong--">getContentLengthLong</a>, <a href="../../../java/net/URLConnection.html#getContentType--">getContentType</a>, <a href="../../../java/net/URLConnection.html#getDate--">getDate</a>, <a href="../../../java/net/URLConnection.html#getDefaultAllowUserInteraction--">getDefaultAllowUserInteraction</a>, <a href="../../../java/net/URLConnection.html#getDefaultRequestProperty-java.lang.String-">getDefaultRequestProperty</a>, <a href="../../../java/net/URLConnection.html#getDefaultUseCaches--">getDefaultUseCaches</a>, <a href="../../../java/net/URLConnection.html#getDoInput--">getDoInput</a>, <a href="../../../java/net/URLConnection.html#getDoOutput--">getDoOutput</a>, <a href="../../../java/net/URLConnection.html#getExpiration--">getExpiration</a>, <a href="../../../java/net/URLConnection.html#getFileNameMap--">getFileNameMap</a>, <a href="../../../java/net/URLConnection.html#getHeaderField-java.lang.String-">getHeaderField</a>, <a href="../../../java/net/URLConnection.html#getHeaderFieldInt-java.lang.String-int-">getHeaderFieldInt</a>, <a href="../../../java/net/URLConnection.html#getHeaderFieldLong-java.lang.String-long-">getHeaderFieldLong</a>, <a href="../../../java/net/URLConnection.html#getHeaderFields--">getHeaderFields</a>, <a href="../../../java/net/URLConnection.html#getIfModifiedSince--">getIfModifiedSince</a>, <a href="../../../java/net/URLConnection.html#getInputStream--">getInputStream</a>, <a href="../../../java/net/URLConnection.html#getLastModified--">getLastModified</a>, <a href="../../../java/net/URLConnection.html#getOutputStream--">getOutputStream</a>, <a href="../../../java/net/URLConnection.html#getReadTimeout--">getReadTimeout</a>, <a href="../../../java/net/URLConnection.html#getRequestProperties--">getRequestProperties</a>, <a href="../../../java/net/URLConnection.html#getRequestProperty-java.lang.String-">getRequestProperty</a>, <a href="../../../java/net/URLConnection.html#getURL--">getURL</a>, <a href="../../../java/net/URLConnection.html#getUseCaches--">getUseCaches</a>, <a href="../../../java/net/URLConnection.html#guessContentTypeFromName-java.lang.String-">guessContentTypeFromName</a>, <a href="../../../java/net/URLConnection.html#guessContentTypeFromStream-java.io.InputStream-">guessContentTypeFromStream</a>, <a href="../../../java/net/URLConnection.html#setAllowUserInteraction-boolean-">setAllowUserInteraction</a>, <a href="../../../java/net/URLConnection.html#setConnectTimeout-int-">setConnectTimeout</a>, <a href="../../../java/net/URLConnection.html#setContentHandlerFactory-java.net.ContentHandlerFactory-">setContentHandlerFactory</a>, <a href="../../../java/net/URLConnection.html#setDefaultAllowUserInteraction-boolean-">setDefaultAllowUserInteraction</a>, <a href="../../../java/net/URLConnection.html#setDefaultRequestProperty-java.lang.String-java.lang.String-">setDefaultRequestProperty</a>, <a href="../../../java/net/URLConnection.html#setDefaultUseCaches-boolean-">setDefaultUseCaches</a>, <a href="../../../java/net/URLConnection.html#setDoInput-boolean-">setDoInput</a>, <a href="../../../java/net/URLConnection.html#setDoOutput-boolean-">setDoOutput</a>, <a href="../../../java/net/URLConnection.html#setFileNameMap-java.net.FileNameMap-">setFileNameMap</a>, <a href="../../../java/net/URLConnection.html#setIfModifiedSince-long-">setIfModifiedSince</a>, <a href="../../../java/net/URLConnection.html#setReadTimeout-int-">setReadTimeout</a>, <a href="../../../java/net/URLConnection.html#setRequestProperty-java.lang.String-java.lang.String-">setRequestProperty</a>, <a href="../../../java/net/URLConnection.html#setUseCaches-boolean-">setUseCaches</a>, <a href="../../../java/net/URLConnection.html#toString--">toString</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../../java/lang/Object.html#clone--">clone</a>, <a href="../../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../../java/lang/Object.html#notify--">notify</a>, <a href="../../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../../java/lang/Object.html#wait--">wait</a>, <a href="../../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- --> </a> <h3>字段详细信息</h3> <a name="hostnameVerifier">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>hostnameVerifier</h4> <pre>protected <a href="../../../javax/net/ssl/HostnameVerifier.html" title="interface in javax.net.ssl">HostnameVerifier</a> hostnameVerifier</pre>
<div class="block">
这个对象的
<code>hostnameVerifier</code>
</div> </li>
</ul> </li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="HttpsURLConnection-java.net.URL-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>HttpsURLConnection</h4> <pre>protected HttpsURLConnection(<a href="../../../java/net/URL.html" title="class in java.net">URL</a> url)</pre>
<div class="block">
创建一个
<code>HttpsURLConnection</code>使用指定的URL。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>url</code> - 网址
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getCipherSuite--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCipherSuite</h4> <pre>public abstract <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getCipherSuite()</pre>
<div class="block">
返回此连接上正在使用的密码套件。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
密码套件
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果在建立连接之前调用此方法。
</dd>
</dl> </li>
</ul> <a name="getLocalCertificates--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLocalCertificates</h4> <pre>public abstract <a href="../../../java/security/cert/Certificate.html" title="class in java.security.cert">Certificate</a>[] getLocalCertificates()</pre>
<div class="block">
<span>返回在握手期间发送到服务器的证书。</span>
<p> <span>注意:此方法仅在使用基于证书的密码套件时有用。</span> </p>
<p> <span>当多个证书可用于握手时,该实现将选择它认为“最佳”证书链可用,并将其传输到另一方。</span> <span>该方法允许调用者知道实际发送了哪个证书链。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>有序的证书阵列,客户自己的证书首先跟随任何证书颁发机构。</span>
<span>如果没有发送证书则返回null。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果在建立连接之前调用此方法。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/HttpsURLConnection.html#getLocalPrincipal--"><code>getLocalPrincipal()</code></a>
</dd>
</dl> </li>
</ul> <a name="getServerCertificates--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getServerCertificates</h4> <pre>public abstract <a href="../../../java/security/cert/Certificate.html" title="class in java.security.cert">Certificate</a>[] getServerCertificates()
throws <a href="../../../javax/net/ssl/SSLPeerUnverifiedException.html" title="class in javax.net.ssl">SSLPeerUnverifiedException</a></pre>
<div class="block">
<span>返回作为定义会话一部分而建立的服务器的证书链。</span>
<p> <span>注意:此方法只能在使用基于证书的密码套件时使用;</span> <span>与非基于证书的密码套件如Kerberos一起使用将抛出SSLPeerUnverifiedException异常。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个有序的服务器证书阵列,首先是对等体自己的证书,然后是任何证书颁发机构。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/net/ssl/SSLPeerUnverifiedException.html" title="class in javax.net.ssl">SSLPeerUnverifiedException</a></code> - 如果对等体未被验证。
</dd>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果在建立连接之前调用此方法。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/HttpsURLConnection.html#getPeerPrincipal--"><code>getPeerPrincipal()</code></a>
</dd>
</dl> </li>
</ul> <a name="getPeerPrincipal--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPeerPrincipal</h4> <pre>public <a href="../../../java/security/Principal.html" title="interface in java.security">Principal</a> getPeerPrincipal()
throws <a href="../../../javax/net/ssl/SSLPeerUnverifiedException.html" title="class in javax.net.ssl">SSLPeerUnverifiedException</a></pre>
<div class="block">
<span>返回作为定义会话的一部分而建立的服务器的主体。</span>
<p> <span>注意:子类应该覆盖此方法。</span> <span>如果没有被覆盖它将默认返回服务器的最终实体证书的X500Principal用于基于证书的密码体制或为非基于证书的密码例如Kerberos引发SSLPeerUnverifiedException。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>服务器的主体。</span>
<span>返回基于X509的密码套件的终端实体认证的X500Principal以及Kerberos密码套件的KerberosPrincipal。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/net/ssl/SSLPeerUnverifiedException.html" title="class in javax.net.ssl">SSLPeerUnverifiedException</a></code> - 如果对等体未被验证
</dd>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果在建立连接之前调用此方法。
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.5
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/HttpsURLConnection.html#getServerCertificates--"><code>getServerCertificates()</code></a>
<a href="../../../javax/net/ssl/HttpsURLConnection.html#getLocalPrincipal--"><code>getLocalPrincipal()</code></a>
</dd>
</dl> </li>
</ul> <a name="getLocalPrincipal--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLocalPrincipal</h4> <pre>public <a href="../../../java/security/Principal.html" title="interface in java.security">Principal</a> getLocalPrincipal()</pre>
<div class="block">
<span>返回在握手期间发送到服务器的主体。</span>
<p> <span>注意:子类应该覆盖此方法。</span> <span>如果没有被覆盖它将默认返回发送到服务器的最终实体证书的X500Principal用于基于证书的密码体制或者返回非基于密码密码的密码例如Kerberos。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>委托人发送到服务器。</span>
<span>返回基于X509的密码套件的终端实体证书的X500PrincipalKerberos密码套件的KerberosPrincipal。</span>
<span>如果没有发送主体则返回null。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果在建立连接之前调用此方法。
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.5
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/HttpsURLConnection.html#getLocalCertificates--"><code>getLocalCertificates()</code></a>
<a href="../../../javax/net/ssl/HttpsURLConnection.html#getPeerPrincipal--"><code>getPeerPrincipal()</code></a>
</dd>
</dl> </li>
</ul> <a name="setDefaultHostnameVerifier-javax.net.ssl.HostnameVerifier-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setDefaultHostnameVerifier</h4> <pre>public static void setDefaultHostnameVerifier(<a href="../../../javax/net/ssl/HostnameVerifier.html" title="interface in javax.net.ssl">HostnameVerifier</a> v)</pre>
<div class="block">
<span>设置由此类的新实例继承的默认值<code>HostnameVerifier</code></span>
<p> <span>如果未调用此方法,则默认的<code>HostnameVerifier</code>假定不允许连接。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>v</code> - 默认主机名验证程序
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>HostnameVerifier</code>参数为空。
</dd>
<dd>
<code><a href="../../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</a></code> - 如果存在安全管理员,并且其
<code>checkPermission</code>方法不允许
<code>SSLPermission("setHostnameVerifier")</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/HttpsURLConnection.html#getDefaultHostnameVerifier--"><code>getDefaultHostnameVerifier()</code></a>
</dd>
</dl> </li>
</ul> <a name="getDefaultHostnameVerifier--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDefaultHostnameVerifier</h4> <pre>public static <a href="../../../javax/net/ssl/HostnameVerifier.html" title="interface in javax.net.ssl">HostnameVerifier</a> getDefaultHostnameVerifier()</pre>
<div class="block">
获取由此类的新实例继承的默认值
<code>HostnameVerifier</code>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
默认主机名验证器
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/HttpsURLConnection.html#setDefaultHostnameVerifier-javax.net.ssl.HostnameVerifier-"><code>setDefaultHostnameVerifier(HostnameVerifier)</code></a>
</dd>
</dl> </li>
</ul> <a name="setHostnameVerifier-javax.net.ssl.HostnameVerifier-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setHostnameVerifier</h4> <pre>public void setHostnameVerifier(<a href="../../../javax/net/ssl/HostnameVerifier.html" title="interface in javax.net.ssl">HostnameVerifier</a> v)</pre>
<div class="block">
<span>设置这个实例的<code>HostnameVerifier</code></span>
<p> <span>此类的新实例将继承由<a href="../../../javax/net/ssl/HttpsURLConnection.html#setDefaultHostnameVerifier-javax.net.ssl.HostnameVerifier-"><code>setDefaultHostnameVerifier</code></a>设置的默认静态主机名验证器。</span> <span>调用此方法替换此对象的<code>HostnameVerifier</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>v</code> - 主机名验证
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>HostnameVerifier</code>参数为空。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/HttpsURLConnection.html#getHostnameVerifier--"><code>getHostnameVerifier()</code></a>
<a href="../../../javax/net/ssl/HttpsURLConnection.html#setDefaultHostnameVerifier-javax.net.ssl.HostnameVerifier-"><code>setDefaultHostnameVerifier(HostnameVerifier)</code></a>
</dd>
</dl> </li>
</ul> <a name="getHostnameVerifier--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getHostnameVerifier</h4> <pre>public <a href="../../../javax/net/ssl/HostnameVerifier.html" title="interface in javax.net.ssl">HostnameVerifier</a> getHostnameVerifier()</pre>
<div class="block">
获得这个实例上的
<code>HostnameVerifier</code>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
主机名验证
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/HttpsURLConnection.html#setHostnameVerifier-javax.net.ssl.HostnameVerifier-"><code>setHostnameVerifier(HostnameVerifier)</code></a>
<a href="../../../javax/net/ssl/HttpsURLConnection.html#setDefaultHostnameVerifier-javax.net.ssl.HostnameVerifier-"><code>setDefaultHostnameVerifier(HostnameVerifier)</code></a>
</dd>
</dl> </li>
</ul> <a name="setDefaultSSLSocketFactory-javax.net.ssl.SSLSocketFactory-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setDefaultSSLSocketFactory</h4> <pre>public static void setDefaultSSLSocketFactory(<a href="../../../javax/net/ssl/SSLSocketFactory.html" title="class in javax.net.ssl">SSLSocketFactory</a> sf)</pre>
<div class="block">
<span>设置由此类的新实例继承的默认值<code>SSLSocketFactory</code></span>
<p> <span>为安全的https URL连接创建套接字时使用套接字工厂。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>sf</code> - 默认的SSL套接字工厂
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果SSLSocketFactory参数为空。
</dd>
<dd>
<code><a href="../../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</a></code> - 如果安全管理器存在,并且其
<code>checkSetFactory</code>方法不允许指定套接字工厂。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/HttpsURLConnection.html#getDefaultSSLSocketFactory--"><code>getDefaultSSLSocketFactory()</code></a>
</dd>
</dl> </li>
</ul> <a name="getDefaultSSLSocketFactory--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDefaultSSLSocketFactory</h4> <pre>public static <a href="../../../javax/net/ssl/SSLSocketFactory.html" title="class in javax.net.ssl">SSLSocketFactory</a> getDefaultSSLSocketFactory()</pre>
<div class="block">
<span>获取由该类的新实例继承的默认静态<code>SSLSocketFactory</code></span>
<p> <span>为安全的https URL连接创建套接字时使用套接字工厂。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
默认为
<code>SSLSocketFactory</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/HttpsURLConnection.html#setDefaultSSLSocketFactory-javax.net.ssl.SSLSocketFactory-"><code>setDefaultSSLSocketFactory(SSLSocketFactory)</code></a>
</dd>
</dl> </li>
</ul> <a name="setSSLSocketFactory-javax.net.ssl.SSLSocketFactory-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setSSLSocketFactory</h4> <pre>public void setSSLSocketFactory(<a href="../../../javax/net/ssl/SSLSocketFactory.html" title="class in javax.net.ssl">SSLSocketFactory</a> sf)</pre>
<div class="block">
<span>设置<code>SSLSocketFactory</code>当此实例创建安全https URL连接插座使用。</span>
<p> <span>此类的新实例将继承由<code>SSLSocketFactory</code>设置的默认静态<a href="../../../javax/net/ssl/HttpsURLConnection.html#setDefaultSSLSocketFactory-javax.net.ssl.SSLSocketFactory-">SSLSocketFactory</a></span> <span>调用此方法替换此对象的<code>SSLSocketFactory</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>sf</code> - SSL套接字工厂
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>SSLSocketFactory</code>参数为空。
</dd>
<dd>
<code><a href="../../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</a></code> - 如果存在安全管理员,并且其
<code>checkSetFactory</code>方法不允许指定套接字工厂。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/HttpsURLConnection.html#getSSLSocketFactory--"><code>getSSLSocketFactory()</code></a>
</dd>
</dl> </li>
</ul> <a name="getSSLSocketFactory--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getSSLSocketFactory</h4> <pre>public <a href="../../../javax/net/ssl/SSLSocketFactory.html" title="class in javax.net.ssl">SSLSocketFactory</a> getSSLSocketFactory()</pre>
<div class="block">
获取为安全的https URL连接创建套接字时要使用的SSL套接字工厂。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>SSLSocketFactory</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/HttpsURLConnection.html#setSSLSocketFactory-javax.net.ssl.SSLSocketFactory-"><code>setSSLSocketFactory(SSLSocketFactory)</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>