Class View
In: src/org/puremvc/ruby/core/view.rb
Parent: Object

In PureMVC, the View class assumes these responsibilities:

  • Maintain a cache of IMediator instances.
  • Provide methods for registering, retrieving, and removing Mediators.
  • Notifiying Mediators when they are registered or removed.
  • Managing the observer lists for each Notification in the application.
  • Providing a method for attaching Observers to an Notification‘s observer list.
  • Providing a method for broadcasting an Notification.
  • Notifying the Observers of a given Notification when it broadcast.

Methods

has_mediator?   initialize_view   new   notify_observers   register_mediator   register_observer   remove_mediator   remove_observer   retrieve_mediator  

Included Modules

Singleton

Attributes

mediator_map  [RW] 
observer_map  [RW] 

Public Class methods

new()

This View implementation is a Singleton, so you should not call the constructor directly, but instead call the static Singleton Factory method View.instance.

Public Instance methods

has_mediator?(mediator_name)

Check if a Mediator is registered or not.

returns whether a Mediator is registered with the given name.

initialize_view()

Initialize the Singleton View instance.

Called automatically by the constructor, this is your opportunity to initialize the Singleton instance in your subclass without overriding the constructor

notify_observers(notification)

Notify the Observers for a particular Notification.

All previously attached Observers for this Notification‘s list are notified and are passed a reference to the Notification in the order in which they were registered.

register_mediator(mediator)

Register a Mediator instance with the View.

Registers the Mediator so that it can be retrieved by name and further interrogates the mediator for its Notification interests.

If the mediator returns any Notifiation name to be notified about, an Observer is created encapsulating the Mediator instance‘s handle_notification method and registering it as an Observer for all Notifications the Mediator is interested in.

register_observer(notification_name, observer)

Register an Observer to be notified of Notifications with a given name.

remove_mediator(mediator_name)

Remove a Mediator from the View.

returns the Mediator that was removed.

remove_observer(notification_name, observer)

Remove the observer for a given notify context from an observer list for a given Notification name.

retrieve_mediator(mediator_name)

Retrieve a mediator from the View.

returns the previously registered Mediator with the given name.

[Validate]