NAME
Fey::DBIManager - Manage a set of DBI handles
SYNOPSIS
my $manager = Fey::DBIManager->new();
$manager->add_source( dsn => 'dbi:Pg:dbname=MyDB' );
my $source = $manager->default_source();
my $source = $manager->source_for_sql($select_sql);DESCRIPTION
Fey::DBIManager manager a set of Fey::DBIManager::Source objects, each of which in turn represents a single DBI handle.
It's main purpose is to provide a single interface to one or more data sources, allowing you to easily define your database connections in one spot.
METHODS
This class provides the following methods:
Fey::DBIManager->new()
Returns a new Fey::DBIManager object.
$manager->add_source(...)
This method adds a new Fey::DBIManager::Source object to the manager. It can either accept an instantiated Fey::DBIManager::Source object, or a set of parameters needed to create a new source.
Sources are identified by name, and if you try to add one that already exists in the manager, an error will be thrown.
$manager->get_source($name)
Given a source name, this returns the named source, if it exists in the manager.
$manager->remove_source($name)
Removes the named source, if it exists in the manager.
$manager->has_source($name)
Returns true if the manager has the named source.
$manager->sources()
Returns all of the source in the manager.
$manager->default_source()
This method returns the default source for the manager. If the manager has only one source, then this is the default. Otherwise it looks for a source named "default". If no such source exists, or if the manager has no sources at all, then an exception is thrown.
$manager->source_for_sql($sql_object)
This method accepts a single Fey::SQL object and returns an appropriate source.
By default, this method simply returns the default source. It exists to provide a spot for subclasses which want to do something more clever, such as use one source for reads and another for writes.
AUTHOR
Dave Rolsky, <autarch@urth.org>
BUGS
Please report any bugs or feature requests to bug-fey-dbimanager@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
COPYRIGHT & LICENSE
Copyright 2006-2008 Dave Rolsky, All Rights Reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.