NAME Fey::DBIManager - Manage a set of DBI handles SYNOPSIS my $manager = Fey::DBIManager->new(); $manager->add_source( dbh => $dbh ); 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, BUGS Please report any bugs or feature requests to "bug-fey-dbimanager@rt.cpan.org", or through the web interface at . 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.