31.2. 用于发布服务的 API

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

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 接口。

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

发布String地址 此 publish （） 方法，在指定的地址发布服务提供商。
重要
地址的 URL 方案必须与其中一个服务提供商绑定兼容。
发布ObjectserverContext 此 publish （） 方法，根据指定服务器上下文中提供的信息发布服务提供商。服务器上下文必须为端点定义一个地址，上下文也必须与其中一个服务提供商的可用绑定兼容。

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

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

stop

重要

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