Tracer.h

// Copyright 2008 Michael Marsh, University of Maryland.
//
// This file is part of pydtn.
//
// pydtn 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 3 of the License, or
// (at your option) any later version.
//
// pydtn is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with pydtn.  If not, see <http://www.gnu.org/licenses/>.
//
// The views and conclusions contained in the software and documentation
// are those of the authors and should not be interpreted as representing
// official policies, either expressed or implied, of the University
// of Maryland.
//
// pydtn extends and embeds the Python interpreter, which is
// Copyright 2001-2006 Python Software Foundation, All Rights Reserved,
// and is released under the PSF License Agreement.
//
// RANLUX random number generation uses the Boost library,
// Copyright 1994-2006 by various authors (details in individual files),
// which is released under the Boost Software License, Version 1.0.

#ifndef __WRAPPERS_HARNESS_TRACER_H__
#define __WRAPPERS_HARNESS_TRACER_H__

#include "config.h"

#include "dtn/Bundle.h"
#include "dtn/Node.h"
#include <vector>

class WrapNode;
class WrapLink;


class Tracer
{
   public :
      Tracer() {}
      virtual ~Tracer() {}

      virtual void node( const WrapNode& wn ) = 0;

      virtual void link( const WrapLink& wl ) = 0;

      virtual void enqueue( const DTN::Bundle& b, const DTN::Node* n ) = 0;

      virtual void dequeue( const DTN::Bundle& b, const DTN::Node* n ) = 0;

      virtual void send( const DTN::Bundle& b, const DTN::Node* n ) = 0;

      virtual void receive( const DTN::Bundle& b, const DTN::Node* n ) = 0;

      virtual void drop( const DTN::Bundle& b,
                         const DTN::DropCause& c,
                         const DTN::Node* n ) = 0;
};

class TracerChain : public Tracer
{
   public :
      typedef std::vector< Tracer* >  ChainType;

      TracerChain() {}

      virtual ~TracerChain();

      void node( const WrapNode& wn );
      void link( const WrapLink& wl );

      void enqueue( const DTN::Bundle& b, const DTN::Node* n );
      void dequeue( const DTN::Bundle& b, const DTN::Node* n );
      void send( const DTN::Bundle& b, const DTN::Node* n );
      void receive( const DTN::Bundle& b, const DTN::Node* n );
      void drop( const DTN::Bundle& b,
                 const DTN::DropCause& c,
                 const DTN::Node* n );

      void addTracer( Tracer* t );

   private :
      ChainType  m_chain;
};

class GlobalTracer : public TracerChain
{
   public :
      static void enable();

      static GlobalTracer* instance();

   protected :
      GlobalTracer();
      virtual ~GlobalTracer();

      static GlobalTracer* m_instance;
};


#endif // __WRAPPERS_HARNESS_TRACER_H__

---