W3CEndpointReferenceBuilder (Java Platform SE 8 )

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

```
public final class W3CEndpointReferenceBuilder
extends Object
```
这个类是用来建立 W3CEndpointReference实例。这一类的用途是应用程序组件，例如一个工厂组件，创建由相同的java EE应用发布的Web服务终结点 W3CEndpointReference。它也可以被用来提供 address属性创建一个java SE基于端点 W3CEndpointReferences。
创建一个端点，是不相同的W3CEndpointReference java EE应用发布时，必须指定的address财产。

创建一个由同一个java EE应用发布的端点W3CEndpointReference时的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)` 设置为 `W3CEndpointReference`实例的 `wsa:Address`的 `address`。
`W3CEndpointReferenceBuilder`	`attribute(QName name, String value)` 添加扩展属性的 `W3CEndpointReference`实例的 `wsa:EndpointReference`元。
`W3CEndpointReference`	`build()` 建立了从积累的属性设置该 `W3CEndpointReferenceBuilder`审 `W3CEndpointReference`。
`W3CEndpointReferenceBuilder`	`element(Element element)` 添加一个扩展元素的 `W3CEndpointReference`实例的 `wsa:EndpointReference`元。
`W3CEndpointReferenceBuilder`	`endpointName(QName endpointName)` 集 `endpointName`在 `wsa:Metadata`元 `wsam:ServiceName/@EndpointName`。
`W3CEndpointReferenceBuilder`	`interfaceName(QName interfaceName)` 集 `interfaceName`在 `wsa:Metadata`元 `wsam:InterfaceName`元。
`W3CEndpointReferenceBuilder`	`metadata(Element metadataElement)` 加 `metadataElement`的 `W3CEndpointReference`实例的 `wsa:Metadata`元。
`W3CEndpointReferenceBuilder`	`referenceParameter(Element referenceParameter)` 加 `referenceParameter`的 `W3CEndpointReference`实例 `wsa:ReferenceParameters`元。
`W3CEndpointReferenceBuilder`	`serviceName(QName serviceName)` 集 `serviceName`在 `wsa:Metadata`元 `wsam:ServiceName`元。
`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

- Constructor Detail
  - W3CEndpointReferenceBuilder
```
public W3CEndpointReferenceBuilder()
```
    创建一个新的 W3CEndpointReferenceBuilder实例。
- 方法详细信息
  - address
```
public W3CEndpointReferenceBuilder address(String address)
```
    设置为 W3CEndpointReference实例的 wsa:Address的 address。
    的address必须设置一个non-null价值时，建立一个W3CEndpointReference为Web服务端点，是不是由同一java EE应用或java运行时发表。
    
    参数
    
    address—被返回的 W3CEndpointReference目标端点的地址。
    
    结果
    
    一个设置为 wsa:Address的 address W3CEndpointReferenceBuilder实例。
  - interfaceName
```
public W3CEndpointReferenceBuilder interfaceName(QName interfaceName)
```
    集 interfaceName在 wsa:Metadata元 wsam:InterfaceName元。更多细节见 2.1 Referencing WSDL Metadata from an EPR。
    
    参数
    
    interfaceName -端点的端口类型名称被返回的 W3CEndpointReference目标。
    
    结果
    
    与 interfaceName作为 wsam:InterfaceName元素添加到 wsa:Metadata元 W3CEndpointReferenceBuilder实例
  - serviceName
```
public W3CEndpointReferenceBuilder serviceName(QName serviceName)
```
    集 serviceName在 wsa:Metadata元 wsam:ServiceName元。更多细节见 2.1 Referencing WSDL Metadata from an EPR。
    
    参数
    
    serviceName -终端服务名称被返回的 W3CEndpointReference目标。这个属性也可以用 endpointName（PortName）属性来查找Web服务端点，由同一个java EE应用发表 address。
    
    结果
    
    与 serviceName作为 wsam:ServiceName元素添加到 wsa:Metadata元 W3CEndpointReferenceBuilder实例
  - endpointName
```
public W3CEndpointReferenceBuilder endpointName(QName endpointName)
```
    集 endpointName在 wsa:Metadata元 wsam:ServiceName/@EndpointName。这种方法只能在 serviceName方法被称为。
    更多细节见 2.1 Referencing WSDL Metadata from an EPR。
    
    参数
    
    endpointName -端点的名称被返回的 W3CEndpointReference目标。的 endpointName（PortName）属性也可用于查找由相同的java EE应用发布的Web服务终结点的 address的 serviceName财产。
    
    结果
    
    与 endpointName在 wsa:Metadata元 wsam:ServiceName/@EndpointName W3CEndpointReferenceBuilder实例。
    
    异常
    
    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文档是在 W3CEndpointReference的 wsa:Metadata参考位置。
    
    结果
    
    与 wsdlDocumentLocation是 W3CEndpointReferenceBuilder实例参考。
  - referenceParameter
```
public W3CEndpointReferenceBuilder referenceParameter(Element referenceParameter)
```
    加 referenceParameter的 W3CEndpointReference实例 wsa:ReferenceParameters元。
    
    参数
    
    referenceParameter的元素被添加到 wsa:ReferenceParameters元。
    
    结果
    
    与 referenceParameter W3CEndpointReferenceBuilder实例添加到 wsa:ReferenceParameters元。
    
    异常
    
    如果是 null referenceParameter IllegalArgumentException。
  - metadata
```
public W3CEndpointReferenceBuilder metadata(Element metadataElement)
```
    加 metadataElement的 W3CEndpointReference实例的 wsa:Metadata元。
    
    参数
    
    metadataElement的元素被添加到 wsa:Metadata元。
    
    结果
    
    与 metadataElement W3CEndpointReferenceBuilder实例添加到 wsa:Metadata元。
    
    异常
    
    如果是 null metadataElement IllegalArgumentException。
  - element
```
public W3CEndpointReferenceBuilder element(Element element)
```
    添加一个扩展元素的 W3CEndpointReference实例的 wsa:EndpointReference元。
    
    参数
    
    element -扩展元素被添加到 W3CEndpointReference
    
    结果
    
    一个扩展 element W3CEndpointReferenceBuilder实例添加到 W3CEndpointReference实例。
    
    异常
    
    如果是 null element IllegalArgumentException。
    
    从以下版本开始：
    
    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。
    此方法可用于指定address财产以及任何其它所需的性能，创造一个任何端点W3CEndpointReference。这种方法也可以用来创建一个端点，是由同一个java EE应用发表W3CEndpointReference。该方法能自动确定address端点发表相同的java EE应用，由serviceName和endpointName性质。如果address是null和serviceName和endpointName不确定由同一个java EE应用发布一个端点，一个java.lang.IllegalStateException必须扔。
    结果
    
    从累积的属性设置该 W3CEndpointReferenceBuilder实例 W3CEndpointReference。此方法不会返回 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发生错误。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class W3CEndpointReferenceBuilder

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

W3CEndpointReferenceBuilder

方法详细信息

address

interfaceName

serviceName

endpointName

wsdlDocumentLocation

referenceParameter

metadata

element

attribute

build