uTools-Manuals/docs/java/javax/xml/ws/spi/http/HttpExchange.html

<div class="header">
<div class="subTitle">
     javax.xml.ws.spi.http 
   </div>
<h2 class="title" title="Class HttpExchange">Class HttpExchange</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>javax.xml.ws.spi.http.HttpExchange</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">HttpExchange</span>
extends <a href="../../../../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
<div class="block">
<span>此类封装了收到的HTTP请求和在一个交换中生成的响应。</span>
<span>它提供了从客户端检查请求以及构建和发送响应的方法。</span>
<p> <span>必须关闭<code>HttpExchange</code>才能释放或重用基础资源。</span> <span>未能关闭交易所的效果未定。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         JAX-WS 2.2 
       </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>static <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/xml/ws/spi/http/HttpExchange.html#REQUEST_CIPHER_SUITE">REQUEST_CIPHER_SUITE</a></span></code>
<div class="block">
              标准属性：通过HTTPS接收请求时的密码套件值 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static <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/xml/ws/spi/http/HttpExchange.html#REQUEST_KEY_SIZE">REQUEST_KEY_SIZE</a></span></code>
<div class="block">
              标准属性：通过HTTPS接收请求时算法的位大小 
            </div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static <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/xml/ws/spi/http/HttpExchange.html#REQUEST_X509CERTIFICATE">REQUEST_X509CERTIFICATE</a></span></code>
<div class="block">
              标准属性：与请求相关联的SSL证书（如果有） 
            </div> </td>
</tr>
</tbody>
</table> </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="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#HttpExchange--">HttpExchange</a></span>()</code> </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="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>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#addResponseHeader-java.lang.String-java.lang.String-">addResponseHeader</a></span>(<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> value)</code>
<div class="block">
              添加具有给定名称和值的响应头。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#close--">close</a></span>()</code>
<div class="block">
              必须调用这个结束交换。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>abstract <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/xml/ws/spi/http/HttpExchange.html#getAttribute-java.lang.String-">getAttribute</a></span>(<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
              返回与此 
             <code>HttpExchange</code> 。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>abstract <a href="../../../../../java/util/Set.html" title="interface in java.util">Set</a>&lt;<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#getAttributeNames--">getAttributeNames</a></span>()</code>
<div class="block">
              提供与此 
             <code>HttpExchange</code>所有属性名称。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<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/xml/ws/spi/http/HttpExchange.html#getContextPath--">getContextPath</a></span>()</code>
<div class="block">
              返回应用程序中所有端点的上下文路径。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>abstract <a href="../../../../../javax/xml/ws/spi/http/HttpContext.html" title="class in javax.xml.ws.spi.http">HttpContext</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#getHttpContext--">getHttpContext</a></span>()</code>
<div class="block">
<span>返回此交易所的<a href="../../../../../javax/xml/ws/spi/http/HttpContext.html" title="javax.xml.ws.spi.http中的类"><code>HttpContext</code></a> 。</span>
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>abstract <a href="../../../../../java/net/InetSocketAddress.html" title="class in java.net">InetSocketAddress</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#getLocalAddress--">getLocalAddress</a></span>()</code>
<div class="block">
              返回收到请求的未解决的本地地址。 
            </div> </td>
</tr>
<tr class="rowColor" id="i7">
<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/xml/ws/spi/http/HttpExchange.html#getPathInfo--">getPathInfo</a></span>()</code>
<div class="block">
              返回Web服务路径后面的额外路径信息，但在请求URI中的查询字符串之前，将以“/”字符开头。 
            </div> </td>
</tr>
<tr class="altColor" id="i8">
<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/xml/ws/spi/http/HttpExchange.html#getProtocol--">getProtocol</a></span>()</code>
<div class="block">
              从请求中以 
             <i>协议/ majorVersion.minorVersion</i>的形式返回协议串。 
            </div> </td>
</tr>
<tr class="rowColor" id="i9">
<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/xml/ws/spi/http/HttpExchange.html#getQueryString--">getQueryString</a></span>()</code>
<div class="block">
              返回路径后请求URI中包含的查询字符串。 
            </div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>abstract <a href="../../../../../java/net/InetSocketAddress.html" title="class in java.net">InetSocketAddress</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#getRemoteAddress--">getRemoteAddress</a></span>()</code>
<div class="block">
              返回调用此请求的远程实体的未解析地址。 
            </div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>abstract <a href="../../../../../java/io/InputStream.html" title="class in java.io">InputStream</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#getRequestBody--">getRequestBody</a></span>()</code>
<div class="block">
              返回可以从中读取请求主体的流。 
            </div> </td>
</tr>
<tr class="altColor" id="i12">
<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/xml/ws/spi/http/HttpExchange.html#getRequestHeader-java.lang.String-">getRequestHeader</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="rowColor" id="i13">
<td class="colFirst"><code>abstract <a href="../../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a>,<a href="../../../../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a>&gt;&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#getRequestHeaders--">getRequestHeaders</a></span>()</code>
<div class="block">
              返回包含此请求中包含的HTTP标头的不可变地图。 
            </div> </td>
</tr>
<tr class="altColor" id="i14">
<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/xml/ws/spi/http/HttpExchange.html#getRequestMethod--">getRequestMethod</a></span>()</code>
<div class="block">
              获取HTTP请求方法 
            </div> </td>
</tr>
<tr class="rowColor" id="i15">
<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/xml/ws/spi/http/HttpExchange.html#getRequestURI--">getRequestURI</a></span>()</code>
<div class="block">
              将请求的URI的一部分从协议名称返回到HTTP请求的第一行中的查询字符串。 
            </div> </td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code>abstract <a href="../../../../../java/io/OutputStream.html" title="class in java.io">OutputStream</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#getResponseBody--">getResponseBody</a></span>()</code>
<div class="block">
              返回响应主体必须写入的流。 
            </div> </td>
</tr>
<tr class="rowColor" id="i17">
<td class="colFirst"><code>abstract <a href="../../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a>,<a href="../../../../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a>&gt;&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#getResponseHeaders--">getResponseHeaders</a></span>()</code>
<div class="block">
              返回一个可变地图，可以存储HTTP响应标头，哪个将作为此响应的一部分进行传输。 
            </div> </td>
</tr>
<tr class="altColor" id="i18">
<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/xml/ws/spi/http/HttpExchange.html#getScheme--">getScheme</a></span>()</code>
<div class="block">
              返回用于创建此请求的方案的名称，例如：http或https。 
            </div> </td>
</tr>
<tr class="rowColor" id="i19">
<td class="colFirst"><code>abstract <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/xml/ws/spi/http/HttpExchange.html#getUserPrincipal--">getUserPrincipal</a></span>()</code>
<div class="block">
<span>返回<a href="../../../../../java/security/Principal.html" title="java.security中的接口">代表</a>此HttpExchange的身份验证用户的<code>HttpExchange</code> 。</span>
</div> </td>
</tr>
<tr class="altColor" id="i20">
<td class="colFirst"><code>abstract boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#isUserInRole-java.lang.String-">isUserInRole</a></span>(<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> role)</code>
<div class="block">
              指示经过身份验证的用户是否包含在指定的逻辑“角色”中。 
            </div> </td>
</tr>
<tr class="rowColor" id="i21">
<td class="colFirst"><code>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#setStatus-int-">setStatus</a></span>(int status)</code>
<div class="block">
              设置响应的HTTP状态代码。 
            </div> </td>
</tr>
</tbody>
</table>
<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#toString--">toString</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="REQUEST_CIPHER_SUITE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>REQUEST_CIPHER_SUITE</h4> <pre>public static final <a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> REQUEST_CIPHER_SUITE</pre>
<div class="block">
<span>标准属性：通过HTTPS接收请求时的密码套件值</span>
<p> <span>类型：字符串</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../../constant-values.html#javax.xml.ws.spi.http.HttpExchange.REQUEST_CIPHER_SUITE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="REQUEST_KEY_SIZE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>REQUEST_KEY_SIZE</h4> <pre>public static final <a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> REQUEST_KEY_SIZE</pre>
<div class="block">
<span>标准属性：通过HTTPS接收请求时算法的位大小</span>
<p> <span>类型：整数</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../../constant-values.html#javax.xml.ws.spi.http.HttpExchange.REQUEST_KEY_SIZE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="REQUEST_X509CERTIFICATE">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>REQUEST_X509CERTIFICATE</h4> <pre>public static final <a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> REQUEST_X509CERTIFICATE</pre>
<div class="block">
<span>标准属性：与请求相关联的SSL证书（如果有）</span>
<p> <span>类型：java.security.cert.X509Certificate []将此数组的顺序定义为以信任的升序排列。</span> <span>链中的第一个证书是由客户端设置的一个证书，接下来是用于验证第一个证书的证书，依此类推。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../../constant-values.html#javax.xml.ws.spi.http.HttpExchange.REQUEST_X509CERTIFICATE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="HttpExchange--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>HttpExchange</h4> <pre>public HttpExchange()</pre> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getRequestHeaders--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRequestHeaders</h4> <pre>public abstract <a href="../../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a>,<a href="../../../../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a>&gt;&gt; getRequestHeaders()</pre>
<div class="block">
<span>返回包含此请求中包含的HTTP标头的不可变地图。</span>
<span>该地图中的键将是标题名称，而这些值将是包含每个包含的值的字符串列表（对于多次列出的标题，或者是接受逗号分隔的值列表）单线）。</span>
<span>在这两种情况下，标题名称的值将按照请求中包含的顺序进行显示。</span>
<p> <span>地图中的键不区分大小写。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个不可变的地图，可以用来访问请求头 
           </dd>
</dl> </li>
</ul> <a name="getRequestHeader-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRequestHeader</h4> <pre>public abstract <a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> getRequestHeader(<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> name)</pre>
<div class="block">
<span>返回指定请求头的值。</span>
<span>如果请求没有包含指定名称的头，则此方法返回null。</span>
<span>如果有多个名称相同的头，则此方法返回请求中的第一个头。</span>
<span>标题名称不区分大小写。</span>
<span>这是一个获取标题的方法（而不是使用<a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#getRequestHeaders--"><code>getRequestHeaders()</code></a> ）。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 请求标头的名称 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             返回请求的标头的值，如果请求没有该名称的标题，则返回null 
           </dd>
</dl> </li>
</ul> <a name="getResponseHeaders--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getResponseHeaders</h4> <pre>public abstract <a href="../../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a>,<a href="../../../../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a>&gt;&gt; getResponseHeaders()</pre>
<div class="block">
<span>返回一个可变地图，可以存储HTTP响应标头，哪个将作为此响应的一部分进行传输。</span>
<span>地图中的键将是标题名称，而这些值必须是包含应包含多次（按照它们应包含的顺序）的每个值的字符串列表。</span>
<p> <span>地图中的键不区分大小写。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个可以用来设置响应头的可变地图。 
           </dd>
</dl> </li>
</ul> <a name="addResponseHeader-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addResponseHeader</h4> <pre>public abstract void addResponseHeader(<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> name,
                                       <a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> value)</pre>
<div class="block">
<span>添加具有给定名称和值的响应头。</span>
<span>该方法允许响应头具有多个值。</span>
<span>这是添加响应头的方便方法（而不是使用<a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#getResponseHeaders--"><code>getResponseHeaders()</code></a> ）。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 标题的名称 
           </dd>
<dd>
<span><code>value</code> - 附加标头值。</span>
<span>如果它包含八位位组字符串，则应根据RFC 2047（http://www.ietf.org/rfc/rfc2047.txt）进行编码，</span>
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#getResponseHeaders--"><code>getResponseHeaders()</code></a>
</dd>
</dl> </li>
</ul> <a name="getRequestURI--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRequestURI</h4> <pre>public abstract <a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> getRequestURI()</pre>
<div class="block">
<span>将请求的URI的一部分从协议名称返回到HTTP请求的第一行中的查询字符串。</span>
<span>容器不解码此字符串。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             请求URI 
           </dd>
</dl> </li>
</ul> <a name="getContextPath--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getContextPath</h4> <pre>public abstract <a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> getContextPath()</pre>
<div class="block">
<span>返回应用程序中所有端点的上下文路径。</span>
<span>该路径是请求URI的一部分，指示请求的上下文。</span>
<span>上下文路径始终位于请求URI中。</span>
<span>路径以“/”字符开头，但不以“/”字符结尾。</span>
<span>如果此方法返回“”，则该请求用于默认上下文。</span>
<span>容器不解码此字符串。</span>
<p> <span>上下文路径用于计算端点地址。</span> <span>见<a href="../../../../../javax/xml/ws/spi/http/HttpContext.html#getPath--"><code>HttpContext.getPath()</code></a></span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             应用程序中所有端点的上下文路径 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../../javax/xml/ws/spi/http/HttpContext.html#getPath--"><code>HttpContext.getPath()</code></a>
</dd>
</dl> </li>
</ul> <a name="getRequestMethod--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRequestMethod</h4> <pre>public abstract <a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> getRequestMethod()</pre>
<div class="block">
            获取HTTP请求方法 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             请求方式 
           </dd>
</dl> </li>
</ul> <a name="getHttpContext--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getHttpContext</h4> <pre>public abstract <a href="../../../../../javax/xml/ws/spi/http/HttpContext.html" title="class in javax.xml.ws.spi.http">HttpContext</a> getHttpContext()</pre>
<div class="block">
<span>返回此交换的<a href="../../../../../javax/xml/ws/spi/http/HttpContext.html" title="javax.xml.ws.spi.http中的类"><code>HttpContext</code></a> 。</span>
<span>容器将请求与关联的Endpoint的HttpContext进行匹配</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             这个交换的HttpContext 
           </dd>
</dl> </li>
</ul> <a name="close--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>close</h4> <pre>public abstract void close()
                    throws <a href="../../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>必须调用这个结束交换。</span>
<span>容器处理关闭请求和响应流。</span>
<span>这必须被调用，以便容器可以释放或重用基础资源。</span>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果有任何I / O错误 
           </dd>
</dl> </li>
</ul> <a name="getRequestBody--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRequestBody</h4> <pre>public abstract <a href="../../../../../java/io/InputStream.html" title="class in java.io">InputStream</a> getRequestBody()
                                    throws <a href="../../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回可以从中读取请求主体的流。</span>
<span>对此方法的多次调用将返回相同的流。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             可以从中读取请求主体的流。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 请求处理中是否有任何I / O错误 
           </dd>
</dl> </li>
</ul> <a name="getResponseBody--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getResponseBody</h4> <pre>public abstract <a href="../../../../../java/io/OutputStream.html" title="class in java.io">OutputStream</a> getResponseBody()
                                      throws <a href="../../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回响应主体必须写入的流。</span>
<span><a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#setStatus-int-"><code>setStatus(int)</code></a> ）必须在调用此方法之前调用。</span>
<span>对此方法的多次调用（对于相同的交换）将返回相同的流。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             响应主体被写入的流 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 响应处理期间是否有任何I / O错误 
           </dd>
</dl> </li>
</ul> <a name="setStatus-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setStatus</h4> <pre>public abstract void setStatus(int status)</pre>
<div class="block">
<span>设置响应的HTTP状态代码。</span>
<p> <span>在调用<a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#getResponseBody--"><code>getResponseBody()</code></a>之前必须调用此方法。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>status</code> - 要发送的响应代码 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#getResponseBody--"><code>getResponseBody()</code></a>
</dd>
</dl> </li>
</ul> <a name="getRemoteAddress--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRemoteAddress</h4> <pre>public abstract <a href="../../../../../java/net/InetSocketAddress.html" title="class in java.net">InetSocketAddress</a> getRemoteAddress()</pre>
<div class="block">
            返回调用此请求的远程实体的未解析地址。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             调用者的InetSocketAddress 
           </dd>
</dl> </li>
</ul> <a name="getLocalAddress--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLocalAddress</h4> <pre>public abstract <a href="../../../../../java/net/InetSocketAddress.html" title="class in java.net">InetSocketAddress</a> getLocalAddress()</pre>
<div class="block">
            返回收到请求的未解决的本地地址。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             本地接口的InetSocketAddress 
           </dd>
</dl> </li>
</ul> <a name="getProtocol--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getProtocol</h4> <pre>public abstract <a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> getProtocol()</pre>
<div class="block">
<span>从请求中以<i>协议/ majorVersion.minorVersion</i>的形式返回协议串。</span>
<span>例如，“HTTP / 1.1”</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             来自请求的协议串 
           </dd>
</dl> </li>
</ul> <a name="getScheme--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getScheme</h4> <pre>public abstract <a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> getScheme()</pre>
<div class="block">
            返回用于创建此请求的方案的名称，例如：http或https。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             用于提出此请求的方案的名称 
           </dd>
</dl> </li>
</ul> <a name="getPathInfo--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPathInfo</h4> <pre>public abstract <a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> getPathInfo()</pre>
<div class="block">
<span>返回Web服务路径后面的额外路径信息，但在请求URI中的查询字符串之前，将以“/”字符开头。</span>
<p> <span>这可以用于<a href="../../../../../javax/xml/ws/handler/MessageContext.html#PATH_INFO"><code>MessageContext.PATH_INFO</code></a></span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>解码Web服务的额外路径信息。</span>
<span>在请求URI <tt>null中，</tt>如果在请求URI中没有额外的路径，则是在Web服务路径之后但在查询字符串之前的路径</span>
</dd>
</dl> </li>
</ul> <a name="getQueryString--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getQueryString</h4> <pre>public abstract <a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> getQueryString()</pre>
<div class="block">
<span>返回路径后请求URI中包含的查询字符串。</span>
<p> <span>这可以用于<a href="../../../../../javax/xml/ws/handler/MessageContext.html#QUERY_STRING"><code>MessageContext.QUERY_STRING</code></a></span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             未解码的请求URI的查询字符串，如果请求URI没有请求URI， 
            <tt>则为null</tt>
</dd>
</dl> </li>
</ul> <a name="getAttribute-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttribute</h4> <pre>public abstract <a href="../../../../../java/lang/Object.html" title="class in java.lang">Object</a> getAttribute(<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> name)</pre>
<div class="block">
<span>返回与此<code>HttpExchange</code> 。</span>
<span>然后，JAX-WS处理程序和端点可以通过<a href="../../../../../javax/xml/ws/handler/MessageContext.html" title="javax.xml.ws.handler中的接口"><code>MessageContext</code></a>访问<a href="../../../../../javax/xml/ws/handler/MessageContext.html" title="javax.xml.ws.handler中的接口">属性</a> 。</span>
<p> <span>Servlet容器必须公开<a href="../../../../../javax/xml/ws/handler/MessageContext.html#SERVLET_CONTEXT"><code>MessageContext.SERVLET_CONTEXT</code></a> ， <a href="../../../../../javax/xml/ws/handler/MessageContext.html#SERVLET_REQUEST"><code>MessageContext.SERVLET_REQUEST</code></a>和<a href="../../../../../javax/xml/ws/handler/MessageContext.html#SERVLET_RESPONSE"><code>MessageContext.SERVLET_RESPONSE</code></a>为属性。</span> </p>
<p> <span>如果容器使用HTTPS接收到请求，则必须将以下信息作为属性公开。</span> <span>这些属性是<a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#REQUEST_CIPHER_SUITE"><code>REQUEST_CIPHER_SUITE</code></a>和<a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#REQUEST_KEY_SIZE"><code>REQUEST_KEY_SIZE</code></a> 。</span> <span>如果存在与请求相关联的SSL证书，则必须使用<a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#REQUEST_X509CERTIFICATE"><code>REQUEST_X509CERTIFICATE</code></a>进行公开</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 属性名称 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             属性值，或 
            <tt>null</tt>如果属性不存在 
           </dd>
</dl> </li>
</ul> <a name="getAttributeNames--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttributeNames</h4> <pre>public abstract <a href="../../../../../java/util/Set.html" title="interface in java.util">Set</a>&lt;<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a>&gt; getAttributeNames()</pre>
<div class="block">
            提供与此 
           <code>HttpExchange</code>所有属性名称。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             所有属性名称集 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../../javax/xml/ws/spi/http/HttpExchange.html#getAttribute-java.lang.String-"><code>getAttribute(String)</code></a>
</dd>
</dl> </li>
</ul> <a name="getUserPrincipal--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getUserPrincipal</h4> <pre>public abstract <a href="../../../../../java/security/Principal.html" title="interface in java.security">Principal</a> getUserPrincipal()</pre>
<div class="block">
<span>返回<a href="../../../../../java/security/Principal.html" title="java.security中的接口">代表</a>此HttpExchange的身份验证用户的<code>HttpExchange</code> 。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             认证用户的 
            <tt>主体，</tt>如果没有认证，则为null 
           </dd>
</dl> </li>
</ul> <a name="isUserInRole-java.lang.String-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>isUserInRole</h4> <pre>public abstract boolean isUserInRole(<a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> role)</pre>
<div class="block">
            指示经过身份验证的用户是否包含在指定的逻辑“角色”中。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>role</code> - 指定角色的名称 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<tt>true</tt>如果提出此请求的用户属于给定角色 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>