Bio::Genex::Software 2.6.0

Bio::Genex::Software is Perl module with methods for processing data from the GeneX DB table: Software.

SYNOPSIS

use Bio::Genex::Software;

# instantiating an instance
my $Software = Bio::Genex::Software->new(id=>47);

# retrieve data from the DB for all columns
$Software->fetch();

# creating an instance, without pre-fetching all columns
my $Software = new Bio::Genex::Software(id=>47);

# creating an instance with pre-fetched data
my $Software = new Bio::Genex::Software(id=>47, fetch_all=>1);

# retrieving multiple instances via primary keys
my @objects = Bio::Genex::Software->get_objects(23,57,98)


# retrieving all instances from a table
my @objects = Bio::Genex::Software->get_all_objects();

# retrieving the primary key for an object, generically
my $primary_key = $Software->id();

# or specifically
my $sw_pk_val = $Software->sw_pk();

# retreving other DB column attributes
my $name_val = $Software->name();
$Software->name($value);

my $version_val = $Software->version();
$Software->version($value);

my $type_val = $Software->type();
$Software->type($value);

my $con_fk_val = $Software->con_fk();
$Software->con_fk($value);

Each Genex class has a one to one correspondence with a GeneX DB table of the same name (i.e. the corresponding table for Bio::Genex::Software is Software).
Most applications will first create an instance of Bio::Genex::Software and then fetch the data for the object from the DB by invoking fetch().

However, in cases where you may only be accessing a single value from an object the built-in delayed fetch mechanism can be used. All objects are created without pre-fetching any data from the DB. Whenever an attribute of the object is accessed via a getter method, the data for that attribute will be fetched from the DB if it has not already been. Delayed fetching happens transparently without the user needing to enable or disable any features.

Since data is not be fetched from the DB until it is accessed by the calling application, it could presumably save a lot of access time for large complicated objects when only a few attribute values are needed.