XML::Generator::DOM 0.99

XML::Generator::DOM is an XML::Generator subclass for producing DOM trees instead of strings.

SYNOPSIS

use XML::Generator::DOM;

my $dg = XML::Generator::DOM->new();
my $doc = $dg->xml($dg->xmlcmnt("Test document."),
$dg->foo({baz => bam}, 42));
print $doc->toString;
yields:
< ?xml version="1.0" standalone="yes"? >
< !--Test document-- >
< foo baz="bam" >42< /foo >

XML::Generator::DOM subclasses XML::Generator in order to produce DOM trees instead of strings (see XML::Generator and XML::DOM). This module is still experimental and its semantics might change.

Essentially, tag methods return XML::DOM::DocumentFragment objects, constructed either from a DOM document passed into the constructor or a default document that XML::Generator::DOM will automatically construct.

Calling the xml() method will return this automatically constructed document and cause a fresh one to be constructed for future tag method calls. If you passed in your own document, you may not call the xml() method.

Below, we just note the remaining differences in semantics between XML::Generator methods and XML::Generator::DOM methods.