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>
