.

Harvest::Controller::Bucket - maintain collections of URLs

DESCRIPTION

The Bucket class is used to maintain lists of URLs, together with other management data, by the Harvest::Controller::Workload class.

METHODS

$bucket = new Harvest::Controller::Bucket ("mybucket");

Create a new bucket, with the given name. The name parameter is currently unused, but will eventually be used to create a tied file which will contain all of the stored URLs.

$bucket->push($obj)

Add a new URL to the list of URLs in this bucket. $obj should be a Harvest::Object - the bucket class may collapse this object into a string representation of just the header section.

$obj=$bucket->pop;

Return the first Harvest::Object from the list of URLs

$bucket->empty;

Returns TRUE if there are no URLs remaining in the bucket

$bucket->status([$arg])

Returns the current status of the bucket, and if $arg is set, updates the new status. It is up to the calling class to define the type and meaning of 'status'

$bucket->time([$arg])

Returns the last time that the bucket was accessed, and if $arg is set, updates the time with the contents of $arg

$bucket->delay([$arg])

Returns the current time to wait between actions on this bucket, and if $arg is set, updates the time with the contents of $arg