svn commit: r1373934 - /webservices/commons/trunk/modules/axiom/src/docbkx/userguide.xml

[ve...@apache.org]

Author: veithen
Date: Thu Aug 16 17:29:01 2012
New Revision: 1373934

URL: http://svn.apache.org/viewvc?rev=1373934&view=rev
Log:
AXIOM-419: Updated user guide to take into account the introduction of AbstractPullOMDataSource.

Modified:
    webservices/commons/trunk/modules/axiom/src/docbkx/userguide.xml

Modified: webservices/commons/trunk/modules/axiom/src/docbkx/userguide.xml
URL: http://svn.apache.org/viewvc/webservices/commons/trunk/modules/axiom/src/docbkx/userguide.xml?rev=1373934&r1=1373933&r2=1373934&view=diff
==============================================================================
--- webservices/commons/trunk/modules/axiom/src/docbkx/userguide.xml (original)
+++ webservices/commons/trunk/modules/axiom/src/docbkx/userguide.xml Thu Aug 16 17:29:01 2012
@@ -1707,17 +1707,9 @@ public InputStream getInputStream() thro
                             to pull the events from the reader returned by a call to
                             <methodname>getReader</methodname> and copy them to the
                             <classname>XMLStreamReader</classname>. The easiest and most efficient
-                            way to do this is using <classname>StreamingOMSerializer</classname>:
-                        </para>
-                        <example id="OMDataSource-serialize">
-                            <title>Proper implementation of the <methodname>OMDataSource#serialize</methodname> method</title>
-<programlisting>public void serialize(XMLStreamWriter xmlWriter)
-        throws XMLStreamException {
-    StreamingOMSerializer serializer = new StreamingOMSerializer();
-    serializer.serialize(getReader(), xmlWriter);
-}</programlisting>
-                        </example>
-                        <para>
+                            way to do this is to extend <classname>org.apache.axiom.om.ds.AbstractPullOMDataSource</classname>
+                            (available in Axiom 1.2.14), which implements the <methodname>serialize</methodname>
+                            method in exactly that way.
                             There is thus no need to build an intermediary object model in this case.
                         </para>
                     </listitem>