搜索

29.3. 使用 JAX-WS 目录

download PDF

概述

JAX-WS 规范要求所有实现都支持:

解决 Web 服务描述的任何 Web 服务文档时要使用的标准目录功能,特别是 WSDL 和 XML Schema 文档。

这个目录工具使用 OASIS 指定的 XML 目录功能。所有采用 WSDL URI 的 JAX-WS API 和注释均使用目录来解决 WSDL 文档的位置。

这意味着您可以提供一个 XML 目录服务来重写 WSDL 文档的位置,以为特定部署环境进行套件。

编写目录

JAX-WS 目录是 OASIS XML 目录 1.1 规范中定义的标准 XML 目录。它们允许您指定映射:

  • 文档的公共标识符和/或系统标识符到 URI。
  • 到另一个 URI 的资源 URI。

表 29.1 “常见 JAX-WS 目录元素” 列出用于 WSDL 位置解析的一些常见元素。

表 29.1. 常见 JAX-WS 目录元素
element描述

uri

将 URI 映射到备用 URI。

rewriteURI

重写 URI 的开头。例如,这个元素允许您将所有以 http://cxf.apache.org 开头的 URI 映射到以 classpath: 开头的 URI。

uriSuffix

根据原始 URI 后缀将 URI 映射到备用 URI。例如,您可以将以 foo.xsd 结尾的所有 URI 映射到 classpath:foo.xsd

打包目录

JAX-WS 规范要求目录用来解析 WSDL 和 XML Schema 文档,它们使用名为 META-INF/jax-ws-catalog.xml 的所有可用资源进行汇编。如果您的应用程序被打包成单个 JAR 或 WAR,您可以将目录放在单个文件中。

如果您的应用程序被打包为多个 JAR,您可以将目录分成多个文件中。每个目录文件都模块化化,以仅处理特定 JAR 中代码访问的 WSDL。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.