Ends in:
0 DAY
4 HRS
29 MIN
21 SEC
Ends in:
0 D
4 H
29 M
21 S

Event Bus

An event bus is a mediator that transfers a message from a sender to a receiver. In this way, it provides a loosely coupled communication way between objects, services and applications.

Event Bus Types

ABP provides two type of event buses;

  • Local Event Bus is suitable for in-process messaging.
  • Distributed Event Bus is suitable for inter-process messaging, like publishing and subscribing to distributed events in a distributed/microservice system.

Event Bus Guiding

You may confuse which event bus to use in your application. Here, a few example scenarios:

  • If you are building a microservice system, use the distributed event bus for inter-microservice communication. If you are publishing an event and always handling it in the same microservice, you can use the local event bus for that event.
  • If you are building a modular monolith application, use the distributed event bus for inter-module communication. Since the distributed event bus works in-process by default (unless you configure a real distributed event bus provider). In that way, if you migrate to a microservice system later, these inter-module communication can become a inter-microservice communication without any code change (with just installing a distributed event bus provide package). If you are publishing an event and always handling it in the same module, you can use the local event bus for that event.
  • If you are building a monolith (non-modular) application, you can always use the local event bus.

The distributed event bus works in-process by default. Unless you don't configure a real distributed event bus provider, it works just like the local event bus. Once you configure a real distributed event bus provider, all your events become distributed.

So, you use the local event bus only if you an event should always remain in-process in any scenario. For other type of events, use the distributed event bus.

Technical Differences

There are some technical differences between the local and distributed event bus:

  • You can send entities or other non-serializable objects using the local event bus since these objects are not serialized/deserialized on event publishing. On the other hand, distributed event bus serializes/deserializes objects once you use a real distributed event bus provider.
  • The local event bus is always transactional in the database level. For distributed event bus, you should enable inbox/outbox pattern to ensure data consistency once you use a real distributed event bus provider.

These differences are because of the distributed event bus supports distributed scenarios while the local event bus is only used for in-process messaging. When you don't set up a real distributed event bus provider, these differences are not valid.

Contributors


Last updated: November 15, 2024 Edit this page on GitHub

Was this page helpful?

Please make a selection.

To help us improve, please share your reason for the negative feedback in the field below.

Please enter a note.

Thank you for your valuable feedback!

Please note that although we cannot respond to feedback, our team will use your comments to improve the experience.

In this document
Community Talks

What’s New with .NET 9 & ABP 9?

21 Nov, 17:00
Online
Watch the Event
Mastering ABP Framework Book
Mastering ABP Framework

This book will help you gain a complete understanding of the framework and modern web application development techniques.

Learn More