POE::Stage::Ticker - a periodic message generator for POE::Stage
sub some_handler :Handler { my $req_ticker = POE::Stage::Ticker->new(); my $req_ticker_request = POE::Request->new( stage => $req_ticker, method => "start_ticking", on_tick => "handle_tick", # Invoke my handle_tick() method args => { interval => 10, # every 10 seconds. }, ); } sub handle_tick { my $arg_id; print "Handled tick number $arg_id in a series.\n"; }
POE::Stage::Ticker emits recurring messages at a fixed interval.
Used to request the Ticker to start ticking. The Ticker will emit a "tick" message every "interval" seconds.
Responses are returned by POE::Request->return() or emit().
Once start_ticking() has been invoked, POE::Stage::Ticker emits a "tick" event. The "id" parameter is the ticker's unique ID, so that ticks from multiple tickers are not confused.
See http://thirdlobe.com/projects/poe-stage/report/1 for known issues. See http://thirdlobe.com/projects/poe-stage/newticket to report one.
POE::Stage is too young for production use. For example, its syntax is still changing. You probably know what you don't like, or what you need that isn't included, so consider fixing or adding that, or at least discussing it with the people on POE's mailing list or IRC channel. Your feedback and contributions will bring POE::Stage closer to usability. We appreciate it.
POE::Stage and POE::Request. The examples/many-responses.perl program in POE::Stage's distribution.
Rocco Caputo <rcaputo@cpan.org>.
POE::Stage::Ticker is Copyright 2005-2006 by Rocco Caputo. All rights are reserved. You may use, modify, and/or distribute this module under the same terms as Perl itself.
To install POE::Stage, copy and paste the appropriate command in to your terminal.
cpanm
cpanm POE::Stage
CPAN shell
perl -MCPAN -e shell install POE::Stage
For more information on module installation, please visit the detailed CPAN module installation guide.