将版本信息放在wsdl中的什么位置? [英] Where to place version information in a wsdl?

问题描述

我有一个Web服务，其中的定义位于wsdl文件中，而模式位于外部xsd文件中.

I have a web service where the definitions are located in the wsdl-file and the schema in an external xsd-file.

在xsd文件中，有一个schema标记，它提供了一个属性版本"，我可以用它来记录当前版本. wsdl格式(WSDL 1.1)是否有类似的东西?如果不是，出于文档目的，存储常规版本属性的最佳位置是什么?

In the xsd file, there is the schema tag, which provides an attribute 'version' that I can use to document the current version. Is there something similar in the wsdl format (WSDL 1.1)? If not, what is the best place to store a general version attribute for documentation purposes?

请记住，我不想实现向后兼容，如

Please keep in mind that I do not want to achieve backward compatibility, like it is described in http://blogs.iona.com/sos/20070410-WSDL-Versioning-Best-Practise.pdf. I just want to document the version in the wsdl.

推荐答案

我不知道用于指定版本的专用WSDL构造.相反，您可以为此使用documentation元素，也许是像这样的结构化形式:

I'm not aware of a dedicated WSDL construct for specifying the version. Instead you could use the documentation element for this, maybe in a structured form like this:

<wsdl:service name="MyService1" ...>
  <wsdl:documentation>
    A service for ...

    Author: John Doe

    Version: 1.2

    History: 1.2 2011-07-07 Added operation foo()
             1.1 2011-15-04 Added optional attribute bar
             1.0 2011-10-02 Initial release

  </wsdl:documentation>
  ...
</wsdl:service>

这篇关于将版本信息放在wsdl中的什么位置?的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！