NAME

AxKit::App::TABOO::Data::Plurals - Base class to handle multiple Data objects in TABOO

DESCRIPTION

Sometimes, it is desireable to retrieve and handle multiple instances of a data object, and most economic to do it in a single operation. That is what the Plural data objects are for. The load methods should generally retrieve all records as efficiently as they can, and then return an array of their singular counterparts.

This is a conceptual advancement in TABOO, and the main new thing in the 0.05 release.

METHODS

It implements a single new method, with a name that should ring bells for everyone. It also reimplements some methods, but nothing you really need to be aware of. If you want to raise your awareness anyway, the documentation of them is for you:

Push($singular)

This does pretty much what push does in a normal context, it adds a singular version $singular of a object to the plural object that the method is used on.

_load(\%arg)

As the underscore implies this is for internal use only! It can do the hard work for subclasses of this class. It takes a hashref where the keys are data storage names and the values are corresponding values to retrieve. These will be combined by logical AND. It will return an arrayref containing the data from the storage.

write_xml($doc, $parent)

To avoid bloating the parent class too much, this takes care of some specifics for plurals, but leaves most of the job to the parent class. Has a completely identical interface as the parent class, and can be called like it without further ado.

If an object of this class has had its element and/or namespace set with xmlelement()/xmlns() respectively, the individual entries will have the same element and/or namespace.

BUGS/TODO

The save method is not yet reimplemented and may not work.

FORMALITIES

See AxKit::App::TABOO.