NAME

Directory::Queue::Null - object oriented interface to a null directory based queue

SYNOPSIS

  use Directory::Queue::Null;
  $dirq = Directory::Queue::Null->new();
  foreach $count (1 .. 100) {
      $name = $dirq->add(... some data ...);
  }

DESCRIPTION

The goal of this module is to offer a "null" queue system using the same API as the other directory queue implementations. The queue will behave like a black hole: added data will disappear immediately so the queue will therefore always appear empty.

This can be used for testing purposes or to discard data like one would do on Unix by redirecting output to "/dev/null".

Please refer to Directory::Queue for general information about directory queues.

CONSTRUCTOR

The new() method can be used to create a Directory::Queue::Null object that will later be used to interact with the queue. No attributes are supported.

METHODS

The following methods are available:

new(): return a new Directory::Queue::Null object (class method)
copy(): return a copy of the object
path(): return the queue toplevel path, that is "NULL"
id(): return a unique identifier for the queue, that is "NULL"
count(): return the number of elements in the queue, so always 0
first(): return the first element in the queue, so always an empty string
next(): return the next element in the queue, so always an empty string
add(DATA): add the given data (it can be anything) to the queue, this does nothing
add_ref(REF): add the given data reference to the queue, this does nothing
add_path(PATH): add the given file (identified by its path) to the queue, this will therefore remove the file
purge(): purge the queue, this does nothing

The following methods are available to provide the same API as the other directory queue modules but they will always return an error as they cannot be legitimately called since the queue is always empty:

lock(ELEMENT)
unlock(ELEMENT)
touch(ELEMENT)
remove(ELEMENT)
get(ELEMENT)
get_ref(ELEMENT)
get_path(ELEMENT)

DIRECTORY STRUCTURE

This module does not store any file.

AUTHOR

Lionel Cons <http://cern.ch/lionel.cons>