Myco 0.01

Myco is a Perl module that contains the myco object framework.

SYNOPSIS

use Myco;

### DB connection
Myco->db_connect(@dbconn);
Myco->db_disconnect(@dbconn);

$storage = Myco->storage; # Tangram connection object

### Object retrieval
$obj = Myco->load($id); # retrieval by Tangram object id

# Retrieve all of given class
@objects = Myco->select(Myco::Foo);

# Retrieve all of given class, using remote object and filtering
$remote = Myco->remote(Myco::Foo);
@objects = Myco->select($remote, $filter);

# Retrieve all of given class, by cursor
$cursor = Myco->select(Myco::Foo);
while (my $obj = $cursor->current()) {
# process $obj
$cursor->next();
}

### Object insertion and update
# Myco::Base::Entity alternative
Myco->insert($obj); # $obj->save;
Myco->update($obj); # $obj->save;
Myco->update(@objects);

### Object removal - from db and memory
Myco->destroy($obj); # $obj->destroy;
Myco->destroy(@objects);

### Object removal - from just db
Myco->erase(@objects);
See Tangram::Storage for other miscellany.

Encapsulates functionality of Tangram::Storage but treats the storage connection object as class data, allowing access to object persistence functionality via class method calls.

Intended for use with so-called myco "entity" objects, that is those belonging to classes that inherit from Myco::Base::Entity. Use of inherited instance methods for managing object persistence state where possible is preferred. (ie. use $obj->save instead of both Myco->insert($obj) and Myco->update($obj).)

Pulls in all other required classes of entire Myco class system.