W3CEndpointReferenceBuilder (Java Platform SE 8 )

java.lang.Object
- javax.xml.ws.wsaddressing.W3CEndpointReferenceBuilder

```
public final class W3CEndpointReferenceBuilder
extends Object
```
这个类用于构建W3CEndpointReference实例。预期使用这个clsss的是为应用程序组件，例如工厂组件，创建一个W3CEndpointReference对于因同一Java EE应用程序发布的Web服务端点。也可以通过提供address属性来为基于Java SE的端点创建W3CEndpointReferences 。
当创建一个W3CEndpointReference对于不是由同一个Java EE应用程序发布的一个端点，该address必须被指定的属性。

当创建一个W3CEndpointReference对于因同一Java EE应用程序发布的一个端点，该address属性可能null但随后serviceName和endpointName必须指定相同的Java EE应用程序发布的端点。

当指定wsdlDocumentLocation时，它必须参考有效的WSDL文档，并且serviceName和endpointName （如果指定）必须与WSDL文档中的服务和端口匹配。

从以下版本开始：

JAX-WS 2.1

构造方法摘要

构造方法
Constructor and Description
`W3CEndpointReferenceBuilder()` 创建一个新的 `W3CEndpointReferenceBuilder`实例。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`W3CEndpointReferenceBuilder`	`address(String address)` 将 `address`设置为 `W3CEndpointReference`实例的 `wsa:Address` 。
`W3CEndpointReferenceBuilder`	`attribute(QName name, String value)` 将扩展属性添加到 `W3CEndpointReference`实例的 `wsa:EndpointReference`元素。
`W3CEndpointReference`	`build()` 从此 `W3CEndpointReferenceBuilder`实例中设置的累积属性构建一个 `W3CEndpointReference` 。
`W3CEndpointReferenceBuilder`	`element(Element element)` 在 `W3CEndpointReference`实例的 `wsa:EndpointReference`元素中添加一个 `wsa:EndpointReference`元素。
`W3CEndpointReferenceBuilder`	`endpointName(QName endpointName)` 在 `wsa:Metadata`元素 `endpointName`设为 `wsam:ServiceName/@EndpointName` 。
`W3CEndpointReferenceBuilder`	`interfaceName(QName interfaceName)` 将 `interfaceName`设置为 `wsam:InterfaceName`元素中的 `wsa:Metadata`元素。
`W3CEndpointReferenceBuilder`	`metadata(Element metadataElement)` 将 `metadataElement`添加到 `W3CEndpointReference`实例的 `wsa:Metadata`元素。
`W3CEndpointReferenceBuilder`	`referenceParameter(Element referenceParameter)` 将 `referenceParameter`添加到 `W3CEndpointReference`实例 `wsa:ReferenceParameters`元素。
`W3CEndpointReferenceBuilder`	`serviceName(QName serviceName)` 将 `serviceName`设置为 `wsam:ServiceName`元素中的 `wsa:Metadata`元素。
`W3CEndpointReferenceBuilder`	`wsdlDocumentLocation(String wsdlDocumentLocation)` 设置 `wsdlDocumentLocation` ，将作为被引用 `wsa:Metadata/@wsdli:wsdlLocation` 。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - W3CEndpointReferenceBuilder
```
public W3CEndpointReferenceBuilder()
```
    创建一个新的 W3CEndpointReferenceBuilder实例。
- 方法详细信息
  - address
```
public W3CEndpointReferenceBuilder address(String address)
```
    将address设置为W3CEndpointReference实例的wsa:Address 。
    当构建不是由同一Java EE应用程序发布或在Java SE上运行的Web服务端点的W3CEndpointReference时， address必须设置为非null值。
    
    参数
    
    address - 返回的 W3CEndpointReference要定位的端点的地址。
    
    结果
    
    一个 W3CEndpointReferenceBuilder实例与 address设置为 wsa:Address 。
  - interfaceName
```
public W3CEndpointReferenceBuilder interfaceName(QName interfaceName)
```
    将interfaceName设置为wsam:InterfaceName元素中的wsa:Metadata元素。详见2.1 Referencing WSDL Metadata from an EPR 。
    
    参数
    
    interfaceName - 返回的 W3CEndpointReference要定位的端点的端口类型名称。
    
    结果
    
    一个 W3CEndpointReferenceBuilder实例与 interfaceName作为 wsam:InterfaceName元素添加到 wsa:Metadata元素
  - serviceName
```
public W3CEndpointReferenceBuilder serviceName(QName serviceName)
```
    将serviceName设置为wsam:ServiceName元素中的wsa:Metadata元素。详见2.1 Referencing WSDL Metadata from an EPR 。
    
    参数
    
    serviceName - 返回的W3CEndpointReference要定位的端点的服务名称。这个属性也可以与使用endpointName （PORTNAME）属性来查找address由同一个Java EE应用程序发布的Web服务端点。
    
    结果
    
    一个 W3CEndpointReferenceBuilder实例与 serviceName作为 wsam:ServiceName元素添加到 wsa:Metadata元素
  - endpointName
```
public W3CEndpointReferenceBuilder endpointName(QName endpointName)
```
    将endpointName设置为wsam:ServiceName/@EndpointName在wsa:Metadata元素中。此方法只能在调用serviceName方法后调用。
    详见2.1 Referencing WSDL Metadata from an EPR 。
    
    参数
    
    endpointName - 返回的W3CEndpointReference要定位的端点的名称。该endpointName （PORTNAME）特性也可与用于serviceName属性来查找address由同一个Java EE应用程序发布的Web服务端点。
    
    结果
    
    一个 W3CEndpointReferenceBuilder实例与 endpointName为 wsam:ServiceName/@EndpointName在 wsa:Metadata元素。
    
    异常
    
    IllegalStateException, - 如果 serviceName尚未设置。
    
    IllegalArgumentException, - 如果 endpointName的命名空间URI不匹配 serviceName的命名空间URI
  - wsdlDocumentLocation
```
public W3CEndpointReferenceBuilder wsdlDocumentLocation(String wsdlDocumentLocation)
```
    设置wsdlDocumentLocation ，将作为被引用wsa:Metadata/@wsdli:wsdlLocation 。 wsdli：wsdlLocation的值的命名空间名称可以从WSDL本身获取。
    详见2.1 Referencing WSDL Metadata from an EPR 。
    
    参数
    
    wsdlDocumentLocation - 要引用的WSDL文档的位置 wsa:Metadata的 W3CEndpointReference 。
    
    结果
    
    一个 W3CEndpointReferenceBuilder与实例 wsdlDocumentLocation是被引用。
  - referenceParameter
```
public W3CEndpointReferenceBuilder referenceParameter(Element referenceParameter)
```
    将 referenceParameter添加到 W3CEndpointReference实例 wsa:ReferenceParameters元素。
    
    参数
    
    referenceParameter - 要添加到 wsa:ReferenceParameters元素的元素。
    
    结果
    
    一个 W3CEndpointReferenceBuilder实例与 referenceParameter添加到 wsa:ReferenceParameters元素。
    
    异常
    
    IllegalArgumentException - 如果 referenceParameter是 null 。
  - metadata
```
public W3CEndpointReferenceBuilder metadata(Element metadataElement)
```
    将 metadataElement添加到 W3CEndpointReference实例的 wsa:Metadata元素。
    
    参数
    
    metadataElement - 要添加到 wsa:Metadata元素的元素。
    
    结果
    
    一个 W3CEndpointReferenceBuilder实例与 metadataElement添加到 wsa:Metadata元素。
    
    异常
    
    IllegalArgumentException - 如果 metadataElement是 null 。
  - element
```
public W3CEndpointReferenceBuilder element(Element element)
```
    将一个扩展元素添加到 W3CEndpointReference实例的 wsa:EndpointReference元素。
    
    参数
    
    element - 要添加到 W3CEndpointReference的扩展元素
    
    结果
    
    一个 W3CEndpointReferenceBuilder实例与扩展名 element添加到 W3CEndpointReference实例。
    
    异常
    
    IllegalArgumentException - 如果 element是 null 。
    
    从以下版本开始：
    
    JAX-WS 2.2
  - attribute
```
public W3CEndpointReferenceBuilder attribute(QName name,
                                             String value)
```
    将扩展属性添加到 W3CEndpointReference实例的 wsa:EndpointReference元素。
    
    参数
    
    name - 要添加到 W3CEndpointReference
    
    value - 扩展属性值
    
    结果
    
    一个 W3CEndpointReferenceBuilder实例与扩展属性添加到 W3CEndpointReference实例。
    
    异常
    
    IllegalArgumentException - 如果 name或 value是 null 。
    
    从以下版本开始：
    
    JAX-WS 2.2
  - build
```
public W3CEndpointReference build()
```
    从这个W3CEndpointReferenceBuilder实例上设置的累积属性构建一个W3CEndpointReference 。
    这种方法可以被用来创建一个W3CEndpointReference通过指定任何端点address与任何其它所需的性质沿属性。这种方法也可以用来创建一个W3CEndpointReference对于由同一个Java EE应用程序发布的端点。这种方法可以自动判断address由被识别的同一Java EE应用程序发布的端点serviceName和endpointName性能。如果address为null和serviceName和endpointName不认同由同一个Java EE应用程序发布的一个端点，一个java.lang.IllegalStateException必须被抛出。
    结果
    
    W3CEndpointReference从这个W3CEndpointReferenceBuilder实例的累积属性设置。这种方法永远不会返回null 。
    
    异常
    IllegalStateException -
    
    如果address ， serviceName和endpointName都null 。
    
    如果serviceName服务是null和endpointName不是null 。
    
    如果address属性为null ，并且serviceName和endpointName未指定由同一Java EE应用程序发布的有效端点。
    
    如果serviceName不是null并且不在指定的WSDL中。
    
    如果endpointName端口不是null ，并且它不存在于WSDL中的serviceName服务中。
    
    如果wsdlDocumentLocation不是null并且不表示有效的WSDL。
    WebServiceException - 创建 W3CEndpointReference时发生错误。

Class W3CEndpointReferenceBuilder

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

W3CEndpointReferenceBuilder

方法详细信息

address

interfaceName

serviceName

endpointName

wsdlDocumentLocation

referenceParameter

metadata

element

attribute

build