DataObject Class Reference

A DataObject is the base class of any identifiable object on any data store. More...

#include <GaudiKernel/DataObject.h>

Inheritance diagram for DataObject:

Collaboration diagram for DataObject:

Public Member Functions
	DataObject ()
	Standard Constructor. More...
	DataObject (const DataObject &)
	Copy Constructor. More...
virtual	~DataObject ()
	Standard Destructor. More...
virtual unsigned long	addRef ()
	Add reference to object. More...
virtual unsigned long	release ()
	release reference to object More...
virtual const CLID &	clID () const
	Retrieve reference to class definition structure. More...
const std::string &	name () const
	Retreive DataObject name. It is the name when registered in the store. More...
virtual StatusCode	update ()
	Provide empty placeholder for internal object reconfiguration callback. More...

Static Public Member Functions
static const CLID &	classID ()
	Retrieve reference to class definition structure (static access) More...

Private Attributes
unsigned long	m_refCount
	Reference count. More...
unsigned char	m_version
	Version number. More...
IRegistry *	m_pRegistry
	Pointer to the Registry Object. More...
LinkManager *	m_pLinkMgr
	Store of symbolic links. More...

inline code of class DataObject
void	setRegistry (IRegistry *pRegistry)
	Set pointer to Registry. More...
IRegistry *	registry () const
	Get pointer to Registry. More...
LinkManager *	linkMgr () const
	Retrieve Link manager. More...
unsigned char	version () const
	Retrieve version number of this object representation. More...
void	setVersion (unsigned char vsn)
	Set version number of this object representation. More...
unsigned long	refCount () const
	Return the refcount. More...
virtual std::ostream &	fillStream (std::ostream &s) const
	Fill the output stream (ASCII) More...
std::ostream &	operator<< (std::ostream &s, const DataObject &obj)
	Output operator (ASCII) More...

Detailed Description

A DataObject is the base class of any identifiable object on any data store.

The base class supplies the implementation of data streaming.

Author

M.Frank

Definition at line 31 of file DataObject.h.

Constructor & Destructor Documentation

DataObject::DataObject

(

)

Standard Constructor.

Definition at line 15 of file DataObject.cpp.

 : m_refCount(0),
   m_version(0),
   m_pRegistry(0)
{
  m_pLinkMgr = LinkManager::newInstance();
}

DataObject::DataObject

(

const DataObject &

)

Copy Constructor.

Standard Constructor.

Definition at line 24 of file DataObject.cpp.

 : m_refCount(0),
   m_version(0),
   m_pRegistry(0)
{
  m_pLinkMgr = LinkManager::newInstance();
}

DataObject::~DataObject ( )

virtual

Standard Destructor.

Definition at line 33 of file DataObject.cpp.

                          {
  // Issue a warning if the object is being deleted and the reference
  // count is non-zero.
  if ( m_refCount > 0 ) {
    // Insert warning here
  }
  if ( m_pLinkMgr ) delete m_pLinkMgr;
  m_pLinkMgr = 0;
}

Member Function Documentation

unsigned long DataObject::addRef ( )

virtual

Add reference to object.

Definition at line 53 of file DataObject.cpp.

                                  {
  return ++m_refCount;
}

const CLID & DataObject::classID ( )

static

Retrieve reference to class definition structure (static access)

Retrieve Pointer to class definition structure.

Definition at line 63 of file DataObject.cpp.

                                   {
  return CLID_DataObject;
}

const CLID & DataObject::clID ( ) const

virtual

Retrieve reference to class definition structure.

Retrieve Pointer to class definition structure.

Reimplemented in NTuple::File, NTuple::Directory, RefTable1toN< FROM, TO >, KeyedContainer< DATATYPE, MAPPING >, KeyedContainer< MyVertex >, KeyedContainer< MyTrack >, RefTable1to1< FROM, TO >, NTuple::RowWiseTuple, NTuple::ColumnWiseTuple, SharedObjectsContainer< TYPE >, ObjectVector< TYPE >, ObjectList< TYPE >, AlgorithmHistory, JobHistory, AlgToolHistory, DataHistory, Gaudi::Histogram3D, Gaudi::Profile2D, Gaudi::Histogram1D, Gaudi::Histogram2D, Gaudi::Profile1D, ServiceHistory, Event, and HistoryObj.

Definition at line 58 of file DataObject.cpp.

                                     {
  return CLID_DataObject;
}

virtual std::ostream& DataObject::fillStream ( std::ostream &  s ) const

inlinevirtual

Fill the output stream (ASCII)

Reimplemented in ObjectVector< TYPE >, ObjectList< TYPE >, and Event.

Definition at line 89 of file DataObject.h.

                                                        {
    s << "DataObject at " << std::hex << this;
    return s;
  }

LinkManager* DataObject::linkMgr ( ) const

inline

Retrieve Link manager.

Definition at line 73 of file DataObject.h.

                                    {
    return m_pLinkMgr;
  }

const std::string & DataObject::name

(

)

const

Retreive DataObject name. It is the name when registered in the store.

Retrieve DataObject name. It is the name when included in the store.

Definition at line 68 of file DataObject.cpp.

                                        {
  if( m_pRegistry != 0) {
    return m_pRegistry->name();
  }
  else {
    return _sDataObjectCppNotRegistered;
  }
}

unsigned long DataObject::refCount ( ) const

inline

Return the refcount.

Definition at line 85 of file DataObject.h.

                                 {
    return m_refCount;
  }

IRegistry* DataObject::registry ( ) const

inline

Get pointer to Registry.

Definition at line 69 of file DataObject.h.

                                {
    return m_pRegistry;
  }

unsigned long DataObject::release ( )

virtual

release reference to object

Decrease reference count.

Definition at line 44 of file DataObject.cpp.

                                   {
  unsigned long cnt = --m_refCount;
  if ( 0 == m_refCount )   {
    delete this;
  }
  return cnt;
}

void DataObject::setRegistry ( IRegistry *  pRegistry )

inline

Set pointer to Registry.

Definition at line 65 of file DataObject.h.

                                            {
    m_pRegistry = pRegistry;
  }

void DataObject::setVersion ( unsigned char  vsn )

inline

Set version number of this object representation.

Definition at line 81 of file DataObject.h.

                                        {
    m_version = vsn;
  }

StatusCode DataObject::update ( )

virtual

Provide empty placeholder for internal object reconfiguration callback.

Reimplemented in KeyedContainer< DATATYPE, MAPPING >, KeyedContainer< MyVertex >, and KeyedContainer< MyTrack >.

Definition at line 78 of file DataObject.cpp.

                              {
  return StatusCode::SUCCESS;
}

unsigned char DataObject::version ( ) const

inline

Retrieve version number of this object representation.

Definition at line 77 of file DataObject.h.

                                    {
    return m_version;
  }

Friends And Related Function Documentation

std::ostream& operator<< ( std::ostream &  s, const DataObject &  obj  )

friend

Output operator (ASCII)

Definition at line 94 of file DataObject.h.

                                                                         {
    return obj.fillStream(s);
  }

Member Data Documentation

LinkManager* DataObject::m_pLinkMgr

private

Store of symbolic links.

Definition at line 40 of file DataObject.h.

IRegistry* DataObject::m_pRegistry

private

Pointer to the Registry Object.

Definition at line 38 of file DataObject.h.

unsigned long DataObject::m_refCount

private

Reference count.

Definition at line 34 of file DataObject.h.

unsigned char DataObject::m_version

private

Version number.

Definition at line 36 of file DataObject.h.

---

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

• GaudiKernel/GaudiKernel/DataObject.h
• GaudiKernel/src/Lib/DataObject.cpp