WSDL Versioning

This chapter outlines the currently available SOAP interface versions.

Most service developers should use the v2.1 interface, unless you encounter problems with WS-I Basic Profile compliance. If so, use the v2.2 interface.

The v2.0 interface should be considered obsolete, but is still included for backwards compatibility.

Version Description
v2.0 The original basic SOAP interface, more or less a direct port from the v1.0 SOAP interface of Moria1.

Please refer to the JavaDoc for a detailed description of each method available.
v2.1 Improves on the v2.0 interface by adding proper error handling (as described in the Error Handling overview), as well as methods to support ticket-based SSO (as described in the Single Sign On overview).

Please refer to the JavaDoc for a detailed description of each method available.
v2.2 Functionally identical to the v2.1 interface, but conforms to WS-I Basic Profile 1.0. In order to facilitate this through the limitations of Axis, there is some added complexity to the SOAP encoding of multi-valued attributes. Each attribute now contains a string field named separator, and the values are represented as a single string field. Each value in this field is separated by the aforementioned separator string, and any natural occurrences of the separator in a value is encoded as two subsequent occurrences of the separator string. The separator string is on the form _abcd_, where abcd is a random four-letter sequence in lowercase. For single-valued attributes no separator is used.

Please refer to the JavaDoc for a detailed description of each method available.