post_office.h

Go to the documentation of this file.

#ifndef CENTRAL_MAILBOX_CLASS
#define CENTRAL_MAILBOX_CLASS
 
/*****************************************************************************\
*                                                                             *
*  Name   : post_office                                                       *
*  Author : Chris Koeritz                                                     *
*                                                                             *
*******************************************************************************
* Copyright (c) 1998-$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 "mail_stop.h"
 
#include <processes/ethread.h>
#include <timely/time_stamp.h>
 
namespace processes {
 
class letter;
class letter_morph;
class mailbox;
class postal_cache;
class route_map;
class thread_cabinet;
 
 
class post_office
{
public:
  post_office();
 
  virtual ~post_office();
 
  void stop_serving();
 
  // informational functions...
 
  DEFINE_CLASS_NAME("post_office");
 
  void show_mail(basis::astring &to_fill);
 
  void show_routes(basis::astring &to_fill);
 
  // general delivery services subject to the constraints of the mailbox class.
 
  void drop_off(const structures::unique_int &id, letter *package);
 
  bool pick_up(const structures::unique_int &id, letter * &package);
 
 
  // mail delivery and routing support.
 
  bool register_route(const structures::unique_int &id, mail_stop &carrier_path);
 
  bool unregister_route(const structures::unique_int &id);
 
  bool route_listed(const structures::unique_int &id);
 
 
  bool deliver_mail_on_route(const structures::unique_int &route, ethread &carrier);
 
private:
  basis::mutex c_mutt;  
  mailbox *_post;  
  route_map *_routes;  
  timely::time_stamp *_next_cleaning;  
  thread_cabinet *_threads;  
 
  void get_route_list(structures::int_set &route_set);
 
  void clean_package_list(post_office &post, letter_morph &to_clean);
};
 
} //namespace.
 
#endif