NAME

Padre::Role::PubSub - A simple event publish/subscriber role

DESCRIPTION

This class allows the addition of simple publish/subscribe behaviour to an arbitrary class.

METHODS

subscribe

            

              
              
$publisher->subscriber( $object, {
    my_event_one => 'my_handler_method',
    my_event_two => 'my_handler_method',
} );
            
          

The <subscriber> method lets you register an object for callbacks to a particular set of method for various named events.

Returns true, or throws an exception if any of the parameters are invalid.

unsubscribe

            

              
              
$publisher->unsubscribe($subscriber);
            
          

The unsubscribe method removes all event registrations for a particular object.

Returns true.

publish

            

              
              
$publisher->publish("my_event_one", "param1", "param2");
            
          

The publish method is called on the published to emit a particular named event.

It calls any registered event handlers in sequence, ignoring exceptions.

Returns true, or throws an exception if the event name is invalid.

COPYRIGHT & LICENSE

Copyright 2008-2016 The Padre development team as listed in Padre.pm.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.