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-2013 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.