NAME

Oryx::DBM - DBM Storage interface for Oryx

SYNOPSIS

 my $storage = Oryx::DBM->new;
 
 $storage->connect([ 'dbm:Deep:datapath=/path/to/datafiles' ]);
  
 $storage->dbh;
 $storage->db_name;
 $storage->ping;
 $storage->schema;
 $storage->util;
 $storage->set_util;
 $storage->deploy_class;
 $storage->deploy_schema;

DESCRIPTION

DBM Storage interface for Oryx. You should not need to instantiate this directly, use Oryx->connect() instead.

METHODS

new

Simple constructor

dbh

stub - returns $self

connect( \@conn, [$schema] )

Called by Oryx->connect(). You shouldn't need to be doing this.

catalog

DBM::Deep instance for holding the catalog of tables. This is a sort of global internal store for the DBM backend for keeping meta data which it needs.

ping

ping the database - all this does here is make sure the catalog exists and is a DBM::Deep instance

schema

returns the schema if called with no arguments, otherwise sets if called with a Oryx::Schema instance.

schema

returns the schema if called with no arguments, otherwise sets if called with a Oryx::Schema instance.

set_util

determines which Oryx::DBI::Util class to instantiate by looking at the dsn passed to connect and sets it

deploy_schema( $schema )

Takes a Oryx::Schema instance and deploys all classes seen by that schema instance to the database creating all DBM::Deep db files needed for storing your persistent objects.

deploy_class( $class )

does the work of deploying a given class; called by deploy_schema

SEE ALSO

Oryx, Oryx::Class, Oryx::DBM::Util

AUTHOR

Copyright (C) 2005 Richard Hundt <richard NO SPAM AT protea-systems.com>

LICENSE

This library is free software and may be used under the same terms as Perl itself.