uTools-Manuals/docs/java/javax/xml/ws/BindingProvider.html

405 lines
18 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">
javax.xml.ws
</div>
<h2 class="title" title="Interface BindingProvider">Interface BindingProvider</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Known Subinterfaces:
</dt>
<dd>
<span><a href="../../../javax/xml/ws/Dispatch.html" title="javax.xml.ws中的接口">Dispatch</a> &lt;T&gt;</span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">BindingProvider</span></pre>
<div class="block">
<code>BindingProvider</code>接口提供对协议绑定和相关联的上下文对象的访问以用于请求和响应消息处理。
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
JAX-WS 2.0
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../javax/xml/ws/Binding.html" title="javax.xml.ws中的接口"><code>Binding</code></a></span>
</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/BindingProvider.html#ENDPOINT_ADDRESS_PROPERTY">ENDPOINT_ADDRESS_PROPERTY</a></span></code>
<div class="block">
标准属性:目标服务端点地址。
</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/BindingProvider.html#PASSWORD_PROPERTY">PASSWORD_PROPERTY</a></span></code>
<div class="block">
标准属性:验证密码。
</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/BindingProvider.html#SESSION_MAINTAIN_PROPERTY">SESSION_MAINTAIN_PROPERTY</a></span></code>
<div class="block">
标准属性:此布尔属性由服务客户端用于指示是否要参与与服务端点的会话。
</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/BindingProvider.html#SOAPACTION_URI_PROPERTY">SOAPACTION_URI_PROPERTY</a></span></code>
<div class="block">
SOAPAction的标准属性。
</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/BindingProvider.html#SOAPACTION_USE_PROPERTY">SOAPACTION_USE_PROPERTY</a></span></code>
<div class="block">
SOAPAction的标准属性。
</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/BindingProvider.html#USERNAME_PROPERTY">USERNAME_PROPERTY</a></span></code>
<div class="block">
标准属性:认证用户名。
</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="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><a href="../../../javax/xml/ws/Binding.html" title="interface in javax.xml.ws">Binding</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/BindingProvider.html#getBinding--">getBinding</a></span>()</code>
<div class="block">
获取此绑定提供程序的绑定。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../javax/xml/ws/EndpointReference.html" title="class in javax.xml.ws">EndpointReference</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/BindingProvider.html#getEndpointReference--">getEndpointReference</a></span>()</code>
<div class="block">
返回
<code>EndpointReference</code>与此相关
<code>BindingProvider</code>实例。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>&lt;T extends <a href="../../../javax/xml/ws/EndpointReference.html" title="class in javax.xml.ws">EndpointReference</a>&gt;<br/>T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/BindingProvider.html#getEndpointReference-java.lang.Class-">getEndpointReference</a></span>(<a href="../../../java/lang/Class.html" title="class in java.lang"></a>&lt;T&gt; clazz)</code>
<div class="block">
返回
<code>EndpointReference</code>与此相关
<code>BindingProvider</code>实例。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><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/lang/Object.html" title="class in java.lang">Object</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/BindingProvider.html#getRequestContext--">getRequestContext</a></span>()</code>
<div class="block">
获取用于初始化请求消息的消息上下文的上下文。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><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/lang/Object.html" title="class in java.lang">Object</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/BindingProvider.html#getResponseContext--">getResponseContext</a></span>()</code>
<div class="block">
获取处理响应消息产生的上下文。
</div> </td>
</tr>
</tbody>
</table> </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="USERNAME_PROPERTY">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>USERNAME_PROPERTY</h4> <pre>static final <a href="../../../java/lang/String.html" title="class in java.lang">String</a> USERNAME_PROPERTY</pre>
<div class="block">
<span>标准属性:认证用户名。</span>
<p> <span>类型: <code>java.lang.String</code></span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.xml.ws.BindingProvider.USERNAME_PROPERTY">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="PASSWORD_PROPERTY">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>PASSWORD_PROPERTY</h4> <pre>static final <a href="../../../java/lang/String.html" title="class in java.lang">String</a> PASSWORD_PROPERTY</pre>
<div class="block">
<span>标准属性:验证密码。</span>
<p> <span>类型: <code>java.lang.String</code></span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.xml.ws.BindingProvider.PASSWORD_PROPERTY">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="ENDPOINT_ADDRESS_PROPERTY">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ENDPOINT_ADDRESS_PROPERTY</h4> <pre>static final <a href="../../../java/lang/String.html" title="class in java.lang">String</a> ENDPOINT_ADDRESS_PROPERTY</pre>
<div class="block">
<span>标准属性:目标服务端点地址。</span>
<span>端点地址规范的URI方案必须对应于正在使用的绑定的协议/传输绑定。</span>
<p> <span>类型: <code>java.lang.String</code></span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.xml.ws.BindingProvider.ENDPOINT_ADDRESS_PROPERTY">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="SESSION_MAINTAIN_PROPERTY">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>SESSION_MAINTAIN_PROPERTY</h4> <pre>static final <a href="../../../java/lang/String.html" title="class in java.lang">String</a> SESSION_MAINTAIN_PROPERTY</pre>
<div class="block">
<span>标准属性:此布尔属性由服务客户端用于指示是否要参与与服务端点的会话。</span>
<span>如果此属性设置为<code>true</code> ,则服务客户端指示它要维护会话。</span>
<span>如果设置为<code>false</code> ,则会话不被维护。</span>
<span>此属性的默认值为<code>false</code></span>
<p> <span>类型: <code>java.lang.Boolean</code></span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.xml.ws.BindingProvider.SESSION_MAINTAIN_PROPERTY">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="SOAPACTION_USE_PROPERTY">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>SOAPACTION_USE_PROPERTY</h4> <pre>static final <a href="../../../java/lang/String.html" title="class in java.lang">String</a> SOAPACTION_USE_PROPERTY</pre>
<div class="block">
<span>SOAPAction的标准属性。</span>
<span>此布尔属性指示<code>javax.xml.ws.soap.http.soapaction.uri</code>属性的值是否用于<code>javax.xml.ws.soap.http.soapaction.uri</code>的值。</span>
<span>此属性的默认值是<code>false</code>表明<code>javax.xml.ws.soap.http.soapaction.uri</code>属性不用于SOAPAction的价值但是如果WS-Addressing的启用默认值是<code>true</code></span>
<p> <span>类型: <code>java.lang.Boolean</code></span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.xml.ws.BindingProvider.SOAPACTION_USE_PROPERTY">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="SOAPACTION_URI_PROPERTY">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>SOAPACTION_URI_PROPERTY</h4> <pre>static final <a href="../../../java/lang/String.html" title="class in java.lang">String</a> SOAPACTION_URI_PROPERTY</pre>
<div class="block">
<span>SOAPAction的标准属性。</span>
<span>如果<code>javax.xml.ws.soap.http.soapaction.use</code>属性设置为<code>true</code>则指示SOAPAction URI。</span>
<span>如果启用了WS-Addressing则该值也将用于WS-Addressing Action头的值。</span>
<span>如果未设置此属性将发送默认的SOAPAction和WS-Addressing操作。</span>
<p> <span>类型: <code>java.lang.String</code></span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.xml.ws.BindingProvider.SOAPACTION_URI_PROPERTY">Constant Field Values</a>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getRequestContext--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRequestContext</h4> <pre><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/lang/Object.html" title="class in java.lang">Object</a>&gt; getRequestContext()</pre>
<div class="block">
<span>获取用于初始化请求消息的消息上下文的上下文。</span>
<span>对请求上下文的修改不会影响已经启动的同步或异步操作的消息上下文。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
用于处理请求消息的上下文。
</dd>
</dl> </li>
</ul> <a name="getResponseContext--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getResponseContext</h4> <pre><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/lang/Object.html" title="class in java.lang">Object</a>&gt; getResponseContext()</pre>
<div class="block">
<span>获取处理响应消息产生的上下文。</span>
<span>返回的上下文是最近完成的同步操作。</span>
<span>随后的同步操作调用将覆盖响应上下文。</span>
<span>异步操作通过响应界面返回其响应上下文。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
处理最新回应讯息产生的上下文。
</dd>
</dl> </li>
</ul> <a name="getBinding--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getBinding</h4> <pre><a href="../../../javax/xml/ws/Binding.html" title="interface in javax.xml.ws">Binding</a> getBinding()</pre>
<div class="block">
获取此绑定提供程序的绑定。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
此绑定提供程序的绑定。
</dd>
</dl> </li>
</ul> <a name="getEndpointReference--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getEndpointReference</h4> <pre><a href="../../../javax/xml/ws/EndpointReference.html" title="class in javax.xml.ws">EndpointReference</a> getEndpointReference()</pre>
<div class="block">
<span>返回与此<code>BindingProvider</code>实例<code>EndpointReference</code>联的<code>BindingProvider</code></span>
<p> <span>如果此<code>bindingProvider</code>的绑定是SOAP1.1 / HTTP或SOAP1.2 / HTTP则必须返回一个<code>W3CEndpointReference</code></span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
与此
<code>BindingProvider</code>实例相关联的目标端点的EndpointReference。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果这
<code>BindingProvider</code>使用XML / HTTP绑定。
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
JAX-WS 2.1
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../javax/xml/ws/wsaddressing/W3CEndpointReference.html" title="javax.xml.ws.wsaddressing中的类"><code>W3CEndpointReference</code></a></span>
</dd>
</dl> </li>
</ul> <a name="getEndpointReference-java.lang.Class-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getEndpointReference</h4> <pre>&lt;T extends <a href="../../../javax/xml/ws/EndpointReference.html" title="class in javax.xml.ws">EndpointReference</a>&gt; T getEndpointReference(<a href="../../../java/lang/Class.html" title="class in java.lang"></a>&lt;T&gt; clazz)</pre>
<div class="block">
<span>返回与此<code>BindingProvider</code>实例<code>EndpointReference</code>联的<code>BindingProvider</code></span>
<span>返回的实例将为<code>clazz</code></span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>clazz</code> - 指定必须返回的类型
<code>EndpointReference</code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>与此<code>BindingProvider</code>实例相关联的目标端点的EndpointReference。</span>
<span>必须是<code>clazz</code></span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/ws/WebServiceException.html" title="class in javax.xml.ws">WebServiceException</a></code> - 如果此
<code>clazz</code>不支持Class clazz。
</dd>
<dd>
<code><a href="../../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果这
<code>BindingProvider</code>使用XML / HTTP绑定。
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
JAX-WS 2.1
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>