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