4 ms·

Emissary, a fast open-source Java messaging library

36 points by jeyjeyemem 9mo ago

jeyjeyemem 9mo ago
Emissary is a simple-to-use, no dependency, yet BLAZING FAST messaging library for decoupling messages (requests and events) and message handlers. Emissary aims to take advantage of the simplicity of using the annotations for handlers (e.g. @RequestHandler/@EventHandler) without the drawbacks of reflection (slow). What differentiates Emissary from other messaging/dispatch libraries? It takes advantage of java.lang.invoke.LambdaMetafactory to avoid the cost of invoking methods reflectively. This results in performance close to directly invoking the request handler and event handler methods. ~ 1000% more throughput compared to other similar libraries (Spring's ApplicationEventPublisher, Pipelinr, EventBus) ~ 90% faster compared to other similar libraries (Spring's ApplicationEventPublisher, Pipelinr, EventBus) Benchmarks found on the GitHub repository: https://github.com/joel-jeremy/emissary?tab=readme-ov-file#performance https://github.com/joel-jeremy/emissary?tab=readme-ov-file#p...
- azornathogron 8mo ago
  Assuming that you are the author of Emissary, this could be a Show HN, I think. https://news.ycombinator.com/showhn.html https://news.ycombinator.com/showhn.html
  - RestartKernel 8mo ago
    > To post, submit a story whose title begins with "Show HN". I always enjoy how low-tech this website is. Not necessarily great UX, but it's quaint.
    - MarkLowenstein 8mo ago
      This is the only site I go to without fear of having to wait for page load.
    - pragmatick 8mo ago
      And the only one I can think of where I can't post my comment using Ctrl+Enter.
  - jeyjeyemem 8mo ago
    Yes, I am the author. I didn't know that, I'll give it a try. Thank you for the tip!
- throw_away_623 8mo ago
  Are you planning to add persistent events as well, so that events are not lost due to crashes
  - jeyjeyemem 8mo ago
    This a frequently requested feature. At the moment, it only handles in-process messages but allowing for persistent events is definitely in the roadmap. It's not built-in right now, but this can be achieved by implementing custom RequestHandlerInvocationStrategy and EventHandlerInvocationStrategy. For example, one can implement an invocation strategy to serialize and send certain events to Kafka, queue, or your DB of choice. See: https://github.com/joel-jeremy/emissary/blob/main/emissary-core/src/main/java/io/github/joeljeremy/emissary/core/Emissary.java#L395-L421 https://github.com/joel-jeremy/emissary/blob/main/emissary-c... Here are the default invocation strategies built-in right now: https://github.com/joel-jeremy/emissary/tree/main/emissary-core/src/main/java/io/github/joeljeremy/emissary/core/invocationstrategies https://github.com/joel-jeremy/emissary/tree/main/emissary-c...
andypiper 8mo ago
Naming collision with an ActivityPub server https://emissary.dev/ https://emissary.dev/
- dmantis 8mo ago
  And i2p rust router https://github.com/altonen/emissary https://github.com/altonen/emissary
  - TeMPOraL 8mo ago
    And Cmdr. Benjamin Sisko.
    - pndy 8mo ago
      Peldor joi
- tdemin 8mo ago
  [dead]
RedShift1 8mo ago
I'm a big fan of Guava's EventBus. Easy to implement and straightforward to understand. This library does seem to require more setup and I don't see the immediate advantages, also why does it require an instanceProvider? I don't understand what that does.
- jeyjeyemem 8mo ago
  Emissary really shines if performance is a top priority. The setup is more or less similar, you register a bunch of event handlers when initializing the library. The main difference is that, in addition to events, Emissary also supports "request" messages. Requests enforce the invariant that only one handler should handle it - if there are multiple handlers registered for a given request, Emissary will throw an error. That, and some extension points which is only needed for more advance use cases. The InstanceProvider allows users to let the dependency injection (DI) framework of their choice instantiate the request/event handler classes (see https://github.com/joel-jeremy/emissary?tab=readme-ov-file#easy-integration-with-dependency-injection-di-frameworks https://github.com/joel-jeremy/emissary?tab=readme-ov-file#e...). This is in contrast to the way EventBus does it where subscribers need to be instantiated at startup time. By leveraging the DI framework, additional services can be injected to the handler's constructor.

36 points by jeyjeyemem 9mo ago

Emissary is a simple-to-use, no dependency, yet BLAZING FAST messaging library for decoupling messages (requests and events) and message handlers. Emissary aims to take advantage of the simplicity of using the annotations for handlers (e.g. @RequestHandler/@EventHandler) without the drawbacks of reflection (slow). What differentiates Emissary from other messaging/dispatch libraries? It takes advantage of java.lang.invoke.LambdaMetafactory to avoid the cost of invoking methods reflectively. This results in performance close to directly invoking the request handler and event handler methods. ~ 1000% more throughput compared to other similar libraries (Spring's ApplicationEventPublisher, Pipelinr, EventBus) ~ 90% faster compared to other similar libraries (Spring's ApplicationEventPublisher, Pipelinr, EventBus) Benchmarks found on the GitHub repository: https://github.com/joel-jeremy/emissary?tab=readme-ov-file#performance https://github.com/joel-jeremy/emissary?tab=readme-ov-file#p...

azornathogron 8mo ago
Assuming that you are the author of Emissary, this could be a Show HN, I think. https://news.ycombinator.com/showhn.html https://news.ycombinator.com/showhn.html
- RestartKernel 8mo ago
  > To post, submit a story whose title begins with "Show HN". I always enjoy how low-tech this website is. Not necessarily great UX, but it's quaint.
  - MarkLowenstein 8mo ago
    This is the only site I go to without fear of having to wait for page load.
  - pragmatick 8mo ago
    And the only one I can think of where I can't post my comment using Ctrl+Enter.
- jeyjeyemem 8mo ago
  Yes, I am the author. I didn't know that, I'll give it a try. Thank you for the tip!
throw_away_623 8mo ago
Are you planning to add persistent events as well, so that events are not lost due to crashes
- jeyjeyemem 8mo ago
  This a frequently requested feature. At the moment, it only handles in-process messages but allowing for persistent events is definitely in the roadmap. It's not built-in right now, but this can be achieved by implementing custom RequestHandlerInvocationStrategy and EventHandlerInvocationStrategy. For example, one can implement an invocation strategy to serialize and send certain events to Kafka, queue, or your DB of choice. See: https://github.com/joel-jeremy/emissary/blob/main/emissary-core/src/main/java/io/github/joeljeremy/emissary/core/Emissary.java#L395-L421 https://github.com/joel-jeremy/emissary/blob/main/emissary-c... Here are the default invocation strategies built-in right now: https://github.com/joel-jeremy/emissary/tree/main/emissary-core/src/main/java/io/github/joeljeremy/emissary/core/invocationstrategies https://github.com/joel-jeremy/emissary/tree/main/emissary-c...

andypiper 8mo ago

Naming collision with an ActivityPub server https://emissary.dev/ https://emissary.dev/

dmantis 8mo ago
And i2p rust router https://github.com/altonen/emissary https://github.com/altonen/emissary
- TeMPOraL 8mo ago
  And Cmdr. Benjamin Sisko.
  - pndy 8mo ago
    Peldor joi
tdemin 8mo ago
[dead]

RedShift1 8mo ago

I'm a big fan of Guava's EventBus. Easy to implement and straightforward to understand. This library does seem to require more setup and I don't see the immediate advantages, also why does it require an instanceProvider? I don't understand what that does.

jeyjeyemem 8mo ago
Emissary really shines if performance is a top priority. The setup is more or less similar, you register a bunch of event handlers when initializing the library. The main difference is that, in addition to events, Emissary also supports "request" messages. Requests enforce the invariant that only one handler should handle it - if there are multiple handlers registered for a given request, Emissary will throw an error. That, and some extension points which is only needed for more advance use cases. The InstanceProvider allows users to let the dependency injection (DI) framework of their choice instantiate the request/event handler classes (see https://github.com/joel-jeremy/emissary?tab=readme-ov-file#easy-integration-with-dependency-injection-di-frameworks https://github.com/joel-jeremy/emissary?tab=readme-ov-file#e...). This is in contrast to the way EventBus does it where subscribers need to be instantiated at startup time. By leveraging the DI framework, additional services can be injected to the handler's constructor.