NAME

Bio::DB::Failover - A Bio::DB::RandomAccessI compliant class which wraps a priority list of DBs

SYNOPSIS

$failover = Bio::DB::Failover->new();

$failover->add_database($db);

# fail over Bio::DB::RandomAccessI.pm

# this will check each database in priority, returning when
# the first one succeeds

$seq = $failover->get_Seq_by_id($id);

DESCRIPTION

This module provides fail over access to a set of Bio::DB::RandomAccessI objects

CONTACT

Ewan Birney originally wrote this class.

Reporting Bugs

Report bugs to the Bioperl bug tracking system to help us keep track the bugs and their resolution. Bug reports can be submitted via email or the web:

bioperl-bugs@bio.perl.org                   
http://bugzilla.bioperl.org/           

APPENDIX

The rest of the documentation details each of the object methods. Internal methods are usually preceded with a _

add_database

Title   : add_database
Usage   : add_database(%db)
Function: Adds a database to the 
Returns : count of number of databases
Args    : hash of db resource name to Bio::DB::SeqI object

get_Seq_by_id

Title   : get_Seq_by_id
Usage   : $seq = $db->get_Seq_by_id('ROA1_HUMAN')
Function: Gets a Bio::Seq object by its name
Returns : a Bio::Seq object
Args    : the id (as a string) of a sequence
Throws  : "id does not exist" exception

get_Seq_by_acc

Title   : get_Seq_by_acc
Usage   : $seq = $db->get_Seq_by_acc('X77802');
Function: Gets a Bio::Seq object by accession number
Returns : A Bio::Seq object
Args    : accession number (as a string)
Throws  : "acc does not exist" exception