31.2. 用于发布服务的 API


概述

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

  1. 为您的服务提供商创建一个 Endpoint 对象。
  2. 发布端点。
  3. 在应用程序关闭时停止端点。

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

实例化服务提供商

服务提供商使用 Endpoint 对象进行实例化。您可以使用以下方法之一实例化您的服务提供商的 Endpoint 对象:

  • 静态端点创建对象实现器 This create() 方法返回指定服务的端点。Endpoint 对象使用实现类的 javax.xml.ws.BindingType 注解提供的信息创建(如果存在)。如果没有注解,则 Endpoint 将使用默认的 SOAP 1.1/HTTP 绑定。
  • 静态端点创建URI绑定ID对象实现器 This create () 方法使用指定的绑定返回指定实施对象的 Endpoint 对象。如果存在,此方法会覆盖 javax.xml.ws.BindingType 注解提供的绑定信息。如果 bindingID 无法解析,或者为空,则使用 javax.xml.ws.BindingType 中指定的绑定来创建 Endpoint如果不使用 bindingIDjavax.xml.ws.BindingType,则会使用默认的 SOAP 1.1/HTTP 绑定创建 端点
  • staticEndpointpublishStringaddressObjectimplementor The publish () 方法为指定实施创建 Endpoint 对象,并发布它。Endpoint 对象使用的绑定由提供 的地址 的 URL 方案决定。可用于实施的绑定列表会在扫描支持 URL 方案的绑定。如果找到 Endpoint 对象已创建并发布。如果未找到,则方法将失败。

    使用 publish () 与调用其中一个 create () 方法相同,然后调用 ???TITLE??? 中使用的 publish () 方法。

重要

传递给任何 Endpoint 创建方法的实施对象必须是以 javax.jws.WebService.WebService 和满足作为 SEI 实施的要求的类实例,或者它是以 javax.xml.ws.ws.WebServiceProvider 和实施 Provider 接口标注的类的实例。

发布服务供应商

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

  • 发布Stringaddress This publish () 方法通过指定的地址发布服务提供商。

    重要

    地址 的 URL 方案必须与其中一个服务提供商的绑定兼容。

  • 发布对象服务器Context This publish () 方法会基于指定服务器上下文提供的信息发布服务提供程序。服务器上下文必须为端点定义地址,上下文也必须与服务提供商的可用绑定之一兼容。

停止已发布的服务供应商

当不再需要服务提供商时,您应该使用 stop () 方法停止它。stop () 方法显示在 例 31.1 “停止发布端点的方法” 中,关闭端点并清理它正在使用的资源。

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

stop

重要

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

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.