[
https://issues.apache.org/jira/browse/AXIOM-387?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Andreas Veithen resolved AXIOM-387.
-----------------------------------
Resolution: Won't Fix
Fix Version/s: (was: 1.2.18)
Won't fix: the legacy behavior has been removed in Axiom 1.3.0 without
introducing a new method.
> Deprecate getChildrenWithName and introduce a replacement method
> ----------------------------------------------------------------
>
> Key: AXIOM-387
> URL: https://issues.apache.org/jira/browse/AXIOM-387
> Project: Axiom
> Issue Type: Task
> Components: API
> Reporter: Andreas Veithen
> Priority: Minor
>
> The behavior of OMElement#getChildrenWithName is somewhat ill defined for
> QNames without namespace. In earlier Axiom versions, for such QNames, the
> returned iterator would only match the local name and return child elements
> with any namespace. This was changed in r522259, but the legacy behavior was
> later restored by AXIOM-11 to avoid breaking existing code. However, this
> legacy behavior is only supported by LLOM. DOOM always uses strict QName
> matching. It should also be noted that none of this is properly documented in
> the Javadoc of the getChildrenWithName method.
> To enable us to eventually get rid of this legacy code, we should
> (1) deprecate OMElement#getChildrenWithName
> (2) introduce a replacement method (getChildrenWithQName) with a well defined
> behavior (i.e. that always uses strict QName matching)
> (3) update the documentation to recommend users to migrate to
> getChildrenWithQName or getChildrenWithLocalName depending on the use case
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
