NAME

Jifty::Handle -- A database handle class for Jifty

DESCRIPTION

A wrapper around Jifty::DBI::Handle which is aware of versions in the database

METHODS

new PARAMHASH

This class method instantiates a new Jifty::Handle object. This object deals with database handles for the system. After it is created, it will be a subclass of Jifty::DBI::Handle.

canonical_database_name

Returns the canonical name of the application's database (the actual name that will be given to the database driver). This name is a lower-case version of the Database argument in the Database section of the framework config.

For SQLite databases (where the database name is actually a filename), this also converts a relative path into an absolute path based at the application root.

connect ARGS

Like Jifty::DBI's connect method but pulls the name of the database from the current Jifty::Config.

check_schema_version [pretend => 0|1]

Make sure that we have a recent enough database schema. If we don't, then error out.

If pretend = 1> is passed, then any auto-upgrade action this might take is dry-run only.

create_database MODE

MODE is either "print" or "execute".

This method either prints the commands necessary to create the database or actually creates it, depending on the value of MODE. Returns undef on failure.

drop_database MODE

MODE is either "print" or "execute".

This method either prints the commands necessary to drop the database or actually drops it, depending on the value of MODE. Returns undef on failure.

AUTHOR

Various folks at BestPractical Solutions, LLC.