javax.xml.ws

Class EndpointReference

java.lang.Object

javax.xml.ws.EndpointReference

已知直接子类：

W3CEndpointReference

public abstract class EndpointReference
extends Object

此类表示WS-Addressing EndpointReference，它是对Web服务端点的远程引用。 见Web Services Addressing 1.0 - Core对WS-Addressing的EndpointReferences更多信息。

这个类是不可变的，因为典型的Web服务开发者不需要关心它的内容。 Web服务开发人员应该严格使用此类作为引用远程Web服务端点的机制。 请参阅客户端可以使用的Service API，以利用EndpointReference 。 见Endpoint和BindingProvider如何的API EndpointReferences可以发表端点创建。

这个类具体实现将代表一个EndpointReference为解决特定版本。 例如， W3CEndpointReference用于W3C Web服务寻址1.0 - 核心推荐。 如果JAX-WS实现者需要支持不同版本的解决，他们应该自己写EndpointReference子类，该版本。 这将允许JAX-WS实现创建供应商特定的EndpointReferences ，供应商可以使用它来标记不同版本的寻址。

那些希望传递或返回Web服务开发人员EndpointReference在SEI在Java方法应该使用的具体事例EndpointReference如W3CEndpointReference 。 这样，从SEI映射的模式将更多地描述正在传递的端点引用的类型。

JAX-WS实现者有望使用writeTo(javax.xml.transform.Result)方法从EndpointReferece中提取XML信息集。

JAXB将绑定这个类到xs：anyType。 如果需要更好的绑定，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中 eprInfoset的信息集读取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

构造方法详细信息

EndpointReference

protected EndpointReference()

方法详细信息

readFrom

public static EndpointReference readFrom(Source eprInfoset)

从eprInfoset中eprInfoset的信息集读取EndpointReference的工厂方法。 该方法委托给供应商具体实现的Provider.readEndpointReference(javax.xml.transform.Source)方法。

参数

eprInfoset - 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运行时系统需要选择协议绑定（和端口），并从元数据WSDL从该相应地配置代理的责任EndpointReference或从注解的serviceEndpointInterface 。 对于成功返回代理的方法，WSDL元数据必须可用，并且EndpointReference实例必须包含一个理解为serviceName元数据的实现。

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

参数

serviceEndpointInterface - 服务端点接口

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

结果

支持指定服务端点接口的Object Proxy实例

异常

WebServiceException -

• 如果在创建代理时出现错误
• 如果此方法需要缺少WSDL元数据
• 如果这个endpointReference无效
• 如果非法serviceEndpointInterface指定
• 如果启用了与该端口不兼容或不受支持的功能。

另请参见：

Proxy ， WebServiceFeature

toString

public String toString()

显示EPR信息，方便调试。

重写：

toString在 Object

结果

对象的字符串表示形式。