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

<div class="header">
<div class="subTitle">
     compact1, compact2, compact3 
   </div>
<div class="subTitle">
     javax.net.ssl 
   </div>
<h2 class="title" title="Interface SSLSession">Interface SSLSession</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
        所有已知实现类：
       </dt>
<dd>
<span><a href="../../../javax/net/ssl/ExtendedSSLSession.html" title="javax.net.ssl中的类">ExtendedSSLSession</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">SSLSession</span></pre>
<div class="block">
<span>在SSL中，会话用于描述两个实体之间持续的关系。</span>
<span>每个SSL连接一次涉及一个会话，但该会话可以在这些实体之间的许多连接上同时或顺序使用。</span>
<span>连接上使用的会话也可以被不同的会话替换。</span>
<span>会话被创建或重新加入，作为SSL握手协议的一部分。</span>
<span>会话可能由于影响安全性或资源使用的策略或明确调用<code>invalidate</code>应用程序而<code>invalidate</code> 。</span>
<span>会话管理策略通常用于调整性能。</span>
<p> <span>除了标准会话属性之外，SSL会话会公开这些只读属性：</span> </p>
<ul>
<li> <span><em>同行身份</em></span> <span>会话在特定客户端和特定服务器之间。</span> <span>对等体的身份可能已被建立为会话设置的一部分。</span> <span>同行通常由X.509证书链标识。</span> </li>
<li> <span><em>密码套件名称。</em></span> <span>密码套件描述了特定会话中连接使用的加密保护类型。</span> </li>
<li> <span><em>同伴主持人</em></span> <span>会话中的所有连接位于相同的两个主机之间。</span> <span>连接另一端的主机地址可用。</span> </li>
</ul>
<p> <span>会话可能会被明确无效。</span> <span>当面临某些种类的错误时，也可以隐式地完成无效。</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">
<!-- ========== 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="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>
</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>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/SSLSession.html#getApplicationBufferSize--">getApplicationBufferSize</a></span>()</code>
<div class="block">
              获取使用此会话时预期的最大应用程序数据的当前大小。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><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/SSLSession.html#getCipherSuite--">getCipherSuite</a></span>()</code>
<div class="block">
              返回用于会话中所有连接的SSL加密套件的名称。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>long</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/SSLSession.html#getCreationTime--">getCreationTime</a></span>()</code>
<div class="block">
              返回此会话表示形式创建的时间，以1970年1月1日UTC为午夜的毫秒计。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>byte[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/SSLSession.html#getId--">getId</a></span>()</code>
<div class="block">
              返回分配给此会话的标识符。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>long</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/SSLSession.html#getLastAccessedTime--">getLastAccessedTime</a></span>()</code>
<div class="block">
              返回会话级基础架构访问该会话表示的最后一次，以毫秒为单位，自1970年1月1日UTC之后。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><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/SSLSession.html#getLocalCertificates--">getLocalCertificates</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/SSLSession.html#getLocalPrincipal--">getLocalPrincipal</a></span>()</code>
<div class="block">
              返回在握手期间发送给对等体的主体。 
            </div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/SSLSession.html#getPacketBufferSize--">getPacketBufferSize</a></span>()</code>
<div class="block">
              获取使用此会话时预期的最大SSL / TLS数据包的当前大小。 
            </div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code><a href="../../../javax/security/cert/X509Certificate.html" title="class in javax.security.cert">X509Certificate</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/SSLSession.html#getPeerCertificateChain--">getPeerCertificateChain</a></span>()</code>
<div class="block">
              返回被确定为定义会话一部分的对等体的身份。 
            </div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code><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/SSLSession.html#getPeerCertificates--">getPeerCertificates</a></span>()</code>
<div class="block">
              返回作为定义会话的一部分而建立的对等体的身份。 
            </div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code><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/SSLSession.html#getPeerHost--">getPeerHost</a></span>()</code>
<div class="block">
              返回此会话中对等体的主机名。 
            </div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/SSLSession.html#getPeerPort--">getPeerPort</a></span>()</code>
<div class="block">
              返回此会话中对等端口的端口号。 
            </div> </td>
</tr>
<tr class="altColor" id="i12">
<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/SSLSession.html#getPeerPrincipal--">getPeerPrincipal</a></span>()</code>
<div class="block">
              返回作为定义会话的一部分而建立的对等体的身份。 
            </div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code><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/SSLSession.html#getProtocol--">getProtocol</a></span>()</code>
<div class="block">
              返回用于会话中所有连接的协议的标准名称。 
            </div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code><a href="../../../javax/net/ssl/SSLSessionContext.html" title="interface in javax.net.ssl">SSLSessionContext</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/SSLSession.html#getSessionContext--">getSessionContext</a></span>()</code>
<div class="block">
              返回此会话绑定的上下文。 
            </div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/SSLSession.html#getValue-java.lang.String-">getValue</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
              返回绑定到会话应用层数据中给定名称的对象。 
            </div> </td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code><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/SSLSession.html#getValueNames--">getValueNames</a></span>()</code>
<div class="block">
              返回绑定到会话中的所有应用层数据对象的名称数组。 
            </div> </td>
</tr>
<tr class="rowColor" id="i17">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/SSLSession.html#invalidate--">invalidate</a></span>()</code>
<div class="block">
              使会话无效。 
            </div> </td>
</tr>
<tr class="altColor" id="i18">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/SSLSession.html#isValid--">isValid</a></span>()</code>
<div class="block">
              返回此会话是否有效并可用于恢复或加入。 
            </div> </td>
</tr>
<tr class="rowColor" id="i19">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/SSLSession.html#putValue-java.lang.String-java.lang.Object-">putValue</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> value)</code>
<div class="block">
              结合指定 
             <code>value</code>对象与给定的会话的应用层数据 
             <code>name</code> 。 
            </div> </td>
</tr>
<tr class="altColor" id="i20">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/net/ssl/SSLSession.html#removeValue-java.lang.String-">removeValue</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
              删除在会话的应用层数据中绑定到给定名称的对象。 
            </div> </td>
</tr>
</tbody>
</table> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getId--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getId</h4> <pre>byte[] getId()</pre>
<div class="block">
            返回分配给此会话的标识符。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             会话标识符 
           </dd>
</dl> </li>
</ul> <a name="getSessionContext--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSessionContext</h4> <pre><a href="../../../javax/net/ssl/SSLSessionContext.html" title="interface in javax.net.ssl">SSLSessionContext</a> getSessionContext()</pre>
<div class="block">
<span>返回此会话绑定的上下文。</span>
<p> <span>这种情况在某些环境中可能不可用，在这种情况下，此方法返回null。</span> </p>
<p> <span>如果上下文可用并且安装了安全管理器，则调用者可能需要访问它的权限或者可能抛出安全异常。</span> <span>在Java环境中，安全管理器的<code>checkPermission</code>方法被调用了<code>SSLPermission("getSSLSessionContext")</code>许可。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             用于此会话的会话上下文，如果上下文不可用，则为null。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</a></code> - 如果调用线程没有获取SSL会话上下文的权限。 
           </dd>
</dl> </li>
</ul> <a name="getCreationTime--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCreationTime</h4> <pre>long getCreationTime()</pre>
<div class="block">
            返回此会话表示形式创建的时间，以1970年1月1日UTC为午夜的毫秒计。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             此会话创建的时间 
           </dd>
</dl> </li>
</ul> <a name="getLastAccessedTime--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLastAccessedTime</h4> <pre>long getLastAccessedTime()</pre>
<div class="block">
<span>返回会话级基础架构访问该会话表示的最后一次，以毫秒为单位，自1970年1月1日UTC之后。</span>
<p> <span>Access表示使用会话数据建立新连接。</span> <span>应用程序级操作（如获取或设置与会话关联的值）不会在此访问时间中反映出来。</span> </p>
<p> <span>此信息在会话管理策略中特别有用。</span> <span>例如，会话管理器线程可以在给定的上下文中留下所有未被长时间使用的会话;</span> <span>或者，可以根据年龄对会话进行排序以优化某些任务。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             上次访问此会话 
           </dd>
</dl> </li>
</ul> <a name="invalidate--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>invalidate</h4> <pre>void invalidate()</pre>
<div class="block">
<span>使会话无效。</span>
<p> <span>未来的连接将无法恢复或加入此会话。</span> <span>但是，使用此会话的任何现有连接都可以继续使用会话，直到连接关闭。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/SSLSession.html#isValid--"><code>isValid()</code></a>
</dd>
</dl> </li>
</ul> <a name="isValid--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isValid</h4> <pre>boolean isValid()</pre>
<div class="block">
            返回此会话是否有效并可用于恢复或加入。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             如果此会话可能重新加入，则为true。 
           </dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             1.5 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/SSLSession.html#invalidate--"><code>invalidate()</code></a>
</dd>
</dl> </li>
</ul> <a name="putValue-java.lang.String-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>putValue</h4> <pre>void putValue(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
              <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> value)</pre>
<div class="block">
<span>结合指定<code>value</code>对象与给定的会话的应用层数据<code>name</code> 。</span>
<p> <span>使用相同的现有绑定<code>name</code>被替换。</span> <span>如果新（或现有的） <code>value</code>实现了<code>SSLSessionBindingListener</code>接口，那么<code>SSLSessionBindingListener</code>表示的对象被<code>value</code>通知。</span> </p>
<p> <span>出于安全考虑，在不同的访问控制上下文中可能看不到相同的命名值。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>name</code> - 要绑定数据对象的名称。</span>
<span>这可能不是null。</span>
</dd>
<dd>
<span><code>value</code> - 要绑定的数据对象。</span>
<span>这可能不是null。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果任一参数为空。 
           </dd>
</dl> </li>
</ul> <a name="getValue-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getValue</h4> <pre><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> getValue(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</pre>
<div class="block">
<span>返回绑定到会话应用层数据中给定名称的对象。</span>
<span>如果没有这样的绑定，则返回null。</span>
<p> <span>出于安全考虑，在不同的访问控制上下文中可能看不到相同的命名值。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> -找到绑定的名称。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             绑定到该名称的值，如果绑定不存在则为null。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果参数为空。 
           </dd>
</dl> </li>
</ul> <a name="removeValue-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeValue</h4> <pre>void removeValue(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</pre>
<div class="block">
<span>删除在会话的应用层数据中绑定到给定名称的对象。</span>
<span>如果没有绑定到给定名称的对象，则不执行任何操作。</span>
<span>如果被绑定的现有对象实现<code>SessionBindingListener</code>接口，它被适当地通知。</span>
<p> <span>出于安全考虑，在不同的访问控制上下文中可能看不到相同的命名值。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要移除的对象的名称可跨不同访问控制上下文显示 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果参数为空。 
           </dd>
</dl> </li>
</ul> <a name="getValueNames--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getValueNames</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] getValueNames()</pre>
<div class="block">
<span>返回绑定到会话中的所有应用层数据对象的名称数组。</span>
<p> <span>出于安全考虑，在不同的访问控制上下文中可能看不到相同的命名值。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             绑定到此会话的对象的非空（可能为空）数组。 
           </dd>
</dl> </li>
</ul> <a name="getPeerCertificates--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPeerCertificates</h4> <pre><a href="../../../java/security/cert/Certificate.html" title="class in java.security.cert">Certificate</a>[] getPeerCertificates()
                           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>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/SSLSession.html#getPeerPrincipal--"><code>getPeerPrincipal()</code></a>
</dd>
</dl> </li>
</ul> <a name="getLocalCertificates--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLocalCertificates</h4> <pre><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="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/SSLSession.html#getLocalPrincipal--"><code>getLocalPrincipal()</code></a>
</dd>
</dl> </li>
</ul> <a name="getPeerCertificateChain--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPeerCertificateChain</h4> <pre><a href="../../../javax/security/cert/X509Certificate.html" title="class in javax.security.cert">X509Certificate</a>[] getPeerCertificateChain()
                                   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>
<p> <span><em>注意：此方法与以前的版本兼容。</em></span> <span><em>新的应用程序应该使用<a href="../../../javax/net/ssl/SSLSession.html#getPeerCertificates--"><code>getPeerCertificates()</code></a> 。</em></span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一个对等X.509证书的有序阵列，其中首先使用对等体自己的证书，然后是任何证书颁发机构。</span>
<span>（证书是原始的JSSE证书<a href="../../../javax/security/cert/X509Certificate.html" title="javax.security.cert中的类"><code>X509Certificate</code></a>格式。）</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>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/SSLSession.html#getPeerPrincipal--"><code>getPeerPrincipal()</code></a>
</dd>
</dl> </li>
</ul> <a name="getPeerPrincipal--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPeerPrincipal</h4> <pre><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">
            返回作为定义会话的一部分而建立的对等体的身份。 
          </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>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             1.5 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/SSLSession.html#getPeerCertificates--"><code>getPeerCertificates()</code></a> ， 
            <a href="../../../javax/net/ssl/SSLSession.html#getLocalPrincipal--"><code>getLocalPrincipal()</code></a>
</dd>
</dl> </li>
</ul> <a name="getLocalPrincipal--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLocalPrincipal</h4> <pre><a href="../../../java/security/Principal.html" title="interface in java.security">Principal</a> getLocalPrincipal()</pre>
<div class="block">
            返回在握手期间发送给对等体的主体。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>校长发给同行。</span>
<span>返回基于X509的密码套件的终端实体证书的X500Principal，Kerberos密码套件的KerberosPrincipal。</span>
<span>如果没有发送主体，则返回null。</span>
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             1.5 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/SSLSession.html#getLocalCertificates--"><code>getLocalCertificates()</code></a> ， 
            <a href="../../../javax/net/ssl/SSLSession.html#getPeerPrincipal--"><code>getPeerPrincipal()</code></a>
</dd>
</dl> </li>
</ul> <a name="getCipherSuite--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCipherSuite</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getCipherSuite()</pre>
<div class="block">
<span>返回用于会话中所有连接的SSL加密套件的名称。</span>
<p> <span>这定义了提供给在连接上发送的数据的保护级别，包括所使用的加密类型以及认证方式的大部分方面。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             会话的密码套件的名称 
           </dd>
</dl> </li>
</ul> <a name="getProtocol--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getProtocol</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getProtocol()</pre>
<div class="block">
<span>返回用于会话中所有连接的协议的标准名称。</span>
<p> <span>这定义了连接中使用的协议。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             用于会话中所有连接的协议的标准名称。 
           </dd>
</dl> </li>
</ul> <a name="getPeerHost--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPeerHost</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getPeerHost()</pre>
<div class="block">
<span>返回此会话中对等体的主机名。</span>
<p> <span>对于服务器，这是客户端的主机;</span> <span>对于客户端，它是服务器的主机。</span> <span>该名称可能不是完全限定的主机名，甚至是主机名，因为它可能代表对等体的网络地址的字符串编码。</span> <span>如果需要这样的名称，可以通过基于此方法返回的值的名称服务来解决。</span> </p>
<p> <span>该值未通过身份验证，不应被依赖。</span> <span>它主要用作<code>SSLSession</code>缓存策略的提示。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             对等主机的主机名，如果没有可用信息，则为null。 
           </dd>
</dl> </li>
</ul> <a name="getPeerPort--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPeerPort</h4> <pre>int getPeerPort()</pre>
<div class="block">
<span>返回此会话中对等端口的端口号。</span>
<p> <span>对于服务器，这是客户端的端口号;</span> <span>对于客户端，它是服务器的端口号。</span> </p>
<p> <span>该值未通过身份验证，不应被依赖。</span> <span>它主要用作<code>SSLSession</code>缓存策略的提示。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             对等主机的端口号，如果没有信息可用，则为-1。 
           </dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             1.5 
           </dd>
</dl> </li>
</ul> <a name="getPacketBufferSize--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPacketBufferSize</h4> <pre>int getPacketBufferSize()</pre>
<div class="block">
<span>获取使用此会话时预期的最大SSL / TLS数据包的当前大小。</span>
<p> <span>使用此会话的<code>SSLEngine</code>可以生成任何大小的SSL / TLS数据包，包括此方法返回的值。</span> <span>所有<code>SSLEngine</code>网络缓冲区的大小至少应该大到这一点，以避免执行<code>wrap</code>和<code>unwrap</code>调用时空间不足的问题。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             当前最大预期网络包大小 
           </dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             1.5 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/SSLEngine.html#wrap-java.nio.ByteBuffer-java.nio.ByteBuffer-"><code>SSLEngine.wrap(ByteBuffer, ByteBuffer)</code></a> ， 
            <a href="../../../javax/net/ssl/SSLEngine.html#unwrap-java.nio.ByteBuffer-java.nio.ByteBuffer-"><code>SSLEngine.unwrap(ByteBuffer, ByteBuffer)</code></a>
</dd>
</dl> </li>
</ul> <a name="getApplicationBufferSize--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getApplicationBufferSize</h4> <pre>int getApplicationBufferSize()</pre>
<div class="block">
<span>获取使用此会话时预期的最大应用程序数据的当前大小。</span>
<p> <span><code>SSLEngine</code>应用数据缓冲器必须足够大以容纳来自所接收的任何入站网络应用数据分组的应用数据。</span> <span>通常，出站应用程序数据缓冲区可以是任何大小。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             当前最大预期应用包大小 
           </dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             1.5 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/net/ssl/SSLEngine.html#wrap-java.nio.ByteBuffer-java.nio.ByteBuffer-"><code>SSLEngine.wrap(ByteBuffer, ByteBuffer)</code></a> ， 
            <a href="../../../javax/net/ssl/SSLEngine.html#unwrap-java.nio.ByteBuffer-java.nio.ByteBuffer-"><code>SSLEngine.unwrap(ByteBuffer, ByteBuffer)</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>