NAME

XML::DOM2 - DOM controlled, strict XML module for extentable xml objects.

VERSION

Version 0.03, 12 July, 2006

DESCRIPTION

XML::DOM2 is yet _another_ perl XML module.

Features:

 * DOM Level2 Compilence in both document, elements and attributes
 * NameSpace control for elements and attributes
 * XPath (it's just one small method once you have a good DOM)
 * Extendability:
  * Document, Element or Attribute classes can be used as base class for other
    kinds of document, element or attribute.
  * Element and Attribute Handler allows element specific child elements and attribute objects.
  * Element and Attribute serialisation overiding.
 * Parsing with SAX (use XML::SAX::PurePerl for low dependancy installs)
 * Internal serialisation

METHODS

new

$xml = XML::DOM2->new( -file = [xmlfilename], -data = [xmldata], %options );

Create a new xml object, it will parse a file or data if required or will await creation of nodes.

parseDocument

Parse existing xml data into a document.

xmlify (alias: to_xml render, serialize, serialise)

$string = $xml->xmlify(%attributes);

Returns xml representation of xml document.

extention

$extention = $xml->extention;

Does not work, legacy option maybe enabled in later versions.

options

  namespace  - Default document name space
  name       - Document localName
  doctype    - Document Type object
  version    - XML Version
  encoding   - XML Encoding
  standalone - XML Standalone

INTERNAL METHODS

_serialise_doctype

$xml->_serialise_doctype( seperator => "\n" );

Returns the document type in an xml header form.

_serialise_extention

$xml->_serialise_extention( seperator => "\n" );

Returns the document extentions.

_serialise_header

$xml->_serialise_header( );

The XML header, with version, encoding and standalone options.

_element_handle

$xml->_element_handle( $type, %element-options );

Returns an XML element based on $type, use to extentd element capabilties.

_document_name

$xml->_document_name;

Returns the doctype name or 'xml' as default, can be extended.

_credit_comment

$xml->_credit_comment;

Returns the comment credit used in the output

AUTHOR

Martin Owens, doctormo@cpan.org

CREDITS

Based on SVG.pm by Ronan Oger, ronan@roasp.com

SEE ALSO

perl(1),XML::DOM2,XML::DOM2::Parser http://www.w3c.org/Graphics/SVG/ SVG at the W3C

cpanm XML::DOM2

perl -MCPAN -e shell
install XML::DOM2