Gaudi Framework, version v20r2
	Generated: 18 Jul 2008

LinkManager Class Reference

#include <GaudiKernel/LinkManager.h>

Collaboration diagram for LinkManager:

[legend]List of all members.

---

Detailed Description

A LinkManager is the object aggregated into a DataObject, which is responsible for the handling of non-tree like links.

Author:

M.Frank

Definition at line 18 of file LinkManager.h.

Public Types
enum	DirLinkType { INVALID, VALID }
	Directory link types. More...
typedef std::vector< Link * >	LinkVector
typedef LinkVector::iterator	LinkIterator
	Data type: iterator over leaf links.
typedef LinkVector::const_iterator	ConstLinkIterator
	Data type: iterator over leaf links (CONST).
Public Member Functions
	LinkManager ()
	Standard Constructor.
virtual	~LinkManager ()
	Standard Destructor.
long	size () const
	Retrieve number of link present.
Link *	link (long id)
	Retrieve symbolic link identified by ID.
Link *	link (const DataObject *pObject)
	Retrieve symbolic link identified by object.
Link *	link (const std::string &path)
	Retrieve symbolic link identified by path.
long	addLink (const std::string &path, const DataObject *pObject) const
	Add link by object reference and path.
long	removeLink (const DataObject *pObject) const
	Remove link by object reference.
long	removeLink (const std::string &fullPath) const
	Remove link by object reference.
long	removeLink (long id) const
	Remove link by link ID.
void	clearLinks ()
	Remove all possibly existing symbolic links.
Static Public Member Functions
static LinkManager *	newInstance ()
	Static instantiation.
static void	setInstantiator (LinkManager *(*newInstance)())
	Assign new instantiator.
Public Attributes
LinkVector	m_linkVector
	The vector containing all links which are non-tree like.
Classes
class	Link
	Embeeded class defining a symbolic link Note: No copy constructor; bitwise copy (done by the compiler) is just fine. More...

---

Member Typedef Documentation

typedef std::vector<Link*> LinkManager::LinkVector

Definition at line 86 of file LinkManager.h.

typedef LinkVector::iterator LinkManager::LinkIterator

Data type: iterator over leaf links.

Definition at line 88 of file LinkManager.h.

typedef LinkVector::const_iterator LinkManager::ConstLinkIterator

Data type: iterator over leaf links (CONST).

Definition at line 90 of file LinkManager.h.

---

Member Enumeration Documentation

enum LinkManager::DirLinkType

Directory link types.

Enumerator:

INVALID
VALID

Definition at line 22 of file LinkManager.h.

{INVALID, VALID};

---

Constructor & Destructor Documentation

LinkManager::LinkManager

(

)

Standard Constructor.

Definition at line 32 of file LinkManager.cpp.

Referenced by newInstance().

                          {
}

LinkManager::~LinkManager

(

)

[virtual]

Standard Destructor.

Definition at line 36 of file LinkManager.cpp.

References clearLinks().

                             {
  clearLinks();
}

---

Member Function Documentation

LinkManager * LinkManager::newInstance

(

)

[static]

Static instantiation.

Definition at line 27 of file LinkManager.cpp.

References LinkManager(), and s_newInstance.

Referenced by DataObject::DataObject(), and setInstantiator().

                                       {
  return s_newInstance ? (*s_newInstance)() : new LinkManager();
}

void LinkManager::setInstantiator

(

LinkManager *(*)()

newInstance

)

[static]

Assign new instantiator.

Definition at line 22 of file LinkManager.cpp.

References newInstance(), and s_newInstance.

                                                                 {
  s_newInstance = newInstance;
}

long LinkManager::size

(

)

const [inline]

Retrieve number of link present.

Definition at line 105 of file LinkManager.h.

References m_linkVector, and std::vector< _Tp, _Alloc >::size().

Referenced by PoolDbBaseCnv::dumpReferences(), PoolDbBaseCnv::setReferences(), and PoolDbBaseCnv::updateObjRefs().

                        {
    return m_linkVector.size();
  }

LinkManager::Link * LinkManager::link

(

long

id

)

Retrieve symbolic link identified by ID.

Definition at line 41 of file LinkManager.cpp.

References m_linkVector, and std::vector< _Tp, _Alloc >::size().

Referenced by Objects::access(), SmartRefBase::accessData(), addLink(), PoolDbBaseCnv::dumpReferences(), SmartRefBase::isEqualEx(), LinkManager::Link::operator=(), LinkManager::Link::operator==(), SmartRefBase::path(), PoolDbBaseCnv::setReferences(), and PoolDbBaseCnv::updateObjRefs().

                                             {
  return (0<=id && (unsigned)id < m_linkVector.size()) ? m_linkVector[id] : 0;
}

LinkManager::Link * LinkManager::link

(

const DataObject *

pObject

)

Retrieve symbolic link identified by object.

Definition at line 46 of file LinkManager.cpp.

References std::vector< _Tp, _Alloc >::begin(), std::vector< _Tp, _Alloc >::end(), and m_linkVector.

                                                             {
  if ( 0 != pObject )   {
    for ( LinkVector::iterator i = m_linkVector.begin(); i != m_linkVector.end(); i++ )   {
      if ( (*i)->object() == pObject )    {
        return (*i);
      }
    }
  }
  return 0;
}

LinkManager::Link * LinkManager::link

(

const std::string &

path

)

Retrieve symbolic link identified by path.

Definition at line 58 of file LinkManager.cpp.

References std::vector< _Tp, _Alloc >::begin(), std::vector< _Tp, _Alloc >::end(), std::basic_string< _CharT, _Traits, _Alloc >::length(), m_linkVector, and Gaudi::Utils::Histos::path().

                                                         {
  if ( 0 != path.length() )   {
    for ( LinkVector::iterator i = m_linkVector.begin(); i != m_linkVector.end(); i++ )   {
      if ( (*i)->path() == path )    {
        return (*i);
      }
    }
  }
  return 0;
}

long LinkManager::addLink	(	const std::string &	path,
		const DataObject *	pObject
	)			const

Add link by object reference and path.

Definition at line 70 of file LinkManager.cpp.

References std::vector< _Tp, _Alloc >::begin(), std::vector< _Tp, _Alloc >::end(), LinkManager::Link::ID(), link(), m_linkVector, Gaudi::Utils::Histos::path(), std::vector< _Tp, _Alloc >::push_back(), and std::vector< _Tp, _Alloc >::size().

Referenced by PoolDbIOHandler< T >::put(), and PoolDbBaseCnv::setReferences().

                                                                                    {
  long n = 0;
  for ( LinkVector::const_iterator i = m_linkVector.begin(); i != m_linkVector.end(); i++ )   {
    Link* lnk = *i;
    const DataObject* pO = lnk->object();
    if ( 0 != pO && pO == pObject )   {
      return n;
    }
    bool same_path = lnk->path() == path;
    if ( same_path ) {
      if ( 0 != pObject && pObject != pO )  {
        lnk->setObject(pObject);
      }
      return n;
    }
    n++;
  }
  // Link is completely unknown
  Link* link = new Link(m_linkVector.size(), path, pObject);
  m_linkVector.push_back( link );
  return link->ID();
}

long LinkManager::removeLink

(

const DataObject *

pObject

)

const

Remove link by object reference.

Definition at line 94 of file LinkManager.cpp.

References std::vector< _Tp, _Alloc >::begin(), std::vector< _Tp, _Alloc >::end(), std::vector< _Tp, _Alloc >::erase(), INVALID, and m_linkVector.

                                                              {
  long n = 0;
  for ( LinkVector::iterator i = m_linkVector.begin(); i != m_linkVector.end(); i++ )   {
    if ( (*i)->object() == pObject )    {
      delete (*i);
      m_linkVector.erase(i);
      return n;
    }
    n++;
  }
  return INVALID;
}

long LinkManager::removeLink

(

const std::string &

fullPath

)

const

Remove link by object reference.

Definition at line 108 of file LinkManager.cpp.

References std::vector< _Tp, _Alloc >::begin(), std::vector< _Tp, _Alloc >::end(), std::vector< _Tp, _Alloc >::erase(), INVALID, m_linkVector, and Gaudi::Utils::Histos::path().

                                                          {
  long n = 0;
  for ( LinkVector::iterator i = m_linkVector.begin(); i != m_linkVector.end(); i++ )   {
    if ( (*i)->path() == path )    {
      delete (*i);
      m_linkVector.erase(i);
      return n;
    }
    n++;
  }
  return INVALID;
}

long LinkManager::removeLink

(

long

id

)

const

Remove link by link ID.

Definition at line 122 of file LinkManager.cpp.

References std::vector< _Tp, _Alloc >::begin(), std::vector< _Tp, _Alloc >::erase(), INVALID, and m_linkVector.

                                            {
  LinkVector::iterator i = m_linkVector.begin();
  i += id;
  delete (*i);
  m_linkVector.erase(i);
  return id;
  return INVALID;
}

void LinkManager::clearLinks

(

)

Remove all possibly existing symbolic links.

Definition at line 132 of file LinkManager.cpp.

References std::vector< _Tp, _Alloc >::begin(), std::vector< _Tp, _Alloc >::end(), std::vector< _Tp, _Alloc >::erase(), and m_linkVector.

Referenced by ~LinkManager().

                              {
  for ( LinkVector::iterator i = m_linkVector.begin(); i != m_linkVector.end(); i++ )   {
    delete (*i);
  }
  m_linkVector.erase(m_linkVector.begin(), m_linkVector.end());
}

---

Member Data Documentation

LinkVector LinkManager::m_linkVector [mutable]

The vector containing all links which are non-tree like.

Definition at line 93 of file LinkManager.h.

Referenced by addLink(), clearLinks(), link(), removeLink(), and size().

---

The documentation for this class was generated from the following files:

• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v20r2/GaudiKernel/v25r2/GaudiKernel/LinkManager.h
• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v20r2/GaudiKernel/v25r2/src/Lib/LinkManager.cpp

---