Observer Class - The basic minimal observer functionality
Any object inheriting from Observer is prepared to perform a basic tricky function remapping handler. The observer object expects a string, and then converts that string into a method call as the handler of the state change
CHANGELOG
1.0 created Observer - August 16th, 2013 2.0 Adapted Observer to Primus - August 25th, 2015 3.0: changed to trait from class reformatted for inclusion in phabstractic - July 27th, 2016
$observedSubjects : \Phabstractic\Patterns\Phabstractic\Patterns\Resource\PublisherInterface
The subjects that this observer is listening to
For an observer that listens to multiple publishers with some added functionality see Phabstractic\Event\Aggregator
detachPublisher(\Phabstractic\Patterns\Resource\PublisherInterface $publisher)
This detaches the observer from its subject
Reciprocal methods exist in the publisher
| \Phabstractic\Patterns\Resource\PublisherInterface | $publisher |
attachPublisher(\Phabstractic\Patterns\Resource\PublisherInterface $publisher)
Attach this observer to a new publisher
This also acts like a 'set' function, and null is an acceptable value to be passed
| \Phabstractic\Patterns\Resource\PublisherInterface | $publisher |
notifyObserver(\Phabstractic\Patterns\Resource\PublisherInterface $publisher, \Phabstractic\Patterns\Resource\StateInterface $state) : boolean
The meat of the observer.
This is where a state change gets transformed into an action
In this case the expected state change is a string, which gets turned into a method name and called (presumably defined in an extended class) [publishedFunction]
| \Phabstractic\Patterns\Resource\PublisherInterface | $publisher | |
| \Phabstractic\Patterns\Resource\StateInterface | $state |
True if event is handled