Error Handling

The TIBCO ActiveMatrix Binding Type for REST returns an error in the response body in case there is fault in a request or a component.

TIBCO ActiveMatrix Binding Type for REST handles errors as follows:

Service

  • System errors such as invalid requests are returned as protocol errors, that is, HTTP error codes.
  • When a wired service returns a SOAP fault, the REST binding returns a 200 OK code by default. A fault message is returned as a response body.
  • The component that implements the WSDL service can override the HTTP response code by using a context parameter named HTTP_RESP_CODE. This parameter is of type int.

    If a component throws an undeclared-fault or a runtime exception, TIBCO ActiveMatrix Binding Type for REST returns an Internal Server Error with HTTP Code 500 and an HTTP_RESP_CODE. If any context variables are set, they are ignored.

Reference

  • All errors for a specific operation can be configured in the REST resource configuration file.
  • Implementation Type consuming REST reference can receive HTTP Status Code and Status Message of the response received using Context Parameters.

    Direction: Output

    Data Type: Int (for statusCode) and String (for Status Message)

    Header Name: statusCode (for HTTP Status Code) / statusMsg (for HTTP Status Message)

    Context Parameter Name: statusCode (for HTTP Status Code) / statusMsg (for HTTP Status Message)