ws-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From veit...@apache.org
Subject svn commit: r1308181 - /webservices/commons/trunk/modules/axiom/src/docbkx/userguide.xml
Date Sun, 01 Apr 2012 19:05:19 GMT
Author: veithen
Date: Sun Apr  1 19:05:18 2012
New Revision: 1308181

URL: http://svn.apache.org/viewvc?rev=1308181&view=rev
Log:
Added a note about how to interact with a DOM aware Axiom implementation.

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=1308181&r1=1308180&r2=1308181&view=diff
==============================================================================
--- webservices/commons/trunk/modules/axiom/src/docbkx/userguide.xml (original)
+++ webservices/commons/trunk/modules/axiom/src/docbkx/userguide.xml Sun Apr  1 19:05:18 2012
@@ -1323,7 +1323,30 @@ while (iterator.hasNext()) {
                                 <methodname>OMContainer#getSAXSource(boolean)</methodname>
should be used.
                             </para>
                         </listitem>
+                        <listitem>
+                            <para>
+                                <classname>org.apache.axiom.om.impl.dom.DOOMAbstractFactory</classname>
has been deprecated
+                                because it ties application code that requires an object
model factory supporting DOM to
+                                a particular Axiom implementation (DOOM). Instead use <methodname>OMAbstractFactory.getMetaFactory(String)</methodname>
+                                with <literal>OMAbstractFactory.FEATURE_DOM</literal>
as parameter value to get a meta factory
+                                for an Axiom implementation that supports DOM.
+                            </para>
+                        </listitem>
+                        <listitem>
+                            <para>
+                                The <classname>DocumentBuilderFactory</classname>
implementation provided by DOOM should no
+                                longer be instantiated directly. Instead, application code
should request a meta factory for
+                                DOM (see previous item), cast it to <classname>DOMMetaFactory</classname>
and invoke
+                                <methodname>newDocumentBuilderFactory</methodname>
via that interface.
+                            </para>
+                        </listitem>
                     </itemizedlist>
+                    <tip>
+                        <para>
+                            The last two changes imply that <literal>axiom-dom</literal>
should no longer be used as a
+                            compile time dependency, but only as a runtime dependency.
+                        </para>
+                    </tip>
                     <para>
                         Note that some of the superseded APIs may disappear in Axiom 1.3.
                     </para>



Mime
View raw message