< IMediator > Protocol Reference

#import <IMediator.h>

Inherited by Mediator.

List of all members.

Public Member Functions
(NSString *)	- mediatorName
(id)	- viewComponent
(void)	- handleNotification:
(NSArray *)	- listNotificationInterests
(void)	- onRegister
(void)	- onRemove
(void)	- setViewComponent:

---

Detailed Description

The interface definition for a PureMVC Mediator.

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.
• Implement methods that are called when the IMediator is registered or removed from the View.

Additionally, IMediators typically:

• Act as an intermediary between one or more view components such as text boxes or list controls, maintaining references and coordinating their behavior.
• Respond to and generate INotifications, interacting with of the rest of the PureMVC app.

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

The IView will then create an Observer object encapsulating that IMediator's (handleNotification) method and register it as an Observer for each INotification name returned by listNotificationInterests.

See also:

INotification

---

Member Function Documentation

- (void) handleNotification:

(id< INotification >)

notification

Handle an INotification.

Parameters:

notification

the INotification to be handled

Reimplemented in Mediator.

- (NSArray *) listNotificationInterests

List INotification interests.

Returns:

an Array of the INotification names this IMediator has an interest in.

Reimplemented in Mediator.

- (NSString *) mediatorName

Get the IMediator instance name

Returns:

the IMediator instance name

- (void) onRegister

Called by the View when the Mediator is registered

Reimplemented in Mediator.

- (void) onRemove

Called by the View when the Mediator is removed

Reimplemented in Mediator.

- (void) setViewComponent:

(id)

viewComponent

Set the IMediator's view component.

Parameters:

viewComponent

the view component

- (id) viewComponent

Get the IMediator's view component.

Returns:

id the view component