In case of an error during processing, the Assembler API defines
two kinds of exceptions:
AssemblerException
and
CartridgeHandlerException
.
The exceptions are distinguished as follows:
Exception |
Description |
---|---|
|
Indicates that an exception occurred while creating or processing an Assembler request. Exceptions of this type indicate that the entire assembly process was terminated. |
|
Indicates that an exception occurred while invoking a single cartridge handler. Exceptions of this type do not terminate the entire assembly process. |
Both types of exceptions are returned as part of the Assembler response.
The Assembler service returns an HTTP status code of 200 (OK) regardless of whether any exceptions occurred during Assembler processing. Error conditions are serialized as exceptions in the Assembler response, as with the following example:
{ @error: "com.endeca.infront.assembler.CartridgeHandlerException" description: "Detailed cartridge handler error description" }
Unchecked exceptions result in the Assembler service returning HTTP status code 500 (Internal Server Error).