Download GeoNetwork Developer Manual

GeoNetwork Developer Manual, Release 2.9.2
<request>
<hitsPerPage>10</hitsPerPage>
<any />
</request>
Response
The response of an XML service always has a content type of application/xml (the only exception are
those services which return binary data). The document encoding is the one specified into the document’s
prologue. Anyway, all GeoNetwork services return documents in the UTF-8 encoding.
On a GET request, the client can force a SOAP response adding the application/soap+xml content type
to the Accept header parameter.
6.1.2 Exception handling
A response document having an error root element means that the XML service raised an exception.
This can happen under several conditions: bad parameters, internal errors et cetera. In this cases the
returned XML document has the following structure:
• error: This is the root element of the document. It has a mandatory id attribute that represents an
identifier of the error from a common set. See error2_ids for a list of all id values.
– message: A message related to the error. It can be a short description about the error type or
it can contain some other information that completes the id code.
– class: The Java class of the raised error (name without package information).
– stack: The server’s stacktrace up to the point that generated the exception. It contains several
at children, one for each nested level. Useful for debugging purposes.
* at: Information about a nested level of called code. It has the following mandatory
attributes: class Java class of the called method. method Java called method. line Line,
inside the called method’s source code where there the method call of the next nested
level. file Source file where the class is defined.
– object: An optional container for parameters or other values that caused the exception. In
case a parameter is an XML object, this container will contain that object in XML form.
– request: A container for some useful information that can be needed to debug the service.
* language: Language used when the service was called.
* service: Name of the called service.
Summary of error ids:
56
Chapter 6. XML Services