You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ws.apache.org by "Andreas Veithen (JIRA)" <ji...@apache.org> on 2016/02/20 16:51:18 UTC
[jira] [Resolved] (AXIOM-387) Deprecate getChildrenWithName and
introduce a replacement method
[ 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: dev-unsubscribe@ws.apache.org
For additional commands, e-mail: dev-help@ws.apache.org