| Name : perl-XML-Filter-DOMFilter-LibXML
| |
| Version : 0.04
| Vendor : obs://build_opensuse_org/devel:languages:perl
|
| Release : lp154.1.1
| Date : 2023-01-27 16:53:14
|
| Group : Development/Libraries/Perl
| Source RPM : perl-XML-Filter-DOMFilter-LibXML-0.04-lp154.1.1.src.rpm
|
| Size : 0.01 MB
| |
| Packager : https://www_suse_com/
| |
| Summary : SAX Filter allowing DOM processing of selected subtrees
|
Description :
This module provides a compromise between SAX and DOM processing by
allowing to use DOM API to process only reasonably small parts of an XML
document. It works as a SAX filter temporarily building small DOM trees
around parts selected by given XPath expressions (with some limitations,
see the /\"LIMITATIONS\" manpage).
The filter has two states which will be refered to as A and B here. The
initial state of the filter is A.
In the state A, only a limited vertical portion of the DOM tree is built.
All SAX events other than start_element are immediatelly passed to Handler.
On start_element event, a new element node is created in the DOM tree. All
possible existing siblings of the newly created node are removed. Thus,
while in state A, there is exactly one node on every level of the tree. Now
all the XPath expressions are checked in the context of the newly created
node. If none of the expressions matches, the parser remains in state A and
passes the start_element event to Handler. Otherwise, the callback
associated with the first expression that matched is remembered and the
parser changes its state to B.
In state B the filter builds a complete DOM subtree of the new element
according to the incomming events. No events are passed to Handler at this
stage. When the subtree is complete (i.e. the corresponding end-tag is
encountered), the callback associated with the XPath expression that
matched is executed. The root element of the subtree is passed to the
callback subroutine as the only argument.
The callback is allowed to do any DOM operations on the DOM subtree, even
to replace it with one or more new subtrees. The callack must, however,
preserve the element\'s parent node as well as all its ancestor nodes
intact. Failing to do so can result in an error or unpredictable results.
When the callback returns, all subtrees that now appear in the DOM tree
under the original element parent are serialized to SAX events and passed
to Handler. After that, they are deleted from the DOM tree and the filter
returns to state A.
|
RPM found in directory: /packages/linux-pbone/ftp5.gwdg.de/pub/opensuse/repositories/devel:/languages:/perl:/CPAN-X/15.4/noarch |
