go back Home

List

When making a search-related call on the web services, the result is often a List. This is necessary because an XML document may only have one root node. Since our services originated with XML implementations, this rule holds over to present day even for other representations like JSON. Like Java, the sequence/order of the objects in a List is important.

Lists are never accepted as input for any call.

Example

For example, if you had a widget with an id integer field and a descr String field, it might look like:

XML

<list><widget id="1" descr="Red Widget"/><widget id="2" descr="Blue Widget"/></list>

JSON

[{"__type":"widget", "id":"1", "descr":"Red Widget"},{"__type":"widget", "id":"2", "descr":"Blue Widget"}]

See also