NAME

Mail::Spool::Handle - Mail Spool directory encapsulization

SYNOPSIS

  #!/usr/bin/perl -w
  package MySpoolHandle;
  use Mail::Spool::Handle;
  @ISA = qw(Mail::Spool::Handle);
  # OR
  sub new {
    my $self = __PACKAGE__->SUPER::new(@_);
    ### do my own stuff here
    return $self;
  }

DESCRIPTION

Mail::Spool::Handle is intended as an encapsulization of a directory for use by Mail::Spool. It has been written with the intent of being able to use a database or other "file" system as a backend.

PROPERTIES

Properties of Mail::Spool::Handle are accessed methods of the same name. They may be set by calling the method and passing the new value as an argument. For example:

  my $spool_dir = $self->spool_dir;
  $self->spool_dir($new_spool_dir);

The following properties are available:

spool_dir: Path to the directory of this spool.
fallback_dir: Path to the directory of the fallback spool, used if a node could could not be delivered. If undef, it is assumed that that message is undeliverable.
wait: Number of seconds which a node must be present in the spool before it can be sent.
dh: An open directory handle to spool_dir.
spool: Return the spool that created this msh object.

METHODS

new: Returns a Mail::Spool::Handle object. Arguments in the form of a hash or hash ref are used to populate the object.
open_spool: Opens a directory handle on spool_dir and stores the result in dh.
next_node: Essentially does a readdir on the dh property. Returns a Mail::Spool::Node object. Once there are no more nodes, it returns undef.
mail_spool_node: Calls &Mail::Spool::mail_spool_node by default. Returns a Mail::Spool::Node.

COPYRIGHT