哪些 WSDL 标签可以有文档标签? [英] which WSDL tags can have documentation tag?

问题描述

我正在尝试使用一些统计信息进行 WSDL 解析(使用 c#.net).我的统计数据取决于 WSDL 中的文档标签.我想知道可以包含文档标签的 wsdl 标签列表以检查它们.

am trying to do WSDL parsing (using c#.net) with some statisics on it. my statisics depends on documentation tags in WSDL. i want to know list of wsdl tags that can contains documentation tag to check on them.

我试图阅读 WS-I 基本配置文件，我发现:

i tried to read the WS-I basic profile and i found :

5.1.10 WSDL 文档元素

5.1.10 WSDL documentation Element

WSDL 1.1 模式和 WSDL 1.1 规范在 wsdl:documentation 元素可以放置的位置方面不一致.

The WSDL 1.1 schema and the WSDL 1.1 specification are inconsistent with respect to where wsdl:documentation elements may be placed.

R2020 wsdl:documentation 元素可以作为描述中 wsdl:import 元素的子元素出现.WSDL20

R2020 The wsdl:documentation element MAY occur as a child of the wsdl:import element in a DESCRIPTION. WSDL20

R2021 wsdl:documentation 元素可以作为描述中 wsdl:part 元素的子元素出现.WSDL20

R2021 The wsdl:documentation element MAY occur as a child of the wsdl:part element in a DESCRIPTION. WSDL20

R2024 wsdl:documentation 元素可以作为描述中 wsdl:definitions 元素的第一个子元素出现.WSDL20

R2024 The wsdl:documentation element MAY occur as a first child of the wsdl:definitions element in a DESCRIPTION. WSDL20

但是，此配置文件是在 2004 年制作的，所以他们是否进行了更改?文档标签可以是当前标签的任何内部子标签的一部分吗?

however, this profile is made in 2004 so did they apply changes? can a documentation tag be a part of any inner child-tag of the current tag?

谢谢Kawthar almatori

Thank you Kawthar almatori

推荐答案

作为 WS-I 基本配置文件 2.0 指出，WSDL 1.1 规范之间存在一些不一致 和 WSDL 1.1 模式.根据架构，允许 元素作为以下元素的第一个子元素:

As the WS-I basic profile 2.0 states, there are some inconsistencies between the WSDL 1.1 specification and the WSDL 1.1 schema. According to the schema a <wsdl:documentation> element is allowed as the first child of the following elements:

/definitions
/definitions/binding
/definitions/binding/operation
/definitions/binding/operation/fault
/definitions/binding/operation/input
/definitions/binding/operation/output
/definitions/import
/definitions/message
/definitions/message/part
/definitions/portType
/definitions/portType/operation
/definitions/portType/operation/fault
/definitions/portType/operation/input
/definitions/portType/operation/output
/definitions/service
/definitions/service/port
/definitions/types

WSDL 1.1 规范在以下方面有所不同:

The WSDL 1.1 specification differs in the following ways:

• 它将 /definitions/documentation 元素放在 /definitions/import 元素之后(如果存在).
• 它不允许 子元素位于 /definitions/import 或 /definitions/message/part 元素上.

• It places the /definitions/documentation element after the /definitions/import element(s), if present.
• It does not allow <wsdl:documentation> children on the /definitions/import or /definitions/message/part elements.

WS-I 基本概要中的声明基本上重申了 WSDL 1.1 模式，允许 /definitions/import 和 /definitions/message/part 元素，以及指定允许 作为 /definitions

The statements in the WS-I basic profile basically reaffirm the WSDL 1.1 schema, allowing on the /definitions/import and /definitions/message/part elements, and specifying that <wsdl:documentation> is allowed as the first child of /definitions

这篇关于哪些 WSDL 标签可以有文档标签?的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！