ndn-pit-entry.h

/* -*- Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil -*- */
/*
 * Copyright (c) 2011 University of California, Los Angeles
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation;
 *
 * This program 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 this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 * Author: Alexander Afanasyev <alexander.afanasyev@ucla.edu>
 */

#ifndef _NDN_PIT_ENTRY_H_
#define _NDN_PIT_ENTRY_H_

#include "ns3/ptr.h"
#include "ns3/simple-ref-count.h"

#include "ns3/ndn-fib.h"

#include "ns3/ndn-pit-entry-incoming-face.h"
#include "ns3/ndn-pit-entry-outgoing-face.h"

#include <boost/multi_index_container.hpp>
#include <boost/multi_index/tag.hpp>
#include <boost/multi_index/ordered_index.hpp>
// #include <boost/multi_index/composite_key.hpp>
// #include <boost/multi_index/hashed_index.hpp>
#include <boost/multi_index/member.hpp>
// #include <boost/multi_index/mem_fun.hpp>
#include <set>
#include <boost/shared_ptr.hpp>

namespace ns3 {
namespace ndn {

class Pit;

namespace fw { class Tag; }

namespace pit {

class Entry : public SimpleRefCount<Entry>
{
public:
  typedef std::set< IncomingFace > in_container; 
  typedef in_container::iterator in_iterator;                

  // typedef OutgoingFaceContainer::type out_container; ///< @brief outgoing faces container type
  typedef std::set< OutgoingFace > out_container; 
  typedef out_container::iterator out_iterator;              

  typedef std::set< uint32_t > nonce_container;  

  Entry (Pit &container, Ptr<const Interest> header, Ptr<fib::Entry> fibEntry);

  virtual ~Entry ();

  virtual void
  UpdateLifetime (const Time &lifetime);

  virtual void
  OffsetLifetime (const Time &offsetTime);

  const Name &
  GetPrefix () const;

  const Time &
  GetExpireTime () const;

  bool
  IsNonceSeen (uint32_t nonce) const;

  virtual void
  AddSeenNonce (uint32_t nonce);

  virtual in_iterator
  AddIncoming (Ptr<Face> face);

  virtual void
  RemoveIncoming (Ptr<Face> face);

  virtual void
  ClearIncoming ();

  virtual out_iterator
  AddOutgoing (Ptr<Face> face);

  virtual void
  ClearOutgoing ();

  virtual void
  RemoveAllReferencesToFace (Ptr<Face> face);

  // virtual void
  // SetWaitingInVain (out_iterator face);
  virtual void
  SetWaitingInVain (Ptr<Face> face);

  bool
  AreAllOutgoingInVain () const;

  bool
  AreTherePromisingOutgoingFacesExcept (Ptr<Face> face) const;

  virtual void
  IncreaseAllowedRetxCount ();

  uint32_t
  GetMaxRetxCount () const;

  Ptr<fib::Entry>
  GetFibEntry ();

  const in_container &
  GetIncoming () const;

  const out_container &
  GetOutgoing () const;

  uint32_t
  GetOutgoingCount () const;

  inline void
  AddFwTag (boost::shared_ptr< fw::Tag > tag);

  template<class T>
  inline boost::shared_ptr< T >
  GetFwTag ();

  template<class T>
  inline void
  RemoveFwTag ();

  Ptr<const Interest>
  GetInterest () const;

private:
  friend std::ostream& operator<< (std::ostream& os, const Entry &entry);

protected:
  Pit &m_container; 

  Ptr<const Interest> m_interest; 
  Ptr<fib::Entry> m_fibEntry;     

  nonce_container m_seenNonces;  
  in_container  m_incoming;      
  out_container m_outgoing;      

  Time m_expireTime;         

  Time m_lastRetransmission; 
  uint32_t m_maxRetxCount;   

  std::list< boost::shared_ptr<fw::Tag> > m_fwTags; 
};

struct EntryIsNotEmpty
{
  bool
  operator () (Ptr<Entry> entry)
  {
    return !entry->GetIncoming ().empty ();
  }
};

std::ostream& operator<< (std::ostream& os, const Entry &entry);

inline void
Entry::AddFwTag (boost::shared_ptr< fw::Tag > tag)
{
  m_fwTags.push_back (tag);
}

template<class T>
inline boost::shared_ptr< T >
Entry::GetFwTag ()
{
  for (std::list< boost::shared_ptr<fw::Tag> >::iterator item = m_fwTags.begin ();
       item != m_fwTags.end ();
       item ++)
    {
      boost::shared_ptr< T > retPtr = boost::dynamic_pointer_cast<T> (*item);
      if (retPtr != boost::shared_ptr< T > ())
        {
          return retPtr;
        }
    }

  return boost::shared_ptr< T > ();
}

// /**
//  * @brief Peek the forwarding strategy tag
//  */
// template<class T>
// inline boost::shared_ptr< const T >
// Entry::PeekFwTag () const
// {
//   for (std::list< boost::shared_ptr<fw::Tag> >::const_iterator item = m_fwTags.begin ();
//        item != m_fwTags.end ();
//        item ++)
//     {
//       boost::shared_ptr< const T > retPtr = boost::dynamic_pointer_cast<const T> (*item);
//       if (retPtr != 0)
//         {
//           return retPtr;
//         }
//     }

//   return 0;
// }

template<class T>
inline void
Entry::RemoveFwTag ()
{
  for (std::list< boost::shared_ptr<fw::Tag> >::iterator item = m_fwTags.begin ();
       item != m_fwTags.end ();
       item ++)
    {
      boost::shared_ptr< T > retPtr = boost::dynamic_pointer_cast< T > (*item);
      if (retPtr != boost::shared_ptr< T > ())
        {
          m_fwTags.erase (item);
          return;
        }
    }
}


} // namespace pit
} // namespace ndn
} // namespace ns3

#endif // _NDN_PIT_ENTRY_H_