Ignore:
File:
1 edited

Legend:

Unmodified
Added
Removed
  • src/Patterns/Observer.hpp

    r50fc88c rd5f216  
    1616 *
    1717 * Observers register themselves with the observables to be notified when something changes.
    18  * In the Observable code that changes attributes should be started with OBSERVE;. This macro
    19  * locks the observer mechanism while changes are done. At the end of the scope in which the
    20  * macro was placed the lock is released. When the last lock is released all changes are
    21  * propagated to the observers.
     18 * In the Observable code that changes attributes should be wrapped in
     19 * START_OBSERVER ... END_OBSERVER blocks. If other methods are called that also contain
     20 * Observation blocks from there, these functions wont trigger notifications. Only the end
     21 * of the final observation block triggers the update of Observers.
    2222 *
    2323 * Each observerable can have sub-observables. When one of these sub-observables changes and
     
    4747  virtual ~Observable();
    4848
    49   virtual void signOn(Observer *target, int priority=0);
     49  virtual void signOn(Observer *target);
    5050  virtual void signOff(Observer *target);
    5151
     
    5959  /**
    6060   * Internal method.
    61    * Do not call directly. Use OBSERVE macro instead
     61   * Do not call directly. Use START_OBSERVER macro instead
    6262   */
    6363  static void start_observer_internal(Observable *publisher);
    6464  /**
    6565   * Internal method.
    66    * Do not call directly. Use OBSERVE macro instead
     66   * Do not call directly. Use FINISH_OBSERVER macro instead
    6767   */
    6868  static void finish_observer_internal(Observable *publisher);
    6969
    7070private:
    71   typedef std::multimap<int,Observer*> callees_t;
    7271  static std::map<Observable*, int> depth;
    73   static std::map<Observable*,callees_t*> callTable;
     72  static std::multimap<Observable*,Observer*> callTable;
    7473  static std::set<Observable*> busyObservables;
    75 
    76   // Structure for RAII-Style notification
    77 protected:
    78   class _Observable_protector {
    79   public:
    80     _Observable_protector(Observable *);
    81     ~_Observable_protector();
    82   private:
    83     Observable *protege;
    84   };
    8574};
    8675
    87 // extra macro is necessary to work with __LINE__
    88 #define PASTE(a,b) PASTE_HELPER(a,b)
    89 #define PASTE_HELPER(a,b) a ## b
    90 #define OBSERVE Observable::_Observable_protector PASTE(_scope_obs_protector_,__LINE__)(this)
    91 // deprecated macros from before RAII was used
    92 //#define START_OBSERVER Observable::start_observer_internal(this);do{do{}while(0)
    93 //#define FINISH_OBSERVER }while(0);Observable::finish_observer_internal(this)
    94 //#define RETURN_OBSERVER( retval ) do{Observable::finish_observer_internal(this); return (retval);}while(0)
     76
     77
     78#define START_OBSERVER Observable::start_observer_internal(this);do{do{}while(0)
     79#define FINISH_OBSERVER }while(0);Observable::finish_observer_internal(this)
    9580#endif /* OBSERVER_HPP_ */
Note: See TracChangeset for help on using the changeset viewer.