PRANG::Graph::Node - role for nodes in XML Graph machinery


 package PRANG::Graph::Foo;
 with 'PRANG::Graph::Node';


This role is essentially an interface which different types of acceptors/emitted in the marshalling machinery must implement.

You should hopefully not have to implement or poke into this class, but if you do end up there while debugging then this documentation is for you.


Currently there are four methods required;

accept( XML::LibXML::Node $node, PRANG::Graph::Context $ctx ) returns ($key, $value, $nodeNameIfAmbiguous)

Given an XML node, completely and recursively parse that node, construct an object and return that object along with the name of the node if the schema requires it.

Updates $ctx with any parse state affected by the operation.

complete( PRANG::Graph::Context $ctx ) returns Bool

Returns true if the acceptor could be happy with the amount of parsing that has been recorded in $ctx or not.

expected( PRANG::Graph::Context $ctx ) returns (@Str)

If there has not been enough accepted, then this function returns something useful for building a helpful exception message.

output( Object $item, XML::LibXML::Element $node, HashRef $xsi)

Given the item $item, marshall to XML by constructing new LibXML nodes and attaching to $node; $xsi is the current XML namespaces mapping.


PRANG::Graph::Meta::Class, PRANG::Graph::Meta::Attr, PRANG::Graph::Meta::Element, PRANG::Marshaller, PRANG::Graph::Context


PRANG::Graph::Seq, PRANG::Graph::Quant, PRANG::Graph::Choice, PRANG::Graph::Element, PRANG::Graph::Text


Development commissioned by NZ Registry Services, and carried out by Catalyst IT -

Copyright 2009, 2010, NZ Registry Services. This module is licensed under the Artistic License v2.0, which permits relicensing under other Free Software licenses.