NAME

Tibco::Rv::Event - Base class for Tibco events

SYNOPSIS

use base qw/ Tibco::Rv::Event /;

sub new
{
   # ...
   my ( $self ) =
      $proto->SUPER::new( queue => $queue, callback => $callback );
   # ...
}

DESCRIPTION

Base class for Tibco Events -- Listeners, Timers, and IO events. Don't use this directly.

CONSTRUCTOR

$self = $proto->SUPER::new( %args )
%args:
   queue => $queue,
   callback => sub { ... }

Creates a Tibco::Rv::Event, or more specifically, one of the Event subclasses -- Listener, Timer, or IO, with queue $queue (defaults to $Tibco::Rv::Queue::DEFAULT if not specified), and the given callback (defaults to sub { } if not specified).

METHODS

$queue = $event->queue

Returns the queue on which events will be dispatched.

$callback = $event->callback

Returns the callback code reference.

$event->onEvent
$event->onEvent( $msg )

Trigger an event directly. Subclasses determine which version will be called. Listener objects use the version with a $msg parameter, Timer and IO objects use the version with no paramters.

$event->DESTROY

Cancels interest in this event. Called automatically when $event goes out of scope. Calling DESTROY more than once has no effect.

SEE ALSO

Tibco::Rv::Listener
Tibco::Rv::Timer
Tibco::Rv::IO

AUTHOR

Paul Sturm <sturm@branewave.com>