---
name: "Jifty::Handle"
section: "3pm"
platform: "linux"
package: "libjifty-perl"
version: "1.10518+dfsg-2"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/Jifty::Handle"
---

# 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.