IBM BJ0NJML - Service And Asset Management, Integration Manual

Page: 163 / 330

Handlers
Endpoints and Handlers
149
HTTPEXIT Property
This optional property is used for customization. This property specifies the fully
qualified name of a Java class that interprets the HTTP response. This property
also helps implement the code that is required for an external system to interpret
the HTTP response.
The Java class must be available in the application EAR. The Java class must be in
the class path of the handler.
The system provides a default implementation of the HTTP exit. The Java class is
DefaultHTTPExit, which is in the psdi.iface.router package and implements the
psdi.iface.router.HTTPExit interface.
The Java class has the following key methods:
T processResponseData()
This method has the following signature:
public void processResponseData(int responseCode, String
responseMsg, byte[] msgBodyData) throws MXException
The default implementation compares the response code from the external
system to a range of valid codes (values 200 through 299). If the response
code falls outside that range, the system assumes that the message was not
delivered to the external system. An exception occurs and the message
remains in the queue.
If you need additional processing for a specific implementation, extend
the default implementation and override the processResponseData ()
method. As an alternative, you can implement the
psdi.iface.router.HTTPExit interface. If the response that is received from
the external system does not pass the validation in this class, the
overriding method must issue an exception.
If you do not define a value for this property, the default implementation
of HTTPExit is run.
T getURLProperties()
This method has the following signature:
public Map String, String getURLProperties(Map String,?
metaData, byte[] data, Map String,MaxEndPointPropInfo
httpInfo)
This method returns the map of URL properties that are added to the URL
in the form
url ?prop1=value1&... The default implementation returns a
null value.
Property Value
Java class DefaultHTTPExit.java
Package psdi.iface.router
HTTPEXIT Property psdi.iface.router.DefaultHTTPExit