Service (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

javax.xml.ws
类 Service

java.lang.Object
  javax.xml.ws.Service

public class Service
extends Object

Service 对象提供 Web 服务的客户端视图。

Service 作为以下内容的工厂：

• 目标服务端点的代理。
• 用于远程操作的动态面向消息调用的 javax.xml.ws.Dispatch 实例。

使用 getPorts 方法可以对服务上可用的端口进行枚举。此外，还可以将一个服务端点接口传递给一元的 getPort 方法，并允许运行时选择兼容的端口。

可以通过 HandlerResolver 设置由 Service 创建的所有对象的处理程序链。

可以在服务上设置 Executor 以便更好地控制用来指派异步回调的线程。例如，通过创建 ThreadPoolExecutor 并向服务注册它可以启用带有特定参数的线程池。

从以下版本开始：

JAX-WS 2.0

另请参见：

Provider, HandlerResolver, Executor

---

嵌套类摘要
static class	Service.Mode           动态客户端或服务的方向。

 

构造方法摘要
protected	Service(URL wsdlDocumentLocation, QName serviceName)

 

方法摘要
void	addPort(QName portName, String bindingId, String endpointAddress)           为服务创建新的端口。
static Service	create(QName serviceName)           创建 Service 实例。
static Service	create(URL wsdlDocumentLocation, QName serviceName)           创建 Service 实例。
<T> Dispatch<T>	createDispatch(QName portName, Class<T> type, Service.Mode mode)           创建与用户选择的对象一起使用的 Dispatch 实例。
Dispatch<Object>	createDispatch(QName portName, JAXBContext context, Service.Mode mode)           创建与生成的 JAXB 对象一起使用的 Dispatch 实例。
Executor	getExecutor()           返回此 Service 实例的执行程序。
HandlerResolver	getHandlerResolver()           返回已配置的处理程序解析器。
<T> T	getPort(Class<T> serviceEndpointInterface)           getPort 返回 stub。
<T> T	getPort(QName portName, Class<T> serviceEndpointInterface)           getPort 方法返回 stub。
Iterator<QName>	getPorts()           返回一个 Iterator，它用于此服务所组合的服务端点的 QName 列表。
QName	getServiceName()           获取此服务的名称。
URL	getWSDLDocumentLocation()           获取此 Service 的 WSDL 文档的位置。
void	setExecutor(Executor executor)           设置此 Service 实例的执行程序。
void	setHandlerResolver(HandlerResolver handlerResolver)           设置此 Service 实例的 HandlerResolver。

 

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

构造方法详细信息

Service

protected Service(URL wsdlDocumentLocation,
                  QName serviceName)

方法详细信息

getPort

public <T> T getPort(QName portName,
                     Class<T> serviceEndpointInterface)

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

参数：

portName - WSDL 服务描述中服务端点的限定名称

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

返回：

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

抛出：

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

• 如果创建代理的过程中出现错误
• 如果缺少此方法所需的任何 WSDL 元数据
• 如果指定了非法的 serviceEndpointInterface 或 portName

另请参见：

Proxy, InvocationHandler

---

getPort

public <T> T getPort(Class<T> serviceEndpointInterface)

getPort 返回 stub。参数 serviceEndpointInterface 指定返回的代理所支持的服务端点接口。在此方法的实现中，JAX-WS 运行时系统承担选择协议绑定（和端口）以及配置相应代理的责任。返回的代理不应该由客户端进行配置。

参数：

serviceEndpointInterface - 服务端点接口

返回：

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

抛出：

WebServiceException -

• 如果创建代理的过程中出现错误
• 如果缺少此方法所需的任何 WSDL 元数据
• 如果指定了非法的 serviceEndpointInterface

---

addPort

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

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

参数：

portName - 目标服务端点的限定名称

bindingId - 绑定的 String 标识符。

endpointAddress - URI 形式的目标服务端点地址

抛出：

WebServiceException - 如果创建端口的过程中出现错误

另请参见：

SOAPBinding.SOAP11HTTP_BINDING, SOAPBinding.SOAP12HTTP_BINDING, HTTPBinding.HTTP_BINDING

---

createDispatch

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

创建与用户选择的对象一起使用的 Dispatch 实例。

参数：

portName - 目标服务端点的限定名称

type - 用于消息或消息负载的对象类。要求实现支持 javax.xml.transform.Source、javax.xml.soap.SOAPMessage 和 javax.activation.DataSource，具体取决于使用的绑定。

mode - 控制创建的 Dispatch 实例是消息还是所面向的净荷，即用户使用完整的协议消息还是消息负载。例如，当使用 SOAP 协议时，此参数控制用户将使用 SOAP 消息还是使用 SOAP 正文的内容。当类型为 SOAPMessage 时，模式必须为 MESSAGE。

返回：

Dispatch 实例

抛出：

WebServiceException - 如果创建 Dispatch 对象的过程中出现错误

另请参见：

Source, SOAPMessage

---

createDispatch

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

创建与生成的 JAXB 对象一起使用的 Dispatch 实例。

参数：

portName - 目标服务端点的限定名称

context - 用来对消息或消息负载进行编组和解组的 JAXB 上下文。

mode - 控制创建的 Dispatch 实例是消息还是所面向的净荷，即用户使用完整的协议消息还是消息负载。例如，当使用 SOAP 协议时，此参数控制用户将使用 SOAP 消息还是使用 SOAP 正文的内容。

返回：

Dispatch 实例

抛出：

ServiceException - 如果创建 Dispatch 对象的过程中出现错误

另请参见：

JAXBContext

---

getServiceName

public QName getServiceName()

获取此服务的名称。

返回：

此服务的限定名称

---

getPorts

public Iterator<QName> getPorts()

返回一个 Iterator，它用于此服务所组合的服务端点的 QName 列表。

返回：

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

抛出：

WebServiceException - 如果此 Service 类没有对所需 WSDL 元数据的访问权限

---

getWSDLDocumentLocation

public URL getWSDLDocumentLocation()

获取此 Service 的 WSDL 文档的位置。

返回：

此服务 WSDL 文档位置的 URL

---

getHandlerResolver

public HandlerResolver getHandlerResolver()

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

返回：

HandlerResolver，此 Service 实例所使用的 HandlerResolver，如果不存在，则返回 null。

---

setHandlerResolver

public void setHandlerResolver(HandlerResolver handlerResolver)

设置此 Service 实例的 HandlerResolver。

如果存在处理程序解析器，则创建每个代理或 Dispatch 实例时将调用一次该解析器，并且将在实例上设置解析器所返回的处理程序链。

参数：

handlerResolver - 用于随后创建的代理/指派对象的 HandlerResolver。

另请参见：

HandlerResolver

---

getExecutor

public Executor getExecutor()

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

返回：

将用来调用回调的 java.util.concurrent.Executor。

另请参见：

Executor

---

setExecutor

public void setExecutor(Executor executor)

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

参数：

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

抛出：

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

另请参见：

Executor

---

create

public static Service create(URL wsdlDocumentLocation,
                             QName serviceName)

创建 Service 实例。 指定的 WSDL 文档位置和服务限定名称必须唯一标识 wsdl:service 元素。

参数：

wsdlDocumentLocation - 服务 WSDL 文档位置的 URL

serviceName - 服务的 QName

抛出：

WebServiceException - 如果在创建指定服务的过程中发生任何错误

---

create

public static Service create(QName serviceName)

创建 Service 实例。

参数：

serviceName - 服务的 QName

抛出：

WebServiceException - 如果在创建指定服务的过程中发生任何错误

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。