Jifty::Handle(3pm)					User Contributed Perl Documentation					Jifty::Handle(3pm)

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.

perl v5.14.2							    2011-01-24							Jifty::Handle(3pm)