31.2. 用于发布服务的 API
概述 复制链接链接已复制到粘贴板!
javax.xml.ws.Enddpoint 类执行发布 JAX-WS 服务提供商的工作。要发布端点,请执行以下操作:
-
为您的服务提供商创建
Endpoint对象。 - 发布端点。
- 在应用程序关闭时停止端点。
Endpoint 类提供用于创建和发布服务提供商的方法。它还提供了一种方法,可以在单一方法调用中创建和发布服务提供商。
实例化服务提供商 复制链接链接已复制到粘贴板!
服务供应商使用 Endpoint 对象实例化。您可以使用以下方法之一为您的服务提供商实例化 Endpoint 对象:
-
静态
端点创建对象实施或此方法返回指定服务实施的端点。create()Endpoint对象是使用实现类的javax.xml.ws.BindingType注解(如果存在)提供的信息创建的。如果注解不存在,则Endpoint使用默认的 SOAP 1.1/HTTP 绑定。 -
静态
端点创建URI绑定ID对象实施或这个create ()方法使用指定的绑定返回指定实现对象的Endpoint对象。如果存在,此方法会覆盖javax.xml.ws.BindingType注解提供的绑定信息。如果无法解析bindingID,或者是null,则javax.xml.ws.BindingType中指定的绑定用于创建Endpoint。如果无法使用bindingID或javax.xml.ws.BindingType,则端点是使用默认的 SOAP 1.1/HTTP 绑定创建的。 静态
端点发布字符串地址对象实施或publish ()方法为指定的实现创建一个Endpoint对象,并发布它。用于Endpoint对象的绑定由提供的地址的 URL 方案决定。对于支持 URL 方案的绑定,会扫描可用于实现的绑定列表。如果找到了Endpoint对象,则已创建并发布。如果没有找到,则方法会失败。使用
publish ()方法与调用其中一个create ()方法相同,然后调用 ???TITLE??? 中使用的publish ()方法。
传递给任何 Endpoint 创建方法的实现对象必须是带有 javax.jws.WebService 注解的类实例,并满足 SEI 实现的要求,或者它必须是使用 javax.xml.ws.WebServiceProvider 注解的类的实例,并实施 Provider 接口。
发布服务提供商 复制链接链接已复制到粘贴板!
发布String地址此publish ()方法,在指定的地址发布服务提供商。重要地址的URL 方案必须与其中一个服务提供商绑定兼容。-
发布ObjectserverContext此publish ()方法,根据指定服务器上下文中提供的信息发布服务提供商。服务器上下文必须为端点定义一个地址,上下文也必须与其中一个服务提供商的可用绑定兼容。
停止公布的服务提供商 复制链接链接已复制到粘贴板!
当不再需要服务提供商时,您应该使用其 stop () 方法来停止该服务。在 例 31.1 “停止发布端点的方法” 中显示的 stop () 方法会关闭端点并清理它使用的任何资源。
例 31.1. 停止发布端点的方法
stop
端点停止后,无法重新发布。