java.lang.Object
- javax.xml.ws.EndpointReference

已知直接子类：

W3CEndpointReference
```
public abstract class EndpointReference
extends Object
```
此类表示WS-Addressing EndpointReference，它是对Web服务端点的远程引用。有关WS-Addressing EndpointReferences的更多信息，请参阅Web Services Addressing 1.0 - Core 。
这个类是不可变的，因为典型的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 。

从以下版本开始：

1.6，JAX-WS 2.1

另请参见：

W3CEndpointReference ， Service

构造方法摘要

构造方法
Modifier	Constructor	描述
`protected`	`EndpointReference()`	默认构造函数。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	方法	描述
`<T> T`	`getPort(Class<T> serviceEndpointInterface, WebServiceFeature... features)`	`getPort`方法返回代理。
`static EndpointReference`	`readFrom(Source 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包含的信息集读取EndpointReference的工厂方法。此方法委托给供应商具体实现的Provider.readEndpointReference(javax.xml.transform.Source)方法。
    
    参数
    
    eprInfoset - 要 eprInfoset的 EndpointReference信息集
    
    结果
    
    来自 eprInfoset的端点 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(Class<T> serviceEndpointInterface,
                     WebServiceFeature... features)
```
    getPort方法返回代理。如果在EndpointReference实例中有任何参考参数，那么在发送到端点的所有消息上，这些参考参数必须显示为SOAP头，表示它们是参考参数。参数serviceEndpointInterface指定返回的代理支持的服务端点接口。 EndpointReference实例指定将由返回的代理调用的端点。在此方法的实施中，JAX-WS运行时系统需要选择协议绑定（和端口），并从元数据WSDL从该相应地配置代理的责任EndpointReference或从注释上serviceEndpointInterface 。对于成功返回代理的方法，WSDL元数据必须可用，并且EndpointReference实例必须包含一个理解为serviceName的实现。
    因为此端口不是从Service对象创建的，因此不会自动配置处理程序，并且无法为该端口获取或设置HandlerResolver和Executor 。 BindingProvider().getBinding().setHandlerChain()方法可用于手动配置此端口的处理程序。
    参数类型
    
    T - 服务端点接口
    
    参数
    
    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