NAME

Konstrukt::Event - Event management

SYNOPSIS

        #Register for an event:
        #register an object method:
        $Konstrukt::Event->register("eventname", $object, \&sub_reference);
        #note that duplicate entries will be ignored
        
        #deregister from an event:
        #only deregister this method from the specified event:
        $Konstrukt::Event->deregister("eventname", $object, \&sub_reference);
        #deregister all registered method for a specified object:
        $Konstrukt::Event->deregister_all_by_object("eventname", $object);
        
        #fire an event:
        #the optional arguments will be passed to the registered methods
        $Konstrukt::Event->trigger("eventname"[, arg1[, arg2[, ...]]]);

DESCRIPTION

This module provides event handling within the Konstrukt framework. You may register object methods for events and you may also fire events, on which the registered methods are called. This will help synchonizing some parts/plugins of the framework without glueing them together too tightly.

For a detailed description of the usage of this module see "SYNOPSIS"

METHODS

new

Constructor of this class

init

Initialization of this class

register

Registers an object method for a specified event

Parameters:

  • $eventname - The name of the event.

  • $objectref - Reference to the object, whose method should be called

  • $methodref - Reference to the method, which should be called

deregister

Deregisters an object method for a specified event

Parameters:

  • $eventname - The name of the event.

  • $objectref - Reference to the object, whose method should be deregistered

  • $methodref - Reference to the method, which should be deregistered

deregister_all_by_object

Deregisters all registered methods of an object from a specified event

Parameters:

  • $eventname - The name of the event.

  • $objectref - Reference to the object, whose method should be deregistered

trigger

Triggers an event with the specified name and the passed arguments.

Parameters:

  • $eventname - The name of the event.

  • ($arg1, $arg2, ...) - Optional: Arguments that should be passed to the methods

AUTHOR

Copyright 2006 Thomas Wittek (mail at gedankenkonstrukt dot de). All rights reserved.

This document is free software. It is distributed under the same terms as Perl itself.

SEE ALSO

Konstrukt