javax.xml.ws.spi

Class ServiceDelegate

java.lang.Object

javax.xml.ws.spi.ServiceDelegate

public abstract class ServiceDelegate
extends Object

服务代表在内部由Service对象使用，以允许JAX-WS实现的可插拔性。

每个Service对象都有自己的委托，使用Provider.createServiceDelegate(java.net.URL, javax.xml.namespace.QName, java.lang.Class<? extends javax.xml.ws.Service>)方法创建。 Service对象将其所有实例方法委托给其委托。

从以下版本开始：

JAX-WS 2.0

另请参见：

Service ， Provider

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	ServiceDelegate()

方法摘要

Modifier and Type	Method and Description
abstract void	addPort(QName portName, String bindingId, String endpointAddress) 为服务创建一个新的端口。
abstract <T> Dispatch<T>	createDispatch(EndpointReference endpointReference, 类<T> type, Service.Mode mode, WebServiceFeature... features) 创建一个 Dispatch实例，供用户选择的对象使用。
abstract Dispatch<Object>	createDispatch(EndpointReference endpointReference, JAXBContext context, Service.Mode mode, WebServiceFeature... features) 创建一个用于JAXB生成的对象的 Dispatch实例。
abstract <T> Dispatch<T>	createDispatch(QName portName, 类<T> type, Service.Mode mode) 创建一个 Dispatch实例，供用户选择的对象使用。
abstract <T> Dispatch<T>	createDispatch(QName portName, 类<T> type, Service.Mode mode, WebServiceFeature... features) 创建一个 Dispatch实例，供用户选择的对象使用。
abstract Dispatch<Object>	createDispatch(QName portName, JAXBContext context, Service.Mode mode) 创建一个用于JAXB生成的对象的 Dispatch实例。
abstract Dispatch<Object>	createDispatch(QName portName, JAXBContext context, Service.Mode mode, WebServiceFeature... features) 创建一个用于JAXB生成的对象的 Dispatch实例。
abstract Executor	getExecutor() 返回此 Service实例的执行程序。
abstract HandlerResolver	getHandlerResolver() 返回配置的处理程序解析器。
abstract <T> T	getPort(类<T> serviceEndpointInterface) getPort方法返回一个代理。
abstract <T> T	getPort(类<T> serviceEndpointInterface, WebServiceFeature... features) getPort方法返回一个代理。
abstract <T> T	getPort(EndpointReference endpointReference, 类<T> serviceEndpointInterface, WebServiceFeature... features) getPort方法返回一个代理。
abstract <T> T	getPort(QName portName, 类<T> serviceEndpointInterface) getPort方法返回一个代理。
abstract <T> T	getPort(QName portName, 类<T> serviceEndpointInterface, WebServiceFeature... features) getPort方法返回代理。
abstract Iterator<QName>	getPorts() 返回 Iterator ，用于 QName服务分组的 QName个服务端点列表
abstract QName	getServiceName() 获取此服务的名称。
abstract URL	getWSDLDocumentLocation() 获取此服务的WSDL文档的位置。
abstract void	setExecutor(Executor executor) 设置此 Service实例的执行程序。
abstract void	setHandlerResolver(HandlerResolver handlerResolver) 设置 HandlerResolver这个 Service实例。

Methods inherited from class java.lang.Object

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

构造方法详细信息

ServiceDelegate

protected ServiceDelegate()

方法详细信息

getPort

public abstract <T> T getPort(QName portName,
                              类<T> serviceEndpointInterface)

getPort方法返回代理。 服务客户端使用此代理来调用目标服务端点上的操作。 serviceEndpointInterface指定创建的动态代理实例支持的服务端点接口。

参数

portName - WSDL服务描述中服务端点的合格名称

serviceEndpointInterface - 动态代理支持的服务端点接口

结果

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

异常

WebServiceException - 在以下情况下抛出此异常：

• 如果创建代理时出现错误
• 如果此方法需要缺少WSDL元数据
• 如果非法serviceEndpointInterface或portName指定

另请参见：

Proxy ， InvocationHandler

getPort

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

getPort方法返回代理。 服务客户端使用此代理来调用目标服务端点上的操作。 serviceEndpointInterface指定创建的动态代理实例支持的服务端点接口。

参数

portName - WSDL服务描述中服务端点的合格名称

serviceEndpointInterface - 动态代理或实例支持的服务端点接口

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

结果

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

异常

WebServiceException - 在以下情况下抛出此异常：

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

从以下版本开始：

JAX-WS 2.1

另请参见：

Proxy ， InvocationHandler ， WebServiceFeature

getPort

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

getPort方法返回代理。 参数endpointReference endpointReference将由返回的代理调用的端点。 如果有在任何参考参数endpointReference ，则这些参考参数必须显示为SOAP标头，指示它们是参照参数，对发送到端点的所有消息。 endpointReference's地址必须用于端点上的调用。 参数serviceEndpointInterface指定返回的代理支持的服务端点接口。 在此方法的实施中，JAX-WS运行时系统需要选择协议绑定（和端口），并从与此相关联的WSDL相应地配置代理的责任Service实例或从元数据endpointReference 。 如果此Service实例具有WSDL，并且endpointReference元数据也具有WSDL，则必须使用此实例的WSDL。 如果这个Service实例没有WSDL，并且endpointReference确实有一个WSDL，那么可以使用endpointReference的WSDL。 返回的代理不应由客户机重新配置。 如果此Service实例具有与WSDL中包含的信息相匹配的已知代理端口，则返回该代理，否则抛出WebServiceException。

调用此方法具有与以下相同的行为

  port = service.getPort(portName, serviceEndpointInterface); 

其中portName从的元数据检索endpointReference或从serviceEndpointInterface和与此相关的WSDL Service实例。

参数

endpointReference - 将由返回的代理调用的目标服务端点的 EndpointReference 。

serviceEndpointInterface - 服务端点接口。

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

结果

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

异常

WebServiceException -

• 如果在创建代理时出现错误。
• 如果此方法需要缺少WSDL元数据。
• 如果endpointReference元数据与此Service实例的serviceName不匹配。
• 如果portName不能从WSDL或提取endpointReference元数据。
• 如果无效endpointReference指定。
• 如果无效serviceEndpointInterface指定。
• 如果启用了与该端口不兼容或不受支持的功能。

从以下版本开始：

JAX-WS 2.1

getPort

public abstract <T> T getPort(类<T> serviceEndpointInterface)

getPort方法返回代理。 参数serviceEndpointInterface指定返回的代理支持的服务端点接口。 在实现该方法时，JAX-WS运行时系统负责选择协议绑定（和端口）并相应地配置代理。 返回的代理不应由客户机重新配置。

参数

serviceEndpointInterface - 服务端点接口

结果

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

异常

WebServiceException -

• 如果在创建代理时出现错误
• 如果此方法需要缺少WSDL元数据
• 如果非法serviceEndpointInterface指定

getPort

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

getPort方法返回代理。 参数serviceEndpointInterface指定返回的代理支持的服务端点接口。 在实现该方法时，JAX-WS运行时系统负责选择协议绑定（和端口）并相应地配置代理。 返回的代理不应由客户机重新配置。

参数

serviceEndpointInterface - 服务端点接口

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

结果

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

异常

WebServiceException -

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

从以下版本开始：

JAX-WS 2.1

另请参见：

WebServiceFeature

addPort

public abstract void addPort(QName portName,
                             String bindingId,
                             String endpointAddress)

为服务创建一个新的端口。 以这种方式创建的端口不包含WSDL端口类型信息，只能用于创建Dispatch实例。

参数

portName - 目标服务端点的合格名称

bindingId - 绑定的URI标识符。

endpointAddress - 作为URI的目标服务端点的地址

异常

WebServiceException - 如果端口创建有任何错误

另请参见：

SOAPBinding.SOAP11HTTP_BINDING ， SOAPBinding.SOAP12HTTP_BINDING ， HTTPBinding.HTTP_BINDING

createDispatch

public abstract <T> Dispatch<T> createDispatch(QName portName,
                                               类<T> type,
                                               Service.Mode mode)

创建一个 Dispatch实例，供用户选择的对象使用。

参数

portName - 目标服务端点的合格名称

type - 用于消息或消息有效载荷的对象类。 需要实现支持javax.xml.transform.Source和javax.xml.soap.SOAPMessage 。

mode - 控制创建的调度实例是消息还是有效负载，即用户是否使用完整的协议消息或消息有效载荷。 例如，当使用SOAP协议时，此参数控制用户是否使用SOAP消息或SOAP主体的内容。 模式必须MESSAGE当类型是SOAPMessage 。

结果

调度实例

异常

WebServiceException - 如果在创建 Dispatch对象时有任何错误

另请参见：

Source ， SOAPMessage

createDispatch

public abstract <T> Dispatch<T> createDispatch(QName portName,
                                               类<T> type,
                                               Service.Mode mode,
                                               WebServiceFeature... features)

创建一个用于用户选择的对象的 Dispatch实例。

参数

portName - 目标服务端点的合格名称

type - 用于消息或消息有效载荷的对象类。 需要实施支持javax.xml.transform.Source和javax.xml.soap.SOAPMessage 。

mode - 控制创建的调度实例是消息还是有效负载，即用户是否使用完整的协议消息或消息有效载荷。 例如，当使用SOAP协议时，此参数控制用户是否使用SOAP消息或SOAP主体的内容。 模式必须MESSAGE当类型是SOAPMessage 。

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

结果

调度实例

异常

WebServiceException - 如果在创建 Dispatch对象时出现任何错误，或启用了与该端口不兼容或不支持的功能。

从以下版本开始：

JAX-WS 2.1

另请参见：

Source ， SOAPMessage ， WebServiceFeature

createDispatch

public abstract <T> Dispatch<T> createDispatch(EndpointReference endpointReference,
                                               类<T> type,
                                               Service.Mode mode,
                                               WebServiceFeature... features)

创建一个Dispatch实例，供用户选择的对象使用。 如果有在任何参考参数endpointReference ，则这些参考参数必须显示为SOAP标头，指示它们是参照参数，对发送到端点的所有消息。 endpointReference's地址必须用于端点上的调用。 在实现此方法时，JAX-WS运行时系统负责选择协议绑定（和端口），并从与此Service实例相关联的WSDL或从Service的元数据相应地endpointReference 。 如果此Service实例具有WSDL，并且endpointReference在其元数据中也具有WSDL，则必须使用此实例的WSDL。 如果这个Service实例没有WSDL，并且endpointReference确实有一个WSDL，那么可以使用endpointReference的WSDL。 一个实现必须能够检索portName从endpointReference元。

此方法的行为与调用相同

  dispatch = service.createDispatch(portName, type, mode, features); 

其中portName从WSDL或检索EndpointReference元数据。

参数

endpointReference -该 EndpointReference用于将由返回调用的目标服务端点 Dispatch对象。

type - 用于消息或消息有效载荷的对象类。 需要实施支持javax.xml.transform.Source和javax.xml.soap.SOAPMessage 。

mode - 控制创建的调度实例是消息还是有效负载，即用户是否使用完整的协议消息或消息有效载荷。 例如，当使用SOAP协议时，此参数控制用户是否使用SOAP消息或SOAP主体的内容。 模式必须MESSAGE当类型是SOAPMessage 。

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

结果

调度实例

异常

WebServiceException -

• 如果此方法需要缺少WSDL元数据。
• 如果endpointReference元数据与与此Service实例相关portName的WSDL的serviceName或portName不匹配。
• 如果portName不能从EndpointReference元数据确定。
• 如果有任何错误，创建Dispatch对象。
• 如果启用了与该端口不兼容或不受支持的功能。

从以下版本开始：

JAX-WS 2.1

另请参见：

Source ， SOAPMessage ， WebServiceFeature

createDispatch

public abstract Dispatch<Object> createDispatch(QName portName,
                                                JAXBContext context,
                                                Service.Mode mode)

创建一个用于JAXB生成的对象的 Dispatch实例。

参数

portName - 目标服务端点的合格名称

context - 用于编组和解组消息或消息有效载荷的JAXB上下文。

mode - 控制创建的调度实例是消息还是有效负载，即用户是否使用完整的协议消息或消息有效载荷。 例如，当使用SOAP协议时，此参数控制用户是否使用SOAP消息或SOAP主体的内容。

结果

调度实例

异常

WebServiceException - 如果在创建 Dispatch对象时有任何错误

另请参见：

JAXBContext

createDispatch

public abstract Dispatch<Object> createDispatch(QName portName,
                                                JAXBContext context,
                                                Service.Mode mode,
                                                WebServiceFeature... features)

创建一个用于JAXB生成的对象的 Dispatch实例。

参数

portName - 目标服务端点的合格名称

context - 用于编组和解组消息或消息有效载荷的JAXB上下文。

mode - 控制创建的调度实例是消息还是有效负载，即用户是否使用完整的协议消息或消息有效载荷。 例如，当使用SOAP协议时，此参数控制用户是否使用SOAP消息或SOAP主体的内容。

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

结果

调度实例

异常

WebServiceException - 如果创建 Dispatch对象时出现任何错误，或启用了与该端口不兼容或不支持的功能。

从以下版本开始：

JAX-WS 2.1

另请参见：

JAXBContext ， WebServiceFeature

createDispatch

public abstract Dispatch<Object> createDispatch(EndpointReference endpointReference,
                                                JAXBContext context,
                                                Service.Mode mode,
                                                WebServiceFeature... features)

创建一个用于JAXB生成的对象的Dispatch实例。 如果有在任何参考参数endpointReference ，则这些参考参数必须显示为SOAP标头，指示它们是参照参数，对发送到端点的所有消息。 endpointReference's地址必须用于端点上的调用。 在实现此方法时，JAX-WS运行时系统负责选择协议绑定（和端口），并从与此Service实例相关联的WSDL或从Service的元数据相应地endpointReference 。 如果此Service实例具有WSDL，并且endpointReference在其元数据中也具有WSDL，则必须使用此实例的WSDL。 如果此Service实例没有WSDL，并且endpointReference确实有一个WSDL，则可以使用endpointReference的WSDL。 一个实现必须能够检索portName从endpointReference元。

此方法与调用相同

  dispatch = service.createDispatch(portName, context, mode, features); 

其中portName是从WSDL或endpointReference元数据endpointReference 。

参数

endpointReference -该 EndpointReference用于将由返回调用的目标服务端点 Dispatch对象。

context - 用于编组和解组消息或消息有效载荷的JAXB上下文。

mode - 控制创建的调度实例是消息还是有效负载，即用户是否使用完整的协议消息或消息有效载荷。 例如，当使用SOAP协议时，此参数控制用户是否使用SOAP消息或SOAP主体的内容。

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

结果

调度实例

异常

WebServiceException -

• 如果此方法需要缺少WSDL元数据。
• 如果endpointReference元数据与与此Service实例相关portName的WSDL的serviceName或portName不匹配。
• 如果portName不能从EndpointReference元数据确定。
• 如果有任何错误在创建Dispatch对象。
• 如果启用了与此端口不兼容或不受支持的功能。

从以下版本开始：

JAX-WS 2.1

另请参见：

JAXBContext ， WebServiceFeature

getServiceName

public abstract QName getServiceName()

获取此服务的名称。

结果

此服务的合格名称

getPorts

public abstract Iterator<QName> getPorts()

返回 Iterator的 QName s服务端点列表 QName服务分组

结果

返回 java.util.Iterator ，元素类型为 javax.xml.namespace.QName

异常

WebServiceException - 如果此Service类无法访问所需的WSDL元数据

getWSDLDocumentLocation

public abstract URL getWSDLDocumentLocation()

获取此服务的WSDL文档的位置。

结果

此服务的WSDL文档的位置的URL

getHandlerResolver

public abstract HandlerResolver getHandlerResolver()

返回配置的处理程序解析器。

结果

HandlerResolver HandlerResolver被这个 Service实例使用，如果没有一个 null 。

setHandlerResolver

public abstract void setHandlerResolver(HandlerResolver handlerResolver)

设置HandlerResolver这个Service实例。

处理程序解析器（如果存在）将为创建的每个代理或分派实例调用一次，并且解析器返回的处理程序链将在实例上设置。

参数

handlerResolver -该 HandlerResolver用于所有随后创建的代理/调度对象。

另请参见：

HandlerResolver

getExecutor

public abstract Executor getExecutor()

返回此Service实例的执行程序。 执行器用于需要回调的所有异步调用。

结果

java.util.concurrent.Executor用于调用回调。

另请参见：

Executor

setExecutor

public abstract void setExecutor(Executor executor)

设置此Service实例的执行程序。 执行器用于需要回调的所有异步调用。

参数

executor - 用于调用回调的 java.util.concurrent.Executor 。

异常

SecurityException - 如果实例不支持以安全原因设置执行程序（例如缺少必需的权限）。

另请参见：

Executor