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

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

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.

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.

AUTHOR

Various folks at BestPractical Solutions, LLC.