schedule_actor.h

Go to the documentation of this file.

#ifndef SCHEDULE_ACTOR_CLASS
#define SCHEDULE_ACTOR_CLASS

/*****************************************************************************\
*                                                                             *
*  Name   : schedule_actor                                                    *
*  Author : Chris Koeritz                                                     *
*                                                                             *
*******************************************************************************
* Copyright (c) 1991-$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 "scheduling_common.h"

// forward.
class schedulable;


class SCHEDULING_CLASS_STYLE schedule_actor : public scheduling_common
{
public:
  virtual int actor_id() const = 0;

  IMPLEMENT_CLASS_NAME("schedule_actor");

  // in the schedulable management functions below, the schedulable must be
  // locked prior to calling the function specified.  thus the derived
  // schedule_actor is assured that it is the only one possessing the lock
  // on the schedulable, which at least ensures that no other scheduling
  // function is active on it.
  //
  // the derived schedule_actor, on the other hand, must take care of its own
  // thread safety.  it must be safe for multiple threads to call the
  // management functions on different schedulable objects.  this is especially
  // important if those management functions are allowed to manipulate any
  // data owned by the derived schedule_actor or other classes.

  virtual outcome preprocess(schedulable &to_process) = 0;

  virtual outcome activate(schedulable &to_activate, int time_allowed) = 0;

  virtual outcome expiration(schedulable &to_expire) = 0;

  virtual void postprocess(schedulable &to_process) = 0;

};



class SCHEDULING_CLASS_STYLE actor_mapping
{
public:
  actor_mapping(schedule_actor &actor) : _actor(actor) {}
  virtual ~actor_mapping();
  schedule_actor &_actor;
};



class SCHEDULING_CLASS_STYLE actor_mapper
{
public:
  virtual ~actor_mapper();
  virtual actor_mapping *open_actor(int actor_id) = 0;

  virtual void close_actor(actor_mapping *to_close) = 0;

};

#endif

---