Где разместить информацию о версии в wsdl? - PullRequest
Новая
       56

Где разместить информацию о версии в wsdl?

4 голосов
/ 07 июля 2011

У меня есть веб-сервис, где определения находятся в wsdl-файле, а схема - во внешнем xsd-файле.

В файле xsd есть тег схемы, который предоставляет атрибут «версия», который я могу использовать для документирования текущей версии. Есть ли что-то похожее в формате wsdl (WSDL 1.1)? Если нет, то в каком месте лучше хранить атрибут общей версии для документации?

Имейте в виду, что я не хочу достичь обратной совместимости, как это описано в http://blogs.iona.com/sos/20070410-WSDL-Versioning-Best-Practise.pdf. Я просто хочу документировать версию в wsdl.

1 Ответ

6 голосов
/ 08 июля 2011

Мне неизвестна специальная конструкция WSDL для указания версии.Вместо этого вы можете использовать для этого элемент documentation, возможно, в структурированной форме, например: 

<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>
...