SOAP: как расширить тип, не нарушая существующих клиентов? - PullRequest
Новая
       18

SOAP: как расширить тип, не нарушая существующих клиентов?

0 голосов
/ 09 сентября 2011

У меня есть SOAP-сервис, который реализован с использованием Apache Axis 2. Он имеет тип Message со следующим определением 

<xs:complexType name="Message">
  <xs:sequence>
    <xs:element minOccurs="0" name="id" type="xs:int"/>
    <xs:element minOccurs="0" name="caption" nillable="true" type="xs:string"/>
    <xs:element minOccurs="0" name="text" nillable="true" type="xs:string"/>
    <xs:element minOccurs="0" name="source" nillable="true" type="xs:string"/>
  </xs:sequence>
</xs:complexType>

Я должен заменить элемент source ссылкой насложный тип Source.Каков наилучший способ сделать это, избегая, чтобы сломать существующих клиентов?

1 Ответ

2 голосов
/ 09 сентября 2011

Мартин Фаулер предоставил отличную статью о версиях схемы и точках расширения . Тем не менее, поскольку у вас нет точек расширения сегодня, это не вариант для вас. Подход, широко используемый в отрасли, заключается в наличии более чем одной версии ваших WSDL и XSD в определенный момент времени. Так что если ваш веб-сервис указан с использованием четырех компонентов:

  1. XML-схема (xsd), описывающая вашу модель данных
  2. WSDL + привязка, описывающая веб-сервис с использованием XSD
  3. Поставщик услуг реализован на Java (сгенерированный код, например, JAX-WS)
  4. Реализация сервиса, "как-то" отделена от # 3

и вам необходимо внести изменения, несовместимые с предыдущими версиями, вы можете продублировать компоненты # 1 и # 2 и определить для них другое пространство имен, например, "http://www.example.org/abc_v2". Вы должны сгенерировать поставщика для новой версии вашего сервиса (# 3) и «каким-то образом» интегрировать его с компонентом # 4 - без вопросов, это ужасная часть.

Этот подход работает, хотя он не очень хорош, поскольку вы дублируете много кода, который нужно сохранить. Если вы следуете этому подходу, вы должны определить крайний срок для всех клиентов, все еще использующих версию 1 вашего сервиса, чтобы вы могли избавиться от дублированного кода позже.

В заключение, неплохо, но вариант.

...