构造方法详细信息

• 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时发生错误。