NAME

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

VERSION

Version 0.04 - 2007-11-19

SYNOPSIS

  my $xml = XML::DOM2->new( file => 'filename.xml' );
  my $xml = XML::DOM2->new( data => '<xml>data</xml>' );
  my $xml = XML::DOM2->new( fh   => $file_handle );

  $xml->getChildren();

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

$class->new( file|data|fh )

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

$object->parseDocument( %p )

  Parse existing xml data into a document, inputs taken from ->new;

$object->xmlify( %options )

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

  Returns xml representation of xml document.

$object->extention()

  $extention = $xml->extention();

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

OPTIONS

$object->namespace( $set )

  Default document name space

$object->name( $set )

  Document localName

$object->doctype()

  Document Type object

$object->version()

  XML Version

$object->encoding()

  XML Encoding

$object->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.

$object->_option( $name[, $data] )

  Set or get the required option.

$object->_can_contain_element()

  Does this node support element children.

$object->_document_name()

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

$object->_credit_comment()

  Returns the comment credit used in the output

COPYRIGHT

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

cpanm XML::DOM2

perl -MCPAN -e shell
install XML::DOM2