Event::RPC::Loop - Mainloop Abstraction layer for Event::RPC
my $server = Event::RPC::Server->new (
loop => Event::RPC::Loop::Glib->new(),
This modules defines the interface of Event::RPC's mainloop abstraction layer.
It's a virtual class all mainloop modules should inherit from.
The following methods need to be implemented:
- $loop->enter ()
- Enter resp. start a mainloop.
- $loop->leave ()
- Leave the mainloop, which was started with the enter() method.
- $watcher = $loop->add_io_watcher ( %options )
- Add an I/O watcher. Options are passed as a hash of key/value pairs. The
following options are known:
- The filehandle to be watched.
- This callback is called, without any parameters, if an event occured on
the filehandle above.
- A description of the watcher. Not necessarily implemented by all modules,
so it may be ignored.
- Either 'r', if your program reads from the filehandle, or 'w' if it writes
A watcher object is returned. What this exactly is depends on the
implementation, so you can't do anything useful with it besides passing it
back to del_io_watcher()
- $loop->del_io_watcher ( $watcher )
- Deletes an I/O watcher which was added with
- $timer = $loop->add_timer ( %options )
- This sets a timer, a subroutine called after a specific timeout or on a
regularly basis with a fixed time interval.
Options are passed as a hash of key/value pairs. The following options are
- A time interval in seconds, may be fractional.
- Callback is called once after this amount of seconds, may be
- The callback.
- A description of the timer. Not necessarily implemented by all modules, so
it may be ignored.
A timer object is returned. What this exactly is depends on the implementation,
so you can't do anything useful with it besides passing it back to
- $loop->del_timer ( $timer )
- Deletes a timer which was added with $loop->add_timer().
You may use the methods of Event::RPC::Loop by yourself if you like. This way
your program keeps independent of the actual mainloop module in use, if the
simplified interface of Event::RPC::Loop is sufficient for you.
In your server program you access the actual mainloop object this way:
my $loop = Event::RPC::Server->instance->get_loop;
Naturally nothing speaks against making your program to work only with a
specific mainloop implementation, if you need its features. In that case you
may use the corresponding API directly (e.g. of Event or Glib), no need to
access it through Event::RPC::Loop.
Jörn Reder <joern at zyn dot de>
Copyright (C) 2002-2006 by Joern Reder, All Rights Reserved.
This library is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.
Hey! The above document had some coding errors, which are explained
- Around line 155:
- Non-ASCII character seen before =encoding in 'Jörn'. Assuming