README.md

This commit is contained in:
Tony Garnock-Jones 2021-05-10 11:13:23 +02:00
parent 864f371034
commit 981b77756d
1 changed files with 41 additions and 0 deletions

41
README.md Normal file
View File

@ -0,0 +1,41 @@
# A surprisingly fast Actor library for Java
As part of my research work on
[Syndicate](https://syndicate-lang.org), in 2020 I built this simple
Actor library in and for Java.
It's a hybrid of Erlang-style and E-style Actor models: Erlang-style
in that it includes monitors and links, and E-style in that it peers
denote targets for messages via references to individual *objects*
with an actor. Actors are thus similar to E's *vats*.
So far, I've limited myself to implementing a straightforward Actor
system, not including Dataspace or Syndicate primitives.
It's quite interesting all by itself, though: it's *very* fast and
able to use all the cores in a machine very effectively. For example:
$ java ... ...example2.Main 1000000 200
2021-05-10 11:02:35.087 INFO Actor(1) Available processors: 48
2021-05-10 11:02:38.573 INFO Actor(1) Start
2021-05-10 11:02:44.161 INFO Actor(1) Stop after 200000000 messages; 4.8 seconds, 41999160.0 Hz
That little benchmark has one million actors, each sending 200
messages to its neighbour in a ring, on my AMD 48-core machine. The
whole workload, 200 million messages, is delivered in under 5 seconds;
or, about 40 million messages per second. I was surprised that such a
simple system was able to perform so well.
Here's that same benchmark run on a single core:
$ taskset -c 0 java ... ...example2.Main 1000000 200
2021-05-10 11:07:42.104 INFO Actor(1) Available processors: 1
2021-05-10 11:07:47.826 INFO Actor(1) Start
2021-05-10 11:08:52.078 INFO Actor(1) Stop after 200000000 messages; 63.5 seconds, 3149903.9 Hz
That's just over 3 million messages per second on a single core. Neat, huh?
Next steps are to implement proper Dataspace model entities, with
assertions and facets etc., and then build an actual Dataspace to go
with it. I'll be trying to reuse as much of this implementation style
as possible since it performs so well.