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