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.
+