study/uTools-Manuals
1
0
Fork 0
mirror of https://github.com/fofolee/uTools-Manuals.git synced 2025-07-04 07:42:45 +08:00
Code Issues Packages Projects Releases Wiki Activity
uTools-Manuals/docs/java/javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html

547 lines
28 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.wsaddressing
</div>
<h2 class="title" title="Class W3CEndpointReferenceBuilder">Class W3CEndpointReferenceBuilder</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.wsaddressing.W3CEndpointReferenceBuilder</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public final class <span class="typeNameLabel">W3CEndpointReferenceBuilder</span>
extends <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
<div class="block">
<span>这个类用于构建<code>W3CEndpointReference</code>实例。</span>
<span>预期使用这个clsss的是为应用程序组件，例如工厂组件，创建一个<code>W3CEndpointReference</code>对于因同一Java EE应用程序发布的Web服务端点。</span>
<span>也可以通过提供<code>address</code>属性来为基于Java SE的端点创建<code>W3CEndpointReferences</code> 。</span>
<p> <span>当创建一个<code>W3CEndpointReference</code>对于不是由同一个Java EE应用程序发布的一个端点，该<code>address</code>必须被指定的属性。</span> </p>
<p> <span>当创建一个<code>W3CEndpointReference</code>对于因同一Java EE应用程序发布的一个端点，该<code>address</code>属性可能<code>null</code>但随后<code>serviceName</code>和<code>endpointName</code>必须指定相同的Java EE应用程序发布的端点。</span> </p>
<p> <span>当指定<code>wsdlDocumentLocation</code>时，它必须参考有效的WSDL文档，并且<code>serviceName</code>和<code>endpointName</code> （如果指定）必须与WSDL文档中的服务和端口匹配。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
JAX-WS 2.1
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== 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/wsaddressing/W3CEndpointReferenceBuilder.html#W3CEndpointReferenceBuilder--">W3CEndpointReferenceBuilder</a></span>()</code>
<div class="block">
创建一个新的
<code>W3CEndpointReferenceBuilder</code>实例。
</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="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><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html#address-java.lang.String-">address</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> address)</code>
<div class="block">
将
<code>address</code>设置为
<code>W3CEndpointReference</code>实例的
<code>wsa:Address</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html#attribute-javax.xml.namespace.QName-java.lang.String-">attribute</a></span>(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> name, <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> value)</code>
<div class="block">
将扩展属性添加到
<code>W3CEndpointReference</code>实例的
<code>wsa:EndpointReference</code>元素。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReference.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReference</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html#build--">build</a></span>()</code>
<div class="block">
从此
<code>W3CEndpointReferenceBuilder</code>实例中设置的累积属性构建一个
<code>W3CEndpointReference</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html#element-org.w3c.dom.Element-">element</a></span>(<a href="../../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a> element)</code>
<div class="block">
在
<code>W3CEndpointReference</code>实例的
<code>wsa:EndpointReference</code>元素中添加一个
<code>wsa:EndpointReference</code>元素。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html#endpointName-javax.xml.namespace.QName-">endpointName</a></span>(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> endpointName)</code>
<div class="block">
在
<code>wsa:Metadata</code>元素
<code>endpointName</code>设为
<code>wsam:ServiceName/@EndpointName</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html#interfaceName-javax.xml.namespace.QName-">interfaceName</a></span>(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> interfaceName)</code>
<div class="block">
将
<code>interfaceName</code>设置为
<code>wsam:InterfaceName</code>元素中的
<code>wsa:Metadata</code>元素。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html#metadata-org.w3c.dom.Element-">metadata</a></span>(<a href="../../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a> metadataElement)</code>
<div class="block">
将
<code>metadataElement</code>添加到
<code>W3CEndpointReference</code>实例的
<code>wsa:Metadata</code>元素。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html#referenceParameter-org.w3c.dom.Element-">referenceParameter</a></span>(<a href="../../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a> referenceParameter)</code>
<div class="block">
将
<code>referenceParameter</code>添加到
<code>W3CEndpointReference</code>实例
<code>wsa:ReferenceParameters</code>元素。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html#serviceName-javax.xml.namespace.QName-">serviceName</a></span>(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> serviceName)</code>
<div class="block">
将
<code>serviceName</code>设置为
<code>wsam:ServiceName</code>元素中的
<code>wsa:Metadata</code>元素。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html#wsdlDocumentLocation-java.lang.String-">wsdlDocumentLocation</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> wsdlDocumentLocation)</code>
<div class="block">
设置
<code>wsdlDocumentLocation</code> ，将作为被引用
<code>wsa:Metadata/@wsdli:wsdlLocation</code> 。
</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">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="W3CEndpointReferenceBuilder--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>W3CEndpointReferenceBuilder</h4> <pre>public W3CEndpointReferenceBuilder()</pre>
<div class="block">
创建一个新的
<code>W3CEndpointReferenceBuilder</code>实例。
</div> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="address-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>address</h4> <pre>public <a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a> address(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> address)</pre>
<div class="block">
<span>将<code>address</code>设置为<code>W3CEndpointReference</code>实例的<code>wsa:Address</code> 。</span>
<p> <span>当构建不是由同一Java EE应用程序发布或在Java SE上运行的Web服务端点的<code>W3CEndpointReference</code>时， <code>address</code>必须设置为非<code>null</code>值。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>address</code> - 返回的
<code>W3CEndpointReference</code>要定位的端点的地址。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>W3CEndpointReferenceBuilder</code>实例与
<code>address</code>设置为
<code>wsa:Address</code> 。
</dd>
</dl> </li>
</ul> <a name="interfaceName-javax.xml.namespace.QName-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>interfaceName</h4> <pre>public <a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a> interfaceName(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> interfaceName)</pre>
<div class="block">
<span>将<code>interfaceName</code>设置为<code>wsam:InterfaceName</code>元素中的<code>wsa:Metadata</code>元素。</span>
<span>详见<a href="http://www.w3.org/TR/2007/REC-ws-addr-metadata-20070904/#refmetadatfromepr">2.1 Referencing WSDL Metadata from an EPR</a> 。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>interfaceName</code> - 返回的
<code>W3CEndpointReference</code>要定位的端点的端口类型名称。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>W3CEndpointReferenceBuilder</code>实例与
<code>interfaceName</code>作为
<code>wsam:InterfaceName</code>元素添加到
<code>wsa:Metadata</code>元素
</dd>
</dl> </li>
</ul> <a name="serviceName-javax.xml.namespace.QName-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>serviceName</h4> <pre>public <a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a> serviceName(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> serviceName)</pre>
<div class="block">
<span>将<code>serviceName</code>设置为<code>wsam:ServiceName</code>元素中的<code>wsa:Metadata</code>元素。</span>
<span>详见<a href="http://www.w3.org/TR/2007/REC-ws-addr-metadata-20070904/#refmetadatfromepr">2.1 Referencing WSDL Metadata from an EPR</a> 。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>serviceName</code> - 返回的<code>W3CEndpointReference</code>要定位的端点的服务名称。</span>
<span>这个属性也可以与使用<code>endpointName</code> （PORTNAME）属性来查找<code>address</code>由同一个Java EE应用程序发布的Web服务端点。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>W3CEndpointReferenceBuilder</code>实例与
<code>serviceName</code>作为
<code>wsam:ServiceName</code>元素添加到
<code>wsa:Metadata</code>元素
</dd>
</dl> </li>
</ul> <a name="endpointName-javax.xml.namespace.QName-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>endpointName</h4> <pre>public <a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a> endpointName(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> endpointName)</pre>
<div class="block">
<span>将<code>endpointName</code>设置为<code>wsam:ServiceName/@EndpointName</code>在<code>wsa:Metadata</code>元素中。</span>
<span>此方法只能在调用<a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html#serviceName"><code>serviceName</code></a>方法后调用。</span>
<p> <span>详见<a href="http://www.w3.org/TR/2007/REC-ws-addr-metadata-20070904/#refmetadatfromepr">2.1 Referencing WSDL Metadata from an EPR</a> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>endpointName</code> - 返回的<code>W3CEndpointReference</code>要定位的端点的名称。</span>
<span>该<code>endpointName</code> （PORTNAME）特性也可与用于<code>serviceName</code>属性来查找<code>address</code>由同一个Java EE应用程序发布的Web服务端点。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>W3CEndpointReferenceBuilder</code>实例与
<code>endpointName</code>为
<code>wsam:ServiceName/@EndpointName</code>在
<code>wsa:Metadata</code>元素。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>IllegalStateException,</code> - 如果
<code>serviceName</code>尚未设置。
</dd>
<dd>
<code>IllegalArgumentException,</code> - 如果
<code>endpointName</code>的命名空间URI不匹配
<code>serviceName</code>的命名空间URI
</dd>
</dl> </li>
</ul> <a name="wsdlDocumentLocation-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>wsdlDocumentLocation</h4> <pre>public <a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a> wsdlDocumentLocation(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> wsdlDocumentLocation)</pre>
<div class="block">
<span>设置<code>wsdlDocumentLocation</code> ，将作为被引用<code>wsa:Metadata/@wsdli:wsdlLocation</code> 。</span>
<span>wsdli：wsdlLocation的值的命名空间名称可以从WSDL本身获取。</span>
<p> <span>详见<a href="http://www.w3.org/TR/2007/REC-ws-addr-metadata-20070904/#refmetadatfromepr">2.1 Referencing WSDL Metadata from an EPR</a> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>wsdlDocumentLocation</code> - 要引用的WSDL文档的位置
<code>wsa:Metadata</code>的
<code>W3CEndpointReference</code> 。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>W3CEndpointReferenceBuilder</code>与实例
<code>wsdlDocumentLocation</code>是被引用。
</dd>
</dl> </li>
</ul> <a name="referenceParameter-org.w3c.dom.Element-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>referenceParameter</h4> <pre>public <a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a> referenceParameter(<a href="../../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a> referenceParameter)</pre>
<div class="block">
将
<code>referenceParameter</code>添加到
<code>W3CEndpointReference</code>实例
<code>wsa:ReferenceParameters</code>元素。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>referenceParameter</code> - 要添加到
<code>wsa:ReferenceParameters</code>元素的元素。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>W3CEndpointReferenceBuilder</code>实例与
<code>referenceParameter</code>添加到
<code>wsa:ReferenceParameters</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>referenceParameter</code>是
<code>null</code> 。
</dd>
</dl> </li>
</ul> <a name="metadata-org.w3c.dom.Element-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>metadata</h4> <pre>public <a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a> metadata(<a href="../../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a> metadataElement)</pre>
<div class="block">
将
<code>metadataElement</code>添加到
<code>W3CEndpointReference</code>实例的
<code>wsa:Metadata</code>元素。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>metadataElement</code> - 要添加到
<code>wsa:Metadata</code>元素的元素。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>W3CEndpointReferenceBuilder</code>实例与
<code>metadataElement</code>添加到
<code>wsa:Metadata</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>metadataElement</code>是
<code>null</code> 。
</dd>
</dl> </li>
</ul> <a name="element-org.w3c.dom.Element-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>element</h4> <pre>public <a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a> element(<a href="../../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a> element)</pre>
<div class="block">
将一个扩展元素添加到
<code>W3CEndpointReference</code>实例的
<code>wsa:EndpointReference</code>元素。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>element</code> - 要添加到
<code>W3CEndpointReference</code>的扩展元素
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>W3CEndpointReferenceBuilder</code>实例与扩展名
<code>element</code>添加到
<code>W3CEndpointReference</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>element</code>是
<code>null</code> 。
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
JAX-WS 2.2
</dd>
</dl> </li>
</ul> <a name="attribute-javax.xml.namespace.QName-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>attribute</h4> <pre>public <a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReferenceBuilder</a> attribute(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> name,
<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> value)</pre>
<div class="block">
将扩展属性添加到
<code>W3CEndpointReference</code>实例的
<code>wsa:EndpointReference</code>元素。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要添加到
<code>W3CEndpointReference</code>
</dd>
<dd>
<code>value</code> - 扩展属性值
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>W3CEndpointReferenceBuilder</code>实例与扩展属性添加到
<code>W3CEndpointReference</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>name</code>或
<code>value</code>是
<code>null</code> 。
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
JAX-WS 2.2
</dd>
</dl> </li>
</ul> <a name="build--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>build</h4> <pre>public <a href="../../../../javax/xml/ws/wsaddressing/W3CEndpointReference.html" title="class in javax.xml.ws.wsaddressing">W3CEndpointReference</a> build()</pre>
<div class="block">
<span>从这个<code>W3CEndpointReferenceBuilder</code>实例上设置的累积属性构建一个<code>W3CEndpointReference</code> 。</span>
<p> <span>这种方法可以被用来创建一个<code>W3CEndpointReference</code>通过指定任何端点<code>address</code>与任何其它所需的性质沿属性。</span> <span>这种方法也可以用来创建一个<code>W3CEndpointReference</code>对于由同一个Java EE应用程序发布的端点。</span> <span>这种方法可以自动判断<code>address</code>由被识别的同一Java EE应用程序发布的端点<code>serviceName</code>和<code>endpointName</code>性能。</span> <span>如果<code>address</code>为<code>null</code>和<code>serviceName</code>和<code>endpointName</code>不认同由同一个Java EE应用程序发布的一个端点，一个<code>java.lang.IllegalStateException</code>必须被抛出。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span><code>W3CEndpointReference</code>从这个<code>W3CEndpointReferenceBuilder</code>实例的累积属性设置。</span>
<span>这种方法永远不会返回<code>null</code> 。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> -</span>
<ul>
<li> <span>如果<code>address</code> ， <code>serviceName</code>和<code>endpointName</code>都<code>null</code> 。</span> </li>
<li> <span>如果<code>serviceName</code>服务是<code>null</code>和<code>endpointName</code>不是<code>null</code> 。</span> </li>
<li> <span>如果<code>address</code>属性为<code>null</code> ，并且<code>serviceName</code>和<code>endpointName</code>未指定由同一Java EE应用程序发布的有效端点。</span> </li>
<li> <span>如果<code>serviceName</code>不是<code>null</code>并且不在指定的WSDL中。</span> </li>
<li> <span>如果<code>endpointName</code>端口不是<code>null</code> ，并且它不存在于WSDL中的<code>serviceName</code>服务中。</span> </li>
<li> <span>如果<code>wsdlDocumentLocation</code>不是<code>null</code>并且不表示有效的WSDL。</span> </li>
</ul>
</dd>
<dd>
<code><a href="../../../../javax/xml/ws/WebServiceException.html" title="class in javax.xml.ws">WebServiceException</a></code> - 创建
<code>W3CEndpointReference</code>时发生错误。
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>
Reference in New Issue View Git Blame Copy Permalink