NAME
SOAP::Data::Builder::Entity - A simple wrapper SOAP::Data
DESCRIPTION
This Module provides a quick and easy way to build complex SOAP data
and header structures for use with SOAP::Lite, managed by SOAP::Data::Builder.
METHODS
new(autotype=>0)
Constructor method for this class, it instantiates and returns the entity object, taking value and attributes as named parameters
my $entity = SOAP::Data::Builder::Entity->new( name=> 'anExample', VALUE=> 'foo', attributes => { 'ns1:foo' => 'bar'});
optional parameters are : value, attributes, header, isMethod
parent should be an element fetched using get_elem
value should be a string, to add child nodes use add_elem(parent=>get_elem('name/of/parent'), .. )
attributes should be a hashref : { 'ns:foo'=> bar, .. }
header should be 1 or 0 specifying whether the element should be built using SOAP::Data or SOAP::Header
value()
the value() method sets/gets the VALUE of the element
name()
the name() method gets/sets the name of the element
fullname()
the fullname() method returns the full '/' delimited name of the element
'eb:foo/eb:name' would return the inner element on <eb:foo><eb:name ..> .. </eb:name></eb:foo>
attributes()
returns a hashref of the elements attributes
remove_attribute($name)
removes a named attribute - returns 1 if it existed , 0 if not
set_attribute($name,$value)
sets a named attribute
get_attribute($name)
gets a named attribute
add_elem($elem)
This method adds an element as a child to another element.
Accepts either a SOAP::Data::Builder::Element object or a hash of arguments to create the object
Returns the added element
my $child = $parent->add_elem(name=>'foo',..);
or
$parent->add_elem($child);
get_children()
returns a list of the child nodes of an element
remove_elem($name)
removes the named node from the element, returns 1 if existed, 0 if not
get_as_data()
returns the element and its sub-nodes in SOAP::Data objects.