Main Page | Modules | Class Hierarchy | Alphabetical List | Class List | Directories | File List | Class Members | Related Pages

ImNotifiable Class Reference
[blackboard - blackboard related stuff]

#include <Blackboard.h>

Inherited by BasicModule.

Inheritance diagram for ImNotifiable:

Inheritance graph
List of all members.

Public Member Functions

virtual void receiveBBItem (int category, const BBItem *details, int scopeModuleId)=0
virtual ~ImNotifiable ()
 Prevent compiler complaints, but its best not to use the destructor.

Detailed Description

Clients can receive change notifications from the Blackboard via this interface. Clients must "implement" (subclass from) this class.

See also:
Andras Varga

Andreas Koepke

Member Function Documentation

virtual void ImNotifiable::receiveBBItem int  category,
const BBItem details,
int  scopeModuleId
[pure virtual]

Called by the Blackboard whenever a change of a category occurs to which this client has subscribed.

If your class is derived from a class that also is notifiable, make sure that you call it first thing you do. E.g.

BaseClass : public ImNotifiable ...

YourClass : public BaseClass ...

YourClass::receiveBBItem(category, details, scopeModuleId) { BaseClass::receiveBBItem(category, details, scopeModuleId); switch(category) { ... } }

This also implies that you should handle unknown categories gracefully -- maybe a subclass subscribed to them.

This function is called from within publishBBItem, please pay attention to race conditions that can appear. If you want to schedule messages when this function of your module is called, you have to use the Enter_Method or the Enter_Method_Silent macro.

Implemented in AlohaMacLayer, CSMAMacLayer, Mac80211, P2PPhyLayer, SnrEval, BasicModule, BasicSnrEval, and ChannelAccess.

The documentation for this class was generated from the following file:
Generated on Fri Jan 12 08:30:02 2007 for Mobility Framework by  doxygen 1.4.4