NAME

Bio::MAGETAB::Util::Persistence - A Tangram-based object persistence class for MAGE-TAB.

SYNOPSIS

 use Bio::MAGETAB::Util::Persistence;
 my $db = Bio::MAGETAB::Util::Persistence->new({
    dbparams       => [ "dbi:mysql:$dbname", $user, $pass ],
 });

 $db->deploy();
 $db->connect();
 $db->insert( $magetab_object );

DESCRIPTION

This class provides an object persistence mechanism for storing MAGE-TAB objects in a relational database. The class is, in effect, just a thin wrapper around a Tangram::Storage instance which implements most of the database interaction methods. The class has been used successfully with both MySQL and SQLite database backends, and should in theory be usable with any database engine supported by the Tangram modules.

ATTRIBUTES

dbparams: A reference to an array containing database connection parameters. This array is passed directly to "DBI->connect()".
config: The Tangram schema definition used to create the database. This attribute is read-only.
store: The underlying Tangram::Storage object used for most of the interaction with the database.

METHODS

deploy: Connect to the database and deploy the schema. This only needs to be done once to set up the database.
connect: Connect to the database. This must be done before using any of the following methods.
get_schema: Returns the Tangram::Schema object created using the config attribute.
class_config: A class method which returns the config hash reference used to create the Tangram::Schema object.
insert
select
update
erase
id
count
sum
cursor
remote: All these methods are delegated directly to the Tangram::Storage object created by the "connect" method, and contained within the Persistence object. Please see the Tangram documentation for more information on these methods.

AUTHOR

Tim F. Rayner <tfrayner@gmail.com>

LICENSE

This library is released under version 2 of the GNU General Public License (GPL).