ReSTful Webservices: Erwartete Output-XML-Struktur
Wenn für die jeweilige URI-Operation in der Webservice-Konfigurationsdatei der Output-Handler HTTP-MetaXml
definiert wurde, erwartet die Webservice-Schnittstelle als Ergebnis des verarbeitenden Prozesses ein XML-Dokument, das nach folgendem Muster aufgebaut ist:
<Response>
<Status code="HTTP-Status-Code"/>
<Headers>
<Header>
<Name>HTTP-Header-Name</Name>
<Value>Header-Wert</Value>
</Header>
<!-- Oder bei Datumswerten: -->
<Header>
<Name>HTTP-Header-Name</Name>
<Date timezone="Zeitzone">Header-Datumswert</Date>
</Header>
</Headers>
<Content encoding="Kodierung">Übermittelte Daten</Content>
</Response>
Das Wurzel-Element <Response>
enthält folgende Elemente:
<Status>
: Enthält in Attributcode
eine dreistellige Zahl mit dem HTTP-Statuscode (z. B.202
).<Headers>
: Enthält beliebig viele<Header>
-Elemente mit HTTP-Header-Informationen. Jedes<Header>
-Element enthält einen HTTP-Header, der über die Kindelemente<Name>
und<Value>
oder<Date>
(bei Datumsangaben im Formatyyyy-MM-dd HH:mm:ss
gemäß SimpleDateFormat)) definiert wird. Für Element<Date>
kann im optionalen Attributtimezone
die Zeitzone angegeben werden.<Content>
(optional): Enthält in Attributencoding
den Kodierungstyp(base64
oderbase16
bzw.hex
) und als Elementinhalt die entsprechend kodierten Nutzdaten und/oder die Stream-Elemente.XML<Content encoding="base64"> ... Base64... <Stream url="http://remote.host/Some/Document?id=foo" transcoding="base64-us-ascii"/> ... mehr Base64... </Content>