safe_callback.h

Go to the documentation of this file.

#ifndef SAFE_CALLBACK_CLASS
#define SAFE_CALLBACK_CLASS
 
/*****************************************************************************\
*                                                                             *
*  Name   : safe_callback                                                     *
*  Author : Chris Koeritz                                                     *
*                                                                             *
*******************************************************************************
* Copyright (c) 2001-$now By Author.  This program is free software; you can  *
* redistribute it and/or modify it under the terms of the GNU General Public  *
* License as published by the Free Software Foundation; either version 2 of   *
* the License or (at your option) any later version.  This is online at:      *
*     http://www.fsf.org/copyleft/gpl.html                                    *
* Please send any updates to: fred@gruntose.com                               *
\*****************************************************************************/
 
#include <basis/astring.h>
#include <basis/mutex.h>
#include <basis/contracts.h>
 
namespace processes {
 
// forward.
class callback_data_block;
class global_live_objects;
 
 
class safe_callback
{
public:
  safe_callback();
 
  void end_availability();
 
  virtual ~safe_callback();
 
  DEFINE_CLASS_NAME("safe_callback");
 
  bool decoupled() const { return _decoupled; }
 
  bool invoke_callback(callback_data_block &new_data);
 
protected:
  virtual void real_callback(callback_data_block &new_data) = 0;
 
private:
  bool _decoupled;  
  basis::mutex *_callback_lock;  
  void begin_availability();
 
public:
  global_live_objects &_invocables();
 
};
 
 
 
class callback_data_block
{
public:
  virtual ~callback_data_block();
};
 
 
} //namespace.
 
#endif