event_bus 0.3.0+3 copy "event_bus: ^0.3.0+3" to clipboard
event_bus: ^0.3.0+3 copied to clipboard

outdatedDart 1 only

A simple Event Bus using Dart Streams for decoupling applications

Event Bus #

A simple Event Bus using Dart Streams for decoupling applications.

Star this Repo Pub Package Build Status

GitHub | Pub | Demos and Examples

Event Bus Pattern #

An Event Bus follows the publish/subscribe pattern. It allows listeners to subscribe for events and publishers to fire events. This enables objects to interact without requiring to explicitly define listeners and keeping track of them.

Event Bus and MVC #

The Event Bus pattern is especially helpful for decoupling MVC (or MVP) applications.

One group of MVC is not a problem.

Model-View-Controller

But as soon as there are multiple groups of MVCs, those groups will have to talk to each other. This creates a tight coupling between the controllers.

Multi Model-View-Controllers

By communication through an Event Bus, the coupling is reduced.

Event Bus

Usage #

1. Create an Event Bus #

Create an instance of EventBus and make it available to other classes.

Usually there is just one Event Bus per application, but more than one may be set up to group a specific set of events.

import 'package:event_bus/event_bus.dart';

EventBus eventBus = new EventBus();

You can alternatively use the HierarchicalEventBus that filters events by event class including its subclasses.

EventBus eventBus = new EventBus.hierarchical();

Note: The default constructor will create an asynchronous event bus. To create a synchronous you must provide the optional sync: true attribute.

2. Define Events #

Any Dart class can be used as an event.

class UserLoggedInEvent {
  User user;
  
  UserLoggedInEvent(this.user);
}

class NewOrderEvent {
  Order order;
  
  NewOrderEvent(this.order);
}

3. Register Listeners #

Register listeners for a specific events:

eventBus.on(UserLoggedInEvent).listen((UserLoggedInEvent event) {
  print(event.user);
});

Register listeners for all events:

eventBus.on().listen((event) {
  // Print the runtime type. Such a set up could be used for logging.
  print(event.runtimeType); 
});

About Dart Streams

EventBus uses Dart Streams as its underlying mechanism to keep track of listeners. You may use all functionality available by the Stream API. One example is the use of StreamSubscriptions to later unsubscribe from the events.

StreamSubscription loginSubscription = eventBus.on(UserLoggedInEvent).listen((UserLoggedInEvent event) {
  print(event.user);	
});

loginSubscription.cancel();

4. Fire Events #

Finally, we need to fire an event.

User myUser = new User('Mickey');
eventBus.fire(new UserLoggedInEvent(myUser));

License #

The MIT License (MIT)

597
likes
0
pub points
99%
popularity

Publisher

verified publisherjakobservices.ch

A simple Event Bus using Dart Streams for decoupling applications

Homepage

License

unknown (LICENSE)

More

Packages that depend on event_bus