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