pool::Collection Class Reference

Read-only collection implementation. More...

#include <Collection.h>

Inheritance diagram for pool::Collection:

Collaboration diagram for pool::Collection:

Public Member Functions
	Collection (FileDescriptor &fileDescr)
	Construct from an already-connected file descriptor.
	~Collection ()
	Defined out of line because CollectionColumn is incomplete here.
std::unique_ptr< CollectionCursor >	cursor ()
	Returns a cursor for the collection.
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
	Collection (const Collection &)=delete
Collection &	operator= (const Collection &)=delete
void	initMessaging () const
	Initialize our message level and MessageSvc.

Private Attributes
std::vector< CollectionColumn >	m_attributeColumns
std::map< std::string, DbContainer >	m_containerMap
	Map of container names to container handles for all EventTag attributes in the file.
DbContainer	m_dhCont
	The DataHeader container, if present, in the file.
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

Read-only collection implementation.

• Supports a single Token plus meta data attributes

Definition at line 26 of file Collection.h.

Constructor & Destructor Documentation

Collection() [1/2]

pool::Collection::Collection ( FileDescriptor & fileDescr )

explicit

Construct from an already-connected file descriptor.

Definition at line 30 of file Collection.cxx.

      : APRMessaging( "Collection")
      {
         if( !fileDescr.dbc() ) {
            throw std::runtime_error( "Collection: file must already be connected: " + fileDescr.PFN() );
         }
 
         // all errors are thrown as exceptions
         ATH_MSG_VERBOSE( "Opening collection '" << fileDescr.PFN() << "' in READ mode" );
 
         std::vector<const Token*> containerTokens;
         DbDatabase db( fileDescr.dbc()->handle() );
         if( !db.containers(containerTokens, false).isSuccess() ) {
            throw std::runtime_error( "Collection: error reading " + fileDescr.PFN() );
         }
         const std::string containerPrefix = APRDefaults::ReadConfig::getEventTagName( fileDescr.FID() );
         const std::string dhName = APRDefaults::ReadConfig::getDataHeaderName( fileDescr.FID() );
         const std::string newDHContName = std::format("{}({})", dhName, APRDefaults::DataHeaderTypeName);
         const std::string oldDHContName = std::format("{}_{}", dhName, APRDefaults::DataHeaderTypeName);
         ATH_MSG_DEBUG("Opening Collection '" << fileDescr.PFN() << "' using container prefix: " << containerPrefix );
         std::string tagContName = containerPrefix + "(";
         // it seems merged files report multiple instances of the same container - avoid trying to process duplicates
         std::set<std::string> seenContainers;
         for( const Token *t : containerTokens ) {
            Token token(t);      // need a non-const Token
            const std::string& contName = db.cntName(token);
            const DbTypeInfo* typ_info = db.objectShape( token.classID() );
            if( contName.starts_with( tagContName ) and !seenContainers.contains( contName ) ) {
               seenContainers.insert( contName );
               const std::string& attrName = contName.substr( tagContName.size(), contName.size() - tagContName.size() - 1 );
               ATH_MSG_DEBUG("  :container " << contName << " with attribute " << attrName << " of type: " << typ_info->clazz().Name());
               DbContainer cnt( db.type() );
               if( cnt.open( db, contName, typ_info, token.technology(), db.openMode() ).isSuccess() )  {
                  if( attrName != CollectionColumn::tokenColumn().name() ) {
                     const auto duplicate = std::find_if(
                        m_attributeColumns.begin(), m_attributeColumns.end(),
                        [&attrName]( const CollectionColumn& column ) {
                           return column.name() == attrName;
                        } );
                     if( duplicate != m_attributeColumns.end() ) {
                        throw std::runtime_error( "Column with name `" + attrName + "' already exists." );
                     }
                     m_attributeColumns.emplace_back( attrName, typ_info->clazz().Name() );
                  }
                  m_containerMap.emplace( attrName, std::move(cnt) );
               } else {
                  ATH_MSG_WARNING("EventTag container " << contName << " could not be opened");
               }
            } else if( contName == newDHContName || contName == oldDHContName ) {
               ATH_MSG_DEBUG("  :container " << contName << " is the DataHeader container");
               DbContainer cnt( db.type() );
               if( cnt.open( db, contName, typ_info, token.technology(), db.openMode() ).isSuccess() )  {
                  m_dhCont = std::move(cnt);
               } else {
                  ATH_MSG_WARNING("EventTag container " << contName << " could not be opened");
               }
            }
         }
      }

~Collection()

pool::Collection::~Collection ( )

default

Defined out of line because CollectionColumn is incomplete here.

Collection() [2/2]

pool::Collection::Collection ( const Collection & )

privatedelete

Member Function Documentation

cursor()

std::unique_ptr< CollectionCursor > pool::Collection::cursor

(

)

Returns a cursor for the collection.

Definition at line 91 of file Collection.cxx.

                                                      {
      if( m_containerMap.empty() ) {
         m_containerMap.emplace( APRDefaults::TokenTypeName, std::move(m_dhCont) );
      }
      pool::CollectionRowBuffer collectionRowBuffer;
      coral::AttributeList attributeList;
      for( const auto& attrCol : m_attributeColumns ) {
         attributeList.extend( attrCol.name(), attrCol.type() );
      }
      collectionRowBuffer.setAttributeList( attributeList );
      return std::make_unique<CollectionCursor>( collectionRowBuffer, m_containerMap);
   }

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;
  }
}

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 167 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 182 of file AthMessaging.h.

{ return msg() << lvl; }

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 user did not set explicit message level we have to initialize
  // the messaging and retrieve the default via the MessageSvc.
  if (m_lvl==MSG::NIL && !m_initialized.test_and_set()) initMessaging();
 
  if (m_lvl <= lvl) {
    msg() << lvl;
    return true;
  } else {
    return false;
  }
}

operator=()

Collection & pool::Collection::operator= ( const Collection & )

privatedelete

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;
}

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_attributeColumns

std::vector<CollectionColumn> pool::Collection::m_attributeColumns

private

Definition at line 42 of file Collection.h.

m_containerMap

std::map<std::string, DbContainer> pool::Collection::m_containerMap

private

Map of container names to container handles for all EventTag attributes in the file.

Definition at line 45 of file Collection.h.

m_dhCont

DbContainer pool::Collection::m_dhCont

private

The DataHeader container, if present, in the file.

Definition at line 47 of file Collection.h.

m_imsg

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

mutableprivateinherited

MessageSvc pointer.

Definition at line 135 of file AthMessaging.h.

{ nullptr };

m_lvl

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

mutableprivateinherited

Current logging level.

Definition at line 138 of file AthMessaging.h.

{ MSG::NIL };

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_nm

std::string AthMessaging::m_nm

privateinherited

Message source name.

Definition at line 129 of file AthMessaging.h.

---

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

• Collection.h
• Collection.cxx