31.2. 用于发布服务的 API

javax.xml.ws.Enddpoint 类负责发布 JAX-WS 服务提供商。要发布端点，请执行以下操作：

Endpoint 类提供了创建和发布服务提供商的方法。它还提供了一种方式，可以在单一方法调用中创建和发布服务提供商。

服务提供商使用 Endpoint 对象实例化。您可以使用以下方法之一为您的服务提供商实例化一个 Endpoint 对象：

静态端点创建对象实施器 此 create（） 方法返回指定服务实施的 端点。Endpoint 对象是使用实现类 javax.xml.ws.BindingType 注解提供的信息创建的（如果存在）。如果注解不存在，则 Endpoint 会使用默认的 SOAP 1.1/HTTP 绑定。
静态EndpointcreateURIbindingID对象实现器 This create（） 方法使用指定的绑定为指定的实现对象返回 Endpoint 对象。这个方法会覆盖 javax.xml.ws.BindingType 注解提供的绑定信息（如果存在）。如果 绑定ID 无法解析，或者它是 null，则使用 javax.xml.ws.BindingType 中指定的绑定来创建 端点。如果没有可以使用 bindingID 或 javax.xml.ws.BindingType，则 端点 将使用默认的 SOAP 1.1/HTTP 绑定来创建。
静态端点发布字符串地址对象实现器 The publish（） 方法为指定的实施创建一个 Endpoint 对象，并发布它。用于 Endpoint 对象的绑定由提供 的地址 的 URL 方案决定。对于支持 URL 方案的绑定，可扫描可用于实施的绑定列表。如果找到了 Endpoint 对象，则创建并发布该 Endpoint 对象。如果没有找到，则方法会失败。
使用 publish（） 与调用其中一个 create（） 方法相同，然后调用 ???TITLE??? 中使用的 publish（） 方法。

重要

传递给任何 Endpoint 创建方法的实现对象必须是带有 javax.jws.WebService 注解的类实例，并满足作为 SEI 实施的要求，或者必须是带有 javax.xml.ws.WebServiceProvider 的类实例，并实施 Provider 接口。

您可以使用以下 端点 方法之一发布服务提供商：

发布String地址 This publish（） 方法在指定的地址上发布该服务提供商。
重要
地址的 URL 方案必须与服务提供商的绑定之一兼容。
发布对象服务器Context 此 publish（） 方法基于指定服务器上下文提供的信息发布该服务提供商。服务器上下文必须为端点定义地址，上下文还必须与服务提供商的可用绑定之一兼容。

当不再需要服务提供商时，您应该使用 stop（） 方法停止该服务。例 31.1 “停止发布端点的方法” 中显示的 stop（） 方法会关闭端点并清理其使用的所有资源。

例 31.1. 停止发布端点的方法

stop

重要

端点停止后，便无法重新发布。