xml::generator::dom(3pm) [debian man page]

DOM(3pm)						User Contributed Perl Documentation						  DOM(3pm)

NAME

       XML::Generator::DOM - 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>

DESCRIPTION

       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.

CONSTRUCTOR

       These configuration options are accepted but have no effect on the semantics of the returned object: escape, pretty, conformance and empty.

TAG METHODS

       Subsequently, tag method semantics are somewhat different for this module compared to XML::Generator.  The primary difference is that tag
       method return XML::DOM::DocumentFragment objects.  Namespace and attribute processing remains the same, but remaining arguments to tag
       methods must either be text or other XML::DOM::DocumentFragment objects.  No escape processing, syntax checking, or output control is done;
       this is all left up to XML::DOM.

SPECIAL TAGS

       All special tags are available by default with XML::Generator::DOM; you don't need to use 'conformance' => 'strict'.

   xmlpi(@args)
       Arguments will simply be concatenated and passed as the data to the XML::DOM::ProcessingInstruction object that is returned.

   xmlcmnt
       Escaping of '--' is done by XML::DOM::Comment, which replaces both hyphens with '&#45;'.  An XML::DOM::Comment object is returned.

   xmldecl
       Returns an XML::DOM::XMLDecl object.  Respects 'version', 'encoding' and 'dtd' settings in the object.

   xmldecl
       Returns an XML::DOM::DocumentType object.

   xmlcdata
       Returns an XML::DOM::CDATASection object.

   xml
       As described above, xml() can only be used when dom_document was not set in the object.	The automatically created document will have its
       XML Declaration set and the arguments to xml() will be appended to it.  Then a new DOM document is automatically generated and the old one
       is returned.  This is the only way to get a DOM document from this module.

perl v5.12.4							    2004-03-23								  DOM(3pm)

Check Out this Related Man Page

XML::DOM::ValParser(3)					User Contributed Perl Documentation				    XML::DOM::ValParser(3)

NAME

       XML::DOM::ValParser - an XML::DOM::Parser that validates at parse time

SYNOPSIS

	use XML::DOM::ValParser;

	my %expat_options = (KeepCDATA => 1,
			     Handlers => [ Unparsed => &my_Unparsed_handler ]);
	my $parser = new XML::DOM::ValParser (%expat_options);

	eval {
	    local $XML::Checker::FAIL = &my_fail;
	    my $doc = $parser->parsefile ("fail.xml");
	    ... XML::DOM::Document was created sucessfully ...
	};
	if ($@) {
	    # Either XML::Parser (expat) threw an exception or my_fail() died.
	    ... your error handling code here ...
	    # Note that the XML::DOM::Document is automatically disposed off and
	    # will be garbage collected
	}

	# Throws an exception (with die) when an error is encountered, this
	# will stop the parsing process.
	# Don't die if a warning or info message is encountered, just print a message.
	sub my_fail {
	    my $code = shift;
	    die XML::Checker::error_string ($code, @_) if $code < 200;
	    XML::Checker::print_error ($code, @_);
	}

DESCRIPTION

       Use XML::DOM::ValParser wherever you would use XML::DOM::Parser and your XML will be checked using XML::Checker at parse time.

       See XML::DOM for details on XML::DOM::Parser options.  See XML::Checker for details on setting the fail handler (my_fail.)

       The following handlers are currently supported, just like XML::DOM::Parser: Init, Final, Char, Start, End, Default, Doctype, CdataStart,
       CdataEnd, XMLDecl, Entity, Notation, Proc, Default, Comment, Attlist, Element, Unparsed.

XML
::DOM::ValParser
       XML::DOM::ValParser extends from XML::Checker::Parser. It creates an XML::Checker object and routes all event handlers through the checker,
       before processing the events to create the XML::DOM::Document.

       Just like XML::Checker::Parser, the checker object can be retrieved with the getChecker() method and can be reused later on (provided that
       the DOCTYPE section of the XML::DOM::Document did not change in the mean time.)

       You can control which errors are fatal (and therefore should stop creation of the XML::DOM::Document) by filtering the appropriate error
       codes in the global $XML::Checker::FAIL handler (see "ERROR_HANDLING" in XML::Checker) and calling die or croak appropriately.

       Just like XML::Checker::Parser, XML::DOM::ValParser supports the SkipExternalDTD and SkipInsignifWS options. See XML::Checker::Parser for
       details.

AUTHOR

       Send bug reports, hints, tips, suggestions to Enno Derksen at <enno@att.com>.

SEE ALSO

       XML::DOM, XML::Checker ("SEE_ALSO" in XML::Checker)

perl v5.8.0							    2000-01-31						    XML::DOM::ValParser(3)

Linux and UNIX Man Pages

xml::generator::dom(3pm) [debian man page]

Check Out this Related Man Page