XML::EasySQL::XMLobj 1.2

XML::EasySQL::XMLobj is a Fork of Robert Hansons killer XML::EasyOBJ module, which offers Easy XML object navigation.

SYNOPSIS

XML::EasySQL::XMLobj is a fork of Robert Hansons XML::EasyOBJ module. The goal of the fork was to simplify inheritance issues. However, easy inheritance comes at a cost: class method names can no longer be dynamically renamed. If inheritance isnt needed and you desire the dynamic method renaming feature, I suggest you download Hansons original XML::EasyOBJ module from CPAN.

NOTE: The rest of the documentation for this module was written by Robert Hanson
-Curtis Lee Fulton

# open exisiting file
my $doc = new XML::EasySQL::XMLobj({type => file, param => my_xml_document.xml});

# create object from XML string
my $doc = new XML::EasySQL::XMLobj({type => string, -param => $xml_source});

# create new file
my $doc = new XML::EasySQL::XMLobj({type => new, param => root_tag});

# read from document
my $text = $doc->root->some_element($index)->getString;
my $attr = $doc->root->some_element($index)->getAttr(foo);
my $element = $doc->root->some_element($index);
my @elements = $doc->root->some_element;

# first "some_element" element
my $elements = $doc->root->some_element;
# list of "some_element" elements
my @elements = $doc->root->some_element;

# write to document
$doc->root->an_element->setString(some string)
$doc->root->an_element->addString(some string)
$doc->root->an_element->setAttr(attrname, val)
$doc->root->an_element->setAttr(attr1 => val, attr2 => val2)

# access elements with non-name chars and the underlying DOM
my $element = $doc->root->getElement(foo-bar)->getElement(bar-none);
my $dom = $doc->root->foobar->getDomObj;

# get elements without specifying the element name
my @elements = $doc->root->getElement();
my $sixth_element = $doc->root->getElement(, 5);

# remove elements/attrs
$doc->root->remElement(tagname, $index);
$doc->root->tag_name->remAttr($attr);

I wrote XML::EasyOBJ a couple of years ago because it seemed to me that the DOM wasnt very "perlish" and the DOM is difficult for us mere mortals that dont use it on a regular basis. As I only need to process XML on an occasionally I wanted an easy way to do what I needed to do without having to refer back to DOM documentation each time.

A quick fact list about XML::EasySQL::XMLobj:

* Runs on top of XML::DOM
* Allows access to the DOM as needed
* Simple routines to reading and writing elements/attributes