Mediator Class / puremvc Library / Dart Documentation

Mediator Class

A base IMediator implementation.

In PureMVC, IMediator implementors assume these responsibilities:

Implement a common method which returns a list of all INotifications the IMediator has interest in.
Implement a notification (callback) method for handling INotifications.
Implement methods that are called when the IMediator is registered or removed from an IView.

Additionally, IMediators typically:

Act as an intermediary between one or more view components and the rest of the application.
Place Event listeners on view components, and implement handlers which often send INotifications or interact with IProxys to post or retrieve data.
Receive INotifications, (typically containing data) and updating view components in response.

When an IMediator is registered with the IView, the IMediator's listNotificationInterests method is called The IMediator will return a List of INotification names which it wishes to be notified about.

The IView will then create an IObserver object encapsulating that IMediator's and its handleNotification method and register the IObserver for each INotification name returned by the IMediator's listNotificationInterests method.

Notifier > Mediator

Constructor

Mediator( String this.name, [Dynamic this.viewComponent] ){ }

Get the IMediator instance's name.

String getName() 
{    
  return name;
}

Dynamic getViewComponent()
{    
  return viewComponent;
}

void handleNotification( INotification note ) {}

List INotification interests.

Returns List - a List of the INotification names this IMediator has an interest in.

List<String> listNotificationInterests( )
{
  return new List<String>();
}

Called by the IView when the IMediator is registered.

void onRegister( ) {}

Called by the IView when the IMediator is removed.

void onRemove( ) {}

void setViewComponent( Dynamic component ) 
{
  viewComponent = component;
}

String name;

Dynamic viewComponent;