Publisher Interface - Identifies Many Different Objects As Notifiable
Any object that implements the publisher interface is capable of registering listeners and announcing a change in their state. Announce can theoretically be called at any given time during the function of the publisher
CHANGELOG
1.0: created PublisherInterface - August 16th, 2013 2.0: refactored file to fit Primus - April 2nd, 2015 3.0: de-coupled stateinterface as ambiguous reformatted for inclusion in phabstractic - July 26th, 2016
attachObserver(\Phabstractic\Patterns\Resource\Phabstractic\Patterns\Resource\ObserverInterface $observer)
Attach An Observer
Attach an observer to this publisher so that it can be notified of state changes
| \Phabstractic\Patterns\Resource\Phabstractic\Patterns\Resource\ObserverInterface | $observer |
detachObserver(\Phabstractic\Patterns\Resource\Phabstractic\Patterns\Resource\ObserverInterface $observer)
Detach An Observer
Detach an observer from this publisher so it is no longer modified of state changes
| \Phabstractic\Patterns\Resource\Phabstractic\Patterns\Resource\ObserverInterface | $observer |
setStateObject(\Phabstractic\Patterns\Resource\Phabstractic\patterns\resource\StateInterface $state)
Set State Object
In an 'event' publisher/observer ecosystem, such as asherwunk/phabstractic/-/event:
Replaces the current state object with a new state object. In order for the observer/publisher pattern to work it is recommended that this function notifies all observers of the host object.
| \Phabstractic\Patterns\Resource\Phabstractic\patterns\resource\StateInterface | $state | The State Object |