POE::Helper::Leve::xmlObjectStyle - a PerlSAX handler base class for calling user-defined subs
use POE::Helper::Leve::xmlObjectStyle;
package MyHandlers;
use vars qw{ @ISA };
sub s_NAME { my ($this, $element) = @_ };
sub e_NAME { my ($this, $element) = @_ };
$this->{Names}; # an array of names
$this->{Nodes}; # an array of $element nodes
$handler = MyHandlers->new(); $this->in_element($name); $this->within_element($name);
POE::Helper::Leve::xmlObjectStyle is a base class for PerlSAX handlers.
POE::Helper::Leve::xmlObjectStyle is subclassed to implement complete behavior and
to add element-specific handling.
Each time an element starts, a method by that name prefixed with `s_' is called with the element to be processed. Each time an element ends, a method with that name prefixed with `e_' is called. Any special characters in the element name are replaced by underscores.
Subclassing POE::Helper::Leve::xmlObjectStyle in this way is similar to XML::Parser's Subs style.
POE::Helper::Leve::xmlObjectStyle maintains a stack of element names,
`$this-{Names}', and a stack of element nodes, `$this-{Nodes}>'
that can be used by subclasses. The current element is pushed on the
stacks before calling an element-name start method and popped off the
stacks after calling the element-name end method. The
`in_element()' and `within_element()' calls use these stacks.
If the subclass implements `start_document()', `end_document()',
`start_element()', and `end_element()', be sure to use
`SUPER::' to call the the superclass methods also. See perlobj(1)
for details on SUPER::. `SUPER::start_element()' and
`SUPER::end_element()' return 1 if an element-name method is
called, they return 0 if no method was called.
POE::Helper::Leve::xmlObjectStyle does not implement any other PerlSAX handlers.
POE::Helper::Leve::xmlObjectStyle supports the following methods:
new()' method. `new()' takes a list of key, value
pairs or a hash and creates and returns a hash with those options; the
hash is blessed into the subclass.
in_element($name)$name' is equal to the name of the innermost
currently opened element.
within_element($name)$name' appears in Names.
Ken MacLeod, ken@bitsko.slc.ut.us
perl(1), PerlSAX.pod(3)