...
Backward compatible changes:
- adding new operation
- adding new (XML) type to schema
Non-backward compatible changes:
- removing operation
- renaming operation
- changes in (XML) types or message attributes
- changes in namespace
Versioning
Status | ||||
---|---|---|---|---|
|
Use versions in format <major>.<minor>.
Minor version is for compatible changes, major version indicates non-compatible changes.
Versioning should be explicit - it means to present version number in elements, URLs etc.:
- add major and minor version to WSDL name: MyService-v1.2.wsdl
- add major version to targetNamespace of WSDL: <definition targetNamespace="http://cleverbssopenhubframework.org/ws/MyService-v1" xmlns="http://schemas.xmlsoap.org/wsdl/">
- add major and minor version to portType element: <portType name="MyServicePort-v1.2">
- add major and minor version to service element: <service name="MyService-v1.2">
- add major and minor version to endpoint: <soap<soap:address locationaddress location="http:// cleverbssopenhubframework.org/myService/v1"/>
If there is change in WSDL's version then change versions of XSDs as well.