diff --git a/src/docbkx/common.xml b/src/docbkx/common.xml index 33ed38c3..83e054c2 100644 --- a/src/docbkx/common.xml +++ b/src/docbkx/common.xml @@ -160,9 +160,10 @@ To increase reading performance on the AxiomSoapMessageFactory, you can set the payloadCaching property to false (default is true). - This will read the contents of the SOAP body directly from the stream. + This will read the contents of the SOAP body directly from the socket stream. When this setting is enabled, the payload can only be read once. - This means that you have to make sure that any preprocessing of the message does not consume it. + This means that you have to make sure that any pre-processing (logging etc.) of the message does + not consume it. You use the AxiomSoapMessageFactory as follows: @@ -171,6 +172,23 @@ ]]> + + In addition to payload caching, AXIOM also supports full streaming messages, + as defined in the StreamingWebServiceMessage. + This means that the payload can be directly set on the response message, rather than being written + to a DOM tree or buffer. + + + Full streaming for AXIOM is used when a handler method returns a + JAXB2-supported object. + It will automatically set this marshalled object into the response message, and write it out to + the outgoing socket stream when the response is going out. + + + For more information about full streaming, refer to the class-level Javadoc for + StreamingWebServiceMessage and + StreamingPayload. +
<acronym>SOAP</acronym> 1.1 or 1.2