javax.xml.ws

Class EndpointReference

java.lang.Object

javax.xml.ws.EndpointReference

已知直接子类：

W3CEndpointReference

public abstract class EndpointReference
extends Object

这类代表一个寻址endpointreference是Web服务端点远程引用。看到在寻址endpointreferences更多信息 Web Services Addressing 1.0 - Core。

这个类是不可变的，因为典型的Web服务开发人员不必关心它的内容。Web服务开发人员应该严格使用这个类作为参考一个远程Web服务端点的机制。看到Service API，客户可以利用一个EndpointReference。看到Endpoint，和BindingProvider API如何EndpointReferences可以发表的终点了。

这个类的具体实现将代表一个特定版本的解决EndpointReference。例如，W3CEndpointReference用于Web服务寻址1核心建议。如果JAX-WS实现需要支持针对不同的版本，他们应该为自己写EndpointReference类版本。这将允许一个JAX-WS实现创建一个特定于供应商的EndpointReferences，供应商可以使用国旗的不同版本的寻址。

Web服务开发人员希望传递或返回在SEI在java方法EndpointReference应该使用一个EndpointReference如W3CEndpointReference实例。这样的架构映射到SEI将更具描述性的端点引用类型传递。

JAX-WS实现预期使用writeTo(javax.xml.transform.Result)方法EndpointReferece提取XML信息集。

JAXB绑定这类将xs：任何类型。如果一个更好的结合是理想的，Web服务开发人员应该使用一个具体子类如W3CEndpointReference。

从以下版本开始：

JAX-WS 2.1

另请参见：

W3CEndpointReference， Service

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	EndpointReference()

方法摘要

Modifier and Type	Method and Description
<T> T	getPort(类<T> serviceEndpointInterface, WebServiceFeature... features) 的 getPort方法返回一个代理。
static EndpointReference	readFrom(Source eprInfoset) 工厂方法来读取包含在 eprInfoset InfoSet的endpointreference。
String	toString() 显示调试方便EPR信息集。
abstract void	writeTo(Result result) 写这 EndpointReference到指定设备的格式

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

EndpointReference

protected EndpointReference()

方法详细信息

readFrom

public static EndpointReference readFrom(Source eprInfoset)

工厂方法来读取包含在 eprInfoset InfoSet的endpointreference。这种方法代表的 Provider.readEndpointReference(javax.xml.transform.Source)供应商特定的实现方法。

参数

eprInfoset -将它们分散的 EndpointReference infoset

结果

它们分散的endpointreference从 eprInfoset从未 null

异常

WebServiceException如果同时从 eprInfoset创造 EndpointReference发生错误

IllegalArgumentException -如果 null eprInfoset值了。

writeTo

public abstract void writeTo(Result result)

写这 EndpointReference到指定设备的格式

参数

result -写集

异常

WebServiceException -如果有一个错误的写作 EndpointReference到指定的 result。

IllegalArgumentException -如果 null result值了。

getPort

public <T> T getPort(类<T> serviceEndpointInterface,
                     WebServiceFeature... features)

的 getPort方法返回一个代理。如果在 EndpointReference实例的任何参数，那么这些参数必须出现在SOAP头，示意他们可以参考参数，在所有的消息发送到终点。参数 serviceEndpointInterface指定服务端点接口，通过返回的代理支持。的 EndpointReference实例指定端点，将通过代理调用返回。在这种方法的实施，JAX-WS运行时系统将选择一个协议绑定的责任（和端口）和配置代理因此从这 EndpointReference WSDL元数据或注释的 serviceEndpointInterface。这种方法成功地返回一个代理，WSDL元数据必须是可用的和 EndpointReference实例必须包含一个实现理解 serviceName元数据。

因为这个港口不是从Service创建对象时，程序不会自动配置，和HandlerResolver和Executor无法获取或设置此端口。的BindingProvider().getBinding().setHandlerChain()方法可用于此端口手动配置处理程序。

参数

serviceEndpointInterface -服务端点接口

features - WebServiceFeatures配置代理上的数组。支持的功能不在 features 参数有默认值。

结果

支持支持指定的服务端点接口的对象代理实例

异常

WebServiceException -

• 如果在创建代理过程中出现错误
• 如果有此方法所需的任何丢失的WSDL元数据
• 如果这endpointReference无效
• 如果一个非法serviceEndpointInterface指定
• 如果启用了一个不与此端口兼容或不支持的功能。

另请参见：

Proxy， WebServiceFeature

toString

public String toString()

显示调试方便EPR信息集。

重写：

toString 方法重写，继承类 Object

结果

对象的字符串表示形式。