Eventloop module is the foundation of other modules that run their code asynchronously inside event loops and threads.
It provides efficient management of asynchronous operations without multithreading overhead. Particularly useful for building
client-server applications with high-performance requirements.
Eventloop utilizes Java’s NIO to allow asynchronous computations and I/O operations (TCP, UDP).
Eliminates traditional bottleneck of I/O for further business logic processing.
Can run multiple eventloop threads on available cores.
Minimal GC load: arrays and byte buffers are reused.
Eventloop can schedule/delay certain tasks for later execution or background execution.
Eventloop is single-threaded, so it doesn’t have concurrency overhead.
Eventloop is a low-level tool that you won't use directly in most use-cases. Yet, it is an
extremely important component which will give you an understanding of workings of
DataKernel async model.
represents an infinite loop, where each loop executes all the tasks that are provided by Selector or stored in
special queues. Each of these tasks should be small and its execution is called tick.
The only blocking operation of Eventloop infinite loop is Selector.select(). This operation selects a set of keys
whose corresponding channels are ready for I/O operations. With these keys and queues with tasks, eventloop asynchronously
executes them in one thread in the overridden method run() (Eventloop is an implementation of Runnable).
Eventloop works with different types of tasks that are stored in separate queues:
Tasks which were added from current Eventloop thread
Tasks which were added from other threads
Tasks which are scheduled to be executed later
Same as Scheduled, but if there are only Background tasks left, Eventloop will be closed
Execution of an eventloop will be ended when its queues with non-background tasks are empty, Selector has no selected
keys and the amount of concurrent operations in other threads equals 0. To prevent Eventloop closing in such cases, you
should use keepAlive flag (when set true, Eventloop will continue running even without tasks).
You can add Eventloop module to your project by inserting dependency in pom.xml:
BasicExample - a simple example of an eventloop which prints out a “Hello World” message.
EventloopExample - represents the sequence of operations execution in eventloops.
To run the examples, you need to clone DataKernel from GitHub:
$ git clone https://github.com/softindex/datakernel And import it as a Maven project. Check out branch v3.1. Before running the examples, build the project.
These examples are located at datakernel -> examples -> core -> eventloop.
In this example we create an eventloop, post a task to it (which is printing out “Hello World” message) and
then start the eventloop:
This example represents how tasks are scheduled in eventloops:
If you run the example, you’ll receive an output which looks something like this:
So, the tasks will be executed in the following order:
Not in eventloop... will be executed even before the eventloop is started.
Thread.sleep(2000)... as we posted it to the beginning of eventloop’s localTasks.
Immediately after that - Eventloop.delay(100)... and Eventloop.delay(1000)... as they are already expired.
And finally eventloop.delay(3000) will be executed right at its time.