Abstract base class for endpoints that handle the message payload with a SAX ContentHandler. Allows
subclasses to create a response by returning a Source.
Implementations of this class should create a new handler for each call of createContentHandler, because
of thread safety. The handlers is later passed on to createResponse, so it can be used for holding
request-specific state.
author: Arjen Poutsma See Also:AbstractSaxPayloadEndpoint.createContentHandler() See Also:AbstractSaxPayloadEndpoint.getResponse(org.xml.sax.ContentHandler) since: 1.0.0
Returns the SAX ContentHandler used to parse the incoming request payload. A new instance should be
created for each call, because of thread-safety. The content handler can be used to hold request-specific state.
If an incoming message does not contain a payload, this method will not be invoked.
a SAX content handler to be used for parsing
Returns the response to be given, if any. This method is called after the request payload has been parsed using
the SAX ContentHandler. The passed ContentHandler is created by
AbstractSaxPayloadEndpoint.createContentHandler() : it can be used to hold request-specific state.
If an incoming message does not contain a payload, this method will be invoked with null as content
handler.
Parameters: contentHandler - the content handler used to parse the request