EndpointReference (Java Platform SE 8 )

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
    
    结果
    
    对象的字符串表示形式。

Class EndpointReference

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

EndpointReference

方法详细信息

readFrom

writeTo

getPort

toString