This topic provides more information on each method of the MessageWarehouse interface. It supplements the information given for this interface in the gateway Javadoc.
The MessageWarehouse interface encapsulates a service which stores messages for archiving. Channels use this interface to log incoming requests for the purposes of non-repudiation.
A default implementation of this interface is not provided by the Web services gateway. If no implementation is present, the interface is not used.
This method stores a request, with information about the channel and the originator of the request.
The channel calls this method when a request is received, after the user is authenticated and the message decrypted. The channel might provide information to identify the originator of the request, and to identify the channel. The request is logged as a WSIFMessage message.
You can also log additional information regarding receipt of the request (for example any associated digital certificates) as Serializable objects.
This method stores a response, with information about the channel and the destination of the response.
The channel calls this method when a response is about to be sent, before the response is encrypted. The channel might provide information to identify the destination of the response, and to identify the channel. The response is logged as a WSIFMessage message.
You can also log additional information regarding sending of the response (for example any associated digital certificates) as Serializable objects.
This method stores a request, with information about the channel and the originator of the request, when an exception is thrown to the channel during request processing. This method allows the exact request and exception information to be logged before the channel decides the actions to take.
You can also log additional information regarding request and exception (for example any associated digital certificates) as Serializable objects.