An abstract base class for a singleton that keeps track of open sockets and their associated handlers. More...
#include <geventloop.h>
Public Member Functions | |
| virtual | ~EventLoop () |
| Destructor. More... | |
| virtual bool | init ()=0 |
| Initialises the object. More... | |
| virtual std::string | run ()=0 |
| Runs the main event loop. More... | |
| virtual bool | running () const =0 |
| Returns true if called from within run(). More... | |
| virtual void | quit (std::string reason)=0 |
| Causes run() to return (once the call stack has unwound). More... | |
| virtual void | addRead (Descriptor fd, EventHandler &handler)=0 |
| Adds the given event source descriptor and associated handler to the read list. More... | |
| virtual void | addWrite (Descriptor fd, EventHandler &handler)=0 |
| Adds the given event source descriptor and associated handler to the write list. More... | |
| virtual void | addException (Descriptor fd, EventHandler &handler)=0 |
| Adds the given event source descriptor and associated handler to the exception list. More... | |
| virtual void | dropRead (Descriptor fd)=0 |
| Removes the given event source descriptor from the list of read sources. More... | |
| virtual void | dropWrite (Descriptor fd)=0 |
| Removes the given event source descriptor from the list of write sources. More... | |
| virtual void | dropException (Descriptor fd)=0 |
| Removes the given event source descriptor from the list of exception sources. More... | |
| virtual void | setTimeout (G::DateTime::EpochTime t, bool &empty_implementation_hint)=0 |
| Used by GNet::TimerList. More... | |
Static Public Member Functions | |
| static EventLoop * | create () |
| A factory method which creates an instance of a derived class on the heap. More... | |
| static EventLoop & | instance () |
| Returns a reference to an instance of the class, if any. More... | |
| static bool | exists () |
| Returns true if an instance exists. More... | |
Protected Member Functions | |
| EventLoop () | |
| Constructor. More... | |
Detailed Description
An abstract base class for a singleton that keeps track of open sockets and their associated handlers.
Derived classes are used to implement different event loops, such as select() or WinSock.
In practice sockets are added and removed from the class by calling GNet::Socket::addReadHandler() etc rather than EventLoop::addRead(). This is to improve the encapsulation of the GNet::Descriptor data type within Socket.
The class has a static member for finding an instance, but instances are not created automatically.
Definition at line 51 of file geventloop.h.
Constructor & Destructor Documentation
|
protected |
|
virtual |
Destructor.
Definition at line 37 of file geventloop.cpp.
Member Function Documentation
|
pure virtual |
Adds the given event source descriptor and associated handler to the exception list.
See also Socket::addExceptionHandler().
Implemented in GNet::Select.
Referenced by GNet::Socket::addExceptionHandler().
|
pure virtual |
Adds the given event source descriptor and associated handler to the read list.
See also Socket::addReadHandler().
Implemented in GNet::Select.
Referenced by GNet::Socket::addReadHandler().
|
pure virtual |
Adds the given event source descriptor and associated handler to the write list.
See also Socket::addWriteHandler().
Implemented in GNet::Select.
Referenced by GNet::Socket::addWriteHandler().
|
static |
A factory method which creates an instance of a derived class on the heap.
Definition at line 204 of file geventloop_unix.cpp.
|
pure virtual |
Removes the given event source descriptor from the list of exception sources.
See also Socket::dropExceptionHandler().
Implemented in GNet::Select.
Referenced by GNet::Socket::dropExceptionHandler().
|
pure virtual |
Removes the given event source descriptor from the list of read sources.
See also Socket::dropReadHandler().
Implemented in GNet::Select.
Referenced by GNet::Socket::dropReadHandler().
|
pure virtual |
Removes the given event source descriptor from the list of write sources.
See also Socket::dropWriteHandler().
Implemented in GNet::Select.
Referenced by GNet::Socket::dropWriteHandler().
|
static |
Returns true if an instance exists.
Definition at line 51 of file geventloop.cpp.
Referenced by GNet::AbstractTimer::AbstractTimer(), GSmtp::AdminServerPeer::onReceive(), and GNet::TimerList::update().
|
pure virtual |
Initialises the object.
Implemented in GNet::Select.
|
static |
Returns a reference to an instance of the class, if any.
Asserts if none. Does not do any instantiation itself. Precondition: exists()
Definition at line 43 of file geventloop.cpp.
References G_ASSERT.
Referenced by GNet::Socket::addExceptionHandler(), GNet::Socket::addReadHandler(), GNet::Socket::addWriteHandler(), GNet::Socket::dropExceptionHandler(), GNet::Socket::dropReadHandler(), GNet::Socket::dropWriteHandler(), GSmtp::AdminServerPeer::onReceive(), and GNet::TimerList::update().
|
pure virtual |
Causes run() to return (once the call stack has unwound).
If there are multiple quit()s before run() returns then the latest reason is used.
Implemented in GNet::Select.
Referenced by GSmtp::AdminServerPeer::onReceive().
|
pure virtual |
|
pure virtual |
Returns true if called from within run().
Implemented in GNet::Select.
|
pure virtual |
Used by GNet::TimerList.
Sets the time at which TimerList::doTimeouts() is to be called. A parameter of zero is used to cancel the timer.
Some concrete implementations of this interface may use TimerList::interval() rather than setTimeout()/doTimeouts(). Empty implementations should set the hint value to true as an optimisation.
Referenced by GNet::TimerList::update().
The documentation for this class was generated from the following files:
