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