NAME
MooseX::DOM - Simplistic Object XML Mapper
SYNOPSIS
package MyObject;
use Moose;
use MooseX::DOM;
has_dom_child 'title';
no Moose;
my $obj = MyObject->new(node => <<EOXML);
<feed>
<title>Foo</title>
</feed>
EOXML
print $obj->title(), "\n"; # Foo
$obj->title('Bar');
print $obj->title(), "\n"; # Bar
DESCRIPTION
This module is intended to be used in conjunction with other modules that encapsulate XML data (for example, XML feeds).
DECLARATION
has_dom_attr $name[, %opts]
Specifies that the object should contain an attribute by the given name
has_dom_child $name[, %opts]
Specifies that the object should contain a single child by the given name. Will generate accessor that can handle set/get
has_dom_child 'foo';
$obj->foo(); # get the value of child element foo
$obj->foo("bar"); # set the value of child element foo to bar
%opts may contain namespace
, tag
, and filter
Specifying namespace
forces MooseX::DOM to look for tags in a specific namespace uri.
Specifying tag
allows MooseX::DOM to look for the tag name given in tag
while making the generated method name as $name
The optional filter
should be a subroutine that takes the object itself as the first parameter, and the DOM node(s) as the rest of the parameters. You are allowed to transform the node as you like. By default, a filter that converts the node to its text content is used.
has_dom_children
Specifies that the object should contain possibly multiple children by the given name
has_dom_children 'foo';
$obj->foo(); # Returns a list of values for each child element foo
$obj->foo(qw(1 2 3)); # Discards old values of foo, and create new nodes
%opts may contain namespace
, tag
, and filter
Specifying namespace
forces MooseX::DOM to look for tags in a specific namespace uri.
Specifying tag
allows MooseX::DOM to look for the tag name given in tag
while making the generated method name as $name
The optional filter
should be a subroutine that takes the object itself as the first parameter, and the DOM node(s) as the rest of the parameters. You are allowed to transform the node as you like. By default, a filter that converts the node to its text content is used.
AUTHOR
Daisuke Maki <daisuke@endeworks.jp>
LICENSE
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
See http://www.perl.com/perl/misc/Artistic.html