ws-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From veit...@apache.org
Subject svn commit: r1202356 - /webservices/commons/trunk/modules/axiom/src/site/apt/roadmap.apt
Date Tue, 15 Nov 2011 18:26:25 GMT
Author: veithen
Date: Tue Nov 15 18:26:25 2011
New Revision: 1202356

URL: http://svn.apache.org/viewvc?rev=1202356&view=rev
Log:
Added an item to the 1.3 roadmap.

Modified:
    webservices/commons/trunk/modules/axiom/src/site/apt/roadmap.apt

Modified: webservices/commons/trunk/modules/axiom/src/site/apt/roadmap.apt
URL: http://svn.apache.org/viewvc/webservices/commons/trunk/modules/axiom/src/site/apt/roadmap.apt?rev=1202356&r1=1202355&r2=1202356&view=diff
==============================================================================
--- webservices/commons/trunk/modules/axiom/src/site/apt/roadmap.apt (original)
+++ webservices/commons/trunk/modules/axiom/src/site/apt/roadmap.apt Tue Nov 15 18:26:25 2011
@@ -56,3 +56,18 @@ API inconsistencies to be eliminated
    * <<<OMText#getDataHandler()>>>
    
    * <<<OMFactory#createOMText(Object, boolean)>>>
+
+* Methods declared by the wrong interface in the node type hierarchy
+
+  Some methods are declared at the wrong level in the node type hierarchy so that they may
+  be called on nodes for which they are not meaningful:
+  
+   * The <<<serialize>>> and <<<serializeAndConsume>>>
methods that take an <<<OutputStream>>>
+     or <<<Writer>>> object are only meaningful for <<<OMContainer>>>
objects. However, they
+     are declared by <<<OMNode>>>. Note that already in 1.2.x, these methods
are deprecated.
+   
+   * <<<OMContainer>>> declares several methods that return child elements
by name: <<<getChildrenWithLocalName>>>,
+     <<<getChildrenWithName>>>, <<<getChildrenWithNamespaceURI>>>
and <<<getFirstChildWithName>>>.
+     Since the document element is unique, these methods are not meaningful for <<<OMDocument>>>
+     and they should be declared by <<<OMElement>>> instead.
+     
\ No newline at end of file



Mime
View raw message