ws-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Andreas Veithen (Updated) (JIRA)" <j...@apache.org>
Subject [jira] [Updated] (AXIOM-387) Deprecate getChildrenWithName and introduce a replacement method
Date Thu, 27 Oct 2011 21:58:32 GMT

     [ https://issues.apache.org/jira/browse/AXIOM-387?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Andreas Veithen updated AXIOM-387:
----------------------------------

    Fix Version/s: 1.2.14
    
> 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
>             Fix For: 1.2.14
>
>
> 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 is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ws.apache.org
For additional commands, e-mail: dev-help@ws.apache.org


Mime
View raw message