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
Endpoint
publish
String
address
Object
implementor
Thepublish ()
方法为指定实施创建Endpoint
对象,并发布它。Endpoint
对象使用的绑定由提供的地址
的 URL 方案决定。可用于实施的绑定列表会在扫描支持 URL 方案的绑定。如果找到Endpoint
对象已创建并发布。如果未找到,则方法将失败。使用
publish ()
与调用其中一个create ()
方法相同,然后调用 ???TITLE??? 中使用的publish ()
方法。
传递给任何 Endpoint
创建方法的实施对象必须是以 javax.jws.WebService
.WebService 和满足作为 SEI 实施的要求的类实例,或者它是以 javax.xml.ws.ws.WebServiceProvider 和实施 Provider
接口标注的类的实例。
发布服务供应商
发布
String
address
Thispublish ()
方法通过指定的地址发布服务提供商。重要地址
的 URL 方案必须与其中一个服务提供商的绑定兼容。-
发布
对象服务器Context
Thispublish ()
方法会基于指定服务器上下文提供的信息发布服务提供程序。服务器上下文必须为端点定义地址,上下文也必须与服务提供商的可用绑定之一兼容。
停止已发布的服务供应商
当不再需要服务提供商时,您应该使用 stop ()
方法停止它。stop ()
方法显示在 例 31.1 “停止发布端点的方法” 中,关闭端点并清理它正在使用的资源。
例 31.1. 停止发布端点的方法
stop
端点停止后,便无法重新发布。