Description: More...

#include <src/DbContainerObj.h>

Inheritance diagram for pool::DbContainerObj:

Collaboration diagram for pool::DbContainerObj:

Public Types
typedef DbAccessObj< DbObject *, DbObjectHolder >	Base
	Type definitions.
typedef std::map< DbObject , DbObjectHolder >	Keys
typedef Keys::iterator	iterator
typedef Keys::const_iterator	const_iterator

Public Member Functions
	DbContainerObj (DbDatabase &dbH, const std::string &nam, const DbType &dbtyp, DbAccessMode mod)
	Standard constructor of a container object using the Database handle as a clustering hint.
virtual	~DbContainerObj ()
	Standard destructor.
const IDbContainer *	info () const
	Access to internals.
IDbContainer *	info ()
const DbTypeInfo *	objectShape (const Guid &nam)
	Retrieve persistent type information by name.
DbDatabase &	database ()
	Handle to Database (CONST)
const Token *	token () const
	Access the token of the container object.
bool	isOpen () const
	Flag if container was opened.
bool	isReadOnly () const
	Check if database is in read-only mode.
void	cancelTransaction ()
	Cancel transaction flag.
uint64_t	size ()
	Size of the Database container (=# of objects)
DbStatus	open (const DbTypeInfo *typ)
	Open the container.
DbStatus	checkAccess ()
	Check if we can access the container.
DbStatus	close ()
	Close the container.
DbStatus	retire ()
	Retire the container.
DbStatus	transAct (Transaction::Action)
	Execute Database Transaction Action.
DbStatus	setOption (const DbOption &opt)
	Pass options to the implementation.
DbStatus	getOption (DbOption &refOpt)
	Access options.
DbStatus	store (const void *object, DbContainer &cntH, ShapeH shape)
	Store object in location.
DbStatus	allocate (DbContainer &cntH, const void *object, ShapeH shape, Token::OID_t &oid)
	In place allocation of object location.
DbStatus	load (void **ptr, ShapeH shape, const Token::OID_t &linkH, Token::OID_t &oid, bool any_next)
	Select object in the container identified by its handle.
DbStatus	next (Token::OID_t &linkH)
	Fetch next object address to set token.
const std::string &	name () const
	Access the instance name.
void	setName (const std::string &n)
	Access the instance name.
DbAccessMode	mode () const
	Access mode.
void	setMode (DbAccessMode m)
	Set Access mode.
const DbType &	type () const
const IOODatabase *	db () const
	Allow access to the Database implementation.
int	refCount () const
	Access reference counter.
int	addRef () const
	Add reference count.
int	release () const
	Remove reference count.
size_t	size () const
	Object size.
DbStatus	clearEntries ()
	Object cleanup: remove all entries.
const DbObjectHolder *	find (const DbObject *&key) const
	Find object by key (CONST)
DbStatus	add (const DbObject &key, DbObjectHolder val)
	Add entry to container.
DbStatus	remove (const DbObjectHolder *val)
	Remove entry from container.
iterator	begin ()
iterator	end ()
bool	msgLvl (const MSG::Level lvl) const
	Test the output level.
MsgStream &	msg () const
	The standard message stream.
MsgStream &	msg (const MSG::Level lvl) const
	The standard message stream.
void	setLevel (MSG::Level lvl)
	Change the current logging level.

Private Member Functions
bool	hasAccess ()
	Check database access.
void	initMessaging () const
	Initialize our message level and MessageSvc.

Private Attributes
IDbContainer *	m_info
	Pointer to interface of the technology dependent part.
const Token *	m_tokH
	Container token.
DbDatabase	m_dbH
	Handle to hosting Database.
bool	m_isOpen
	Flag indication DbStatus of technology dependent container.
std::atomic< int >	m_refCount
	Reference counter.
DbAccessMode	m_mode
	Access mode.
std::string	m_name
	Name of the instance.
DbType	m_type
	Database type.
Keys	m_keys
	Key entry buffer.
IOODatabase *	m_pool
	Pointer to specific pool implementation.
std::string	m_nm
	Message source name.
boost::thread_specific_ptr< MsgStream >	m_msg_tls
	MsgStream instance (a std::cout like with print-out levels)
std::atomic< IMessageSvc * >	m_imsg { nullptr }
	MessageSvc pointer.
std::atomic< MSG::Level >	m_lvl { MSG::NIL }
	Current logging level.
std::atomic_flag m_initialized	ATLAS_THREAD_SAFE = ATOMIC_FLAG_INIT
	Messaging initialized (initMessaging)

Detailed Description

Description:

Implementation independent part of a container object objects.

There is a ring of protection around the object. The object can only be accessed through its handle, the technology dependent code and the DbDatabaseObj object hosting the container. This should ensure proper reference counting and inhibit non existing references flying around.

Author: M.Frank

Version: 1.0

Definition at line 50 of file DbContainerObj.h.

Member Typedef Documentation

◆ Base

typedef DbAccessObj< DbObject * , DbObjectHolder > pool::DbAccessObj< DbObject *, DbObjectHolder >::Base

inherited

Type definitions.

Definition at line 50 of file DbAccessObj.h.

◆ const_iterator

typedef Keys::const_iterator pool::DbAccessObj< DbObject *, DbObjectHolder >::const_iterator

inherited

Definition at line 53 of file DbAccessObj.h.

◆ iterator

typedef Keys::iterator pool::DbAccessObj< DbObject *, DbObjectHolder >::iterator

inherited

Definition at line 52 of file DbAccessObj.h.

◆ Keys

typedef std::map< DbObject *, DbObjectHolder* > pool::DbAccessObj< DbObject *, DbObjectHolder >::Keys

inherited

Definition at line 51 of file DbAccessObj.h.

Constructor & Destructor Documentation

◆ DbContainerObj()

pool::DbContainerObj::DbContainerObj	(	DbDatabase &	dbH,
		const std::string &	nam,
		const DbType &	dbtyp,
		DbAccessMode	mod )

Standard constructor of a container object using the Database handle as a clustering hint.

Parameters

dbH	[IN] Valid handle to database object
nam	[IN] Name of the container to be opened.
dbtyp	[IN] Database type (including minor type)
mod	[IN] Access mode.

Returns: Status code indicating success or failure.

◆ ~DbContainerObj()

virtual pool::DbContainerObj::~DbContainerObj ( )

virtual

Standard destructor.

Member Function Documentation

◆ add()

DbStatus pool::DbAccessObj< DbObject *, DbObjectHolder >::add	(	const DbObject * &	key,
		DbObjectHolder *	val )

inlineinherited

Add entry to container.

Definition at line 142 of file DbAccessObj.h.

                                              {
      iterator i = m_keys.find(key);
      if ( m_keys.end() == i )    {
        m_keys.insert(std::make_pair(key, val));
        val->addRef();
        return Success;
      }
      return Error;
    }

◆ addRef()

int pool::DbAccessObj< DbObject *, DbObjectHolder >::addRef ( ) const

inlineinherited

Add reference count.

Definition at line 91 of file DbAccessObj.h.

                        {
#ifdef DEBUG_REFCOUNTS
      std::cout << typeid(*this).name() 
                << "  " 
                << m_name 
                << " Refcount:" 
                << m_refCount+1  
                << std::endl;
#endif
      return ++m_refCount;
    }

◆ allocate()

DbStatus pool::DbContainerObj::allocate	(	DbContainer &	cntH,
		const void *	object,
		ShapeH	shape,
		Token::OID_t &	oid )

In place allocation of object location.

◆ begin()

iterator pool::DbAccessObj< DbObject *, DbObjectHolder >::begin ( )

inlineinherited

Definition at line 163 of file DbAccessObj.h.

163{ return m_keys.begin(); }

pool::DbAccessObj::begin

iterator begin()

Definition DbAccessObj.h:163

◆ cancelTransaction()

void pool::DbContainerObj::cancelTransaction ( )

inline

Cancel transaction flag.

Definition at line 93 of file DbContainerObj.h.

93{ }

◆ checkAccess()

DbStatus pool::DbContainerObj::checkAccess ( )

Check if we can access the container.

◆ clearEntries()

DbStatus pool::DbAccessObj< DbObject *, DbObjectHolder >::clearEntries ( )

inlineinherited

Object cleanup: remove all entries.

Definition at line 123 of file DbAccessObj.h.

                              {
      Keys k = m_keys;
      for(iterator j = k.begin(); j != k.end(); ++j )  {
        (*j).second->release();
      }
      m_keys.clear();
      return Success;
    }

◆ close()

DbStatus pool::DbContainerObj::close ( )

Close the container.

◆ database()

DbDatabase & pool::DbContainerObj::database ( )

inline

Handle to Database (CONST)

Definition at line 84 of file DbContainerObj.h.

84{ return m_dbH; }

pool::DbContainerObj::m_dbH

DbDatabase m_dbH

Handle to hosting Database.

Definition DbContainerObj.h:57

◆ db()

const IOODatabase * pool::DbAccessObj< DbObject *, DbObjectHolder >::db ( ) const

inlineinherited

Allow access to the Database implementation.

Definition at line 86 of file DbAccessObj.h.

86{ return m_pool; }

◆ end()

iterator pool::DbAccessObj< DbObject *, DbObjectHolder >::end ( )

inlineinherited

Definition at line 165 of file DbAccessObj.h.

165{ return m_keys.end(); }

◆ find()

const DbObjectHolder * pool::DbAccessObj< DbObject *, DbObjectHolder >::find ( const DbObject * & key ) const

inlineinherited

Find object by key (CONST)

Definition at line 132 of file DbAccessObj.h.

                                              {
      const_iterator i = m_keys.find(key);
      return (m_keys.end() == i) ? 0 : (*i).second;
    }

◆ getOption()

DbStatus pool::DbContainerObj::getOption ( DbOption & refOpt )

Access options.

◆ hasAccess()

bool pool::DbContainerObj::hasAccess ( )

private

Check database access.

◆ info() [1/2]

IDbContainer * pool::DbContainerObj::info ( )

inline

Definition at line 80 of file DbContainerObj.h.

80{ return m_info; }

pool::DbContainerObj::m_info

IDbContainer * m_info

Pointer to interface of the technology dependent part.

Definition DbContainerObj.h:53

◆ info() [2/2]

const IDbContainer * pool::DbContainerObj::info ( ) const

inline

Access to internals.

Definition at line 79 of file DbContainerObj.h.

79{ return m_info; }

◆ initMessaging()

void AthMessaging::initMessaging ( ) const

privateinherited

Initialize our message level and MessageSvc.

This method should only be called once.

Definition at line 39 of file AthMessaging.cxx.

{
  m_imsg = Athena::getMessageSvc();
  // If user did not set an explicit level, set a default
  if (m_lvl == MSG::NIL) {
    m_lvl = m_imsg ?
      static_cast<MSG::Level>( m_imsg.load()->outputLevel(m_nm) ) :
      MSG::INFO;
  }
}

◆ isOpen()

bool pool::DbContainerObj::isOpen ( ) const

inline

Flag if container was opened.

Definition at line 88 of file DbContainerObj.h.

88{ return m_isOpen; }

pool::DbContainerObj::m_isOpen

bool m_isOpen

Flag indication DbStatus of technology dependent container.

Definition DbContainerObj.h:59

◆ isReadOnly()

bool pool::DbContainerObj::isReadOnly ( ) const

inline

Check if database is in read-only mode.

Definition at line 90 of file DbContainerObj.h.

91 { return !(mode()&pool::UPDATE) && !(mode()&pool::CREATE); }

pool::DbAccessObj< DbObject *, DbObjectHolder >::mode

DbAccessMode mode() const

Definition DbAccessObj.h:80

pool::UPDATE

@ UPDATE

Definition Database/APR/StorageSvc/StorageSvc/pool.h:44

pool::CREATE

@ CREATE

Definition Database/APR/StorageSvc/StorageSvc/pool.h:45

◆ load()

DbStatus pool::DbContainerObj::load	(	void **	ptr,
		ShapeH	shape,
		const Token::OID_t &	linkH,
		Token::OID_t &	oid,
		bool	any_next )

Select object in the container identified by its handle.

◆ mode()

DbAccessMode pool::DbAccessObj< DbObject *, DbObjectHolder >::mode ( ) const

inlineinherited

Access mode.

Definition at line 80 of file DbAccessObj.h.

80{ return m_mode; }

◆ msg() [1/2]

MsgStream & AthMessaging::msg ( ) const

inlineinherited

The standard message stream.

Returns a reference to the default message stream May not be invoked before sysInitialize() has been invoked.

Definition at line 163 of file AthMessaging.h.

{
  MsgStream* ms = m_msg_tls.get();
  if (!ms) {
    if (!m_initialized.test_and_set()) initMessaging();
    ms = new MsgStream(m_imsg,m_nm);
    m_msg_tls.reset( ms );
  }
 
  ms->setLevel (m_lvl);
  return *ms;
}

◆ msg() [2/2]

MsgStream & AthMessaging::msg ( const MSG::Level lvl ) const

inlineinherited

The standard message stream.

Returns a reference to the default message stream May not be invoked before sysInitialize() has been invoked.

Definition at line 178 of file AthMessaging.h.

179{ return msg() << lvl; }

AthMessaging::msg

MsgStream & msg() const

The standard message stream.

Definition AthMessaging.h:163

◆ msgLvl()

bool AthMessaging::msgLvl ( const MSG::Level lvl ) const

inlineinherited

Test the output level.

Parameters

lvl	The message level to test against

Returns: boolean Indicating if messages at given level will be printed

Return values

true	Messages at level "lvl" will be printed

Definition at line 151 of file AthMessaging.h.

{
  if (m_lvl <= lvl) {
    msg() << lvl;
    return true;
  } else {
    return false;
  }
}

◆ name()

const std::string & pool::DbAccessObj< DbObject *, DbObjectHolder >::name ( ) const

inlineinherited

Access the instance name.

Definition at line 76 of file DbAccessObj.h.

76{ return m_name; }

◆ next()

DbStatus pool::DbContainerObj::next ( Token::OID_t & linkH )

Fetch next object address to set token.

◆ objectShape()

const DbTypeInfo * pool::DbContainerObj::objectShape ( const Guid & nam )

Retrieve persistent type information by name.

◆ open()

DbStatus pool::DbContainerObj::open ( const DbTypeInfo * typ )

Open the container.

◆ refCount()

int pool::DbAccessObj< DbObject *, DbObjectHolder >::refCount ( ) const

inlineinherited

Access reference counter.

Definition at line 89 of file DbAccessObj.h.

89{ return m_refCount; }

◆ release()

int pool::DbAccessObj< DbObject *, DbObjectHolder >::release ( ) const

inlineinherited

Remove reference count.

Definition at line 103 of file DbAccessObj.h.

                           {
      int count = --m_refCount;
#ifdef DEBUG_REFCOUNTS
      std::cout << typeid(*this).name() 
                << "  " 
                << m_name 
                << " Refcount:" 
                << count  
                << std::endl;
#endif
      if ( count == 0 )    {
        delete this;
      }
      return count;
    }

◆ remove()

DbStatus pool::DbAccessObj< DbObject *, DbObjectHolder >::remove ( const DbObjectHolder * val )

inlineinherited

Remove entry from container.

Definition at line 152 of file DbAccessObj.h.

                                        {
      for (iterator j = m_keys.begin(); j != m_keys.end(); ++j )    {
        if ( (*j).second == val ) {
          TYPE* p = (*j).second;
          m_keys.erase(j);
          p->release();
          return Success;
        }
      }
      return Error;
    }

◆ retire()

DbStatus pool::DbContainerObj::retire ( )

Retire the container.

◆ setLevel()

void AthMessaging::setLevel ( MSG::Level lvl )

inherited

Change the current logging level.

Use this rather than msg().setLevel() for proper operation with MT.

Definition at line 28 of file AthMessaging.cxx.

{
  m_lvl = lvl;
}

◆ setMode()

void pool::DbAccessObj< DbObject *, DbObjectHolder >::setMode ( DbAccessMode m )

inlineinherited

Set Access mode.

Definition at line 82 of file DbAccessObj.h.

82{ m_mode = m; }

◆ setName()

void pool::DbAccessObj< DbObject *, DbObjectHolder >::setName ( const std::string & n )

inlineinherited

Access the instance name.

Definition at line 78 of file DbAccessObj.h.

78{ m_name = n; }

◆ setOption()

DbStatus pool::DbContainerObj::setOption ( const DbOption & opt )

Pass options to the implementation.

◆ size() [1/2]

size_t pool::DbAccessObj< DbObject *, DbObjectHolder >::size ( ) const

inlineinherited

Object size.

Definition at line 119 of file DbAccessObj.h.

                            {
      return m_keys.size();
    }

◆ size() [2/2]

uint64_t pool::DbContainerObj::size ( )

Size of the Database container (=# of objects)

◆ store()

DbStatus pool::DbContainerObj::store	(	const void *	object,
		DbContainer &	cntH,
		ShapeH	shape )

Store object in location.

◆ token()

const Token * pool::DbContainerObj::token ( ) const

inline

Access the token of the container object.

Definition at line 86 of file DbContainerObj.h.

86{ return m_tokH; }

pool::DbContainerObj::m_tokH

const Token * m_tokH

Container token.

Definition DbContainerObj.h:55

◆ transAct()

DbStatus pool::DbContainerObj::transAct ( Transaction::Action )

Execute Database Transaction Action.

◆ type()

const DbType & pool::DbAccessObj< DbObject *, DbObjectHolder >::type ( ) const

inlineinherited

Definition at line 84 of file DbAccessObj.h.

84{ return m_type; }

Member Data Documentation

◆ ATLAS_THREAD_SAFE

std::atomic_flag m_initialized AthMessaging::ATLAS_THREAD_SAFE = ATOMIC_FLAG_INIT

mutableprivateinherited

Messaging initialized (initMessaging)

Definition at line 141 of file AthMessaging.h.

◆ m_dbH

DbDatabase pool::DbContainerObj::m_dbH

private

Handle to hosting Database.

Definition at line 57 of file DbContainerObj.h.

◆ m_imsg

std::atomic<IMessageSvc*> AthMessaging::m_imsg { nullptr }

mutableprivateinherited

MessageSvc pointer.

Definition at line 135 of file AthMessaging.h.

135{ nullptr };

◆ m_info

IDbContainer* pool::DbContainerObj::m_info

private

Pointer to interface of the technology dependent part.

Definition at line 53 of file DbContainerObj.h.

◆ m_isOpen

bool pool::DbContainerObj::m_isOpen

private

Flag indication DbStatus of technology dependent container.

Definition at line 59 of file DbContainerObj.h.

◆ m_keys

Keys pool::DbAccessObj< DbObject *, DbObjectHolder >::m_keys

privateinherited

Key entry buffer.

Definition at line 64 of file DbAccessObj.h.

◆ m_lvl

std::atomic<MSG::Level> AthMessaging::m_lvl { MSG::NIL }

mutableprivateinherited

Current logging level.

Definition at line 138 of file AthMessaging.h.

138{ MSG::NIL };

◆ m_mode

DbAccessMode pool::DbAccessObj< DbObject *, DbObjectHolder >::m_mode

privateinherited

Access mode.

Definition at line 58 of file DbAccessObj.h.

◆ m_msg_tls

boost::thread_specific_ptr<MsgStream> AthMessaging::m_msg_tls

mutableprivateinherited

MsgStream instance (a std::cout like with print-out levels)

Definition at line 132 of file AthMessaging.h.

◆ m_name

std::string pool::DbAccessObj< DbObject *, DbObjectHolder >::m_name

privateinherited

Name of the instance.

Definition at line 60 of file DbAccessObj.h.

◆ m_nm

std::string AthMessaging::m_nm

privateinherited

Message source name.

Definition at line 129 of file AthMessaging.h.

◆ m_pool

IOODatabase* pool::DbAccessObj< DbObject *, DbObjectHolder >::m_pool

privateinherited

Pointer to specific pool implementation.

Definition at line 66 of file DbAccessObj.h.

◆ m_refCount

std::atomic<int> pool::DbAccessObj< DbObject *, DbObjectHolder >::m_refCount

mutableprivateinherited

Reference counter.

Definition at line 56 of file DbAccessObj.h.

◆ m_tokH

const Token* pool::DbContainerObj::m_tokH

private

Container token.

Definition at line 55 of file DbContainerObj.h.

◆ m_type

DbType pool::DbAccessObj< DbObject *, DbObjectHolder >::m_type

privateinherited

Database type.

Definition at line 62 of file DbAccessObj.h.

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

DbContainerObj.h

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

◆ Base

◆ const_iterator

◆ iterator

◆ Keys

Constructor & Destructor Documentation

◆ DbContainerObj()

◆ ~DbContainerObj()

Member Function Documentation

◆ add()

◆ addRef()

◆ allocate()

◆ begin()

◆ cancelTransaction()

◆ checkAccess()

◆ clearEntries()

◆ close()

◆ database()

◆ db()

◆ end()

◆ find()

◆ getOption()

◆ hasAccess()

◆ info() [1/2]

◆ info() [2/2]

◆ initMessaging()

◆ isOpen()

◆ isReadOnly()

◆ load()

◆ mode()

◆ msg() [1/2]

◆ msg() [2/2]

◆ msgLvl()

◆ name()

◆ next()

◆ objectShape()

◆ open()

◆ refCount()

◆ release()

◆ remove()

◆ retire()

◆ setLevel()

◆ setMode()

◆ setName()

◆ setOption()

◆ size() [1/2]

◆ size() [2/2]

◆ store()

◆ token()

◆ transAct()

◆ type()

Member Data Documentation

◆ ATLAS_THREAD_SAFE

◆ m_dbH

◆ m_imsg

◆ m_info

◆ m_isOpen

◆ m_keys

◆ m_lvl

◆ m_mode

◆ m_msg_tls

◆ m_name

◆ m_nm

◆ m_pool

◆ m_refCount

◆ m_tokH

◆ m_type