CollectionDescription.h

Go to the documentation of this file.

/*
  Copyright (C) 2002-2025 CERN for the benefit of the ATLAS collaboration
*/
 
#ifndef COLLECTIONBASE_COLLECTIONDESCRIPTION_H
#define COLLECTIONBASE_COLLECTIONDESCRIPTION_H
 
#include "CollectionBase/ICollectionDescription.h"
 
#include <map>
#include <vector>
 
 
namespace pool {
 
  class CollectionColumn;
  
  class CollectionDescription : virtual public ICollectionDescription
  {
  public:
    CollectionDescription( const std::string& name,
                           const std::string& type,
                           const std::string& connection = "",
                           const std::string& eventReferenceColumnName = "" );
    
    CollectionDescription( const ICollectionDescription& rhs );
    CollectionDescription( const CollectionDescription& rhs );
 
    virtual ~CollectionDescription();
 
    CollectionDescription& operator=( const ICollectionDescription& rhs );
 
    // Redirect to the copy operator accepting interface reference
    CollectionDescription& operator=( const CollectionDescription& rhs )
    { operator=( (const ICollectionDescription&) rhs ); return *this; }
 
    // Force the use of the user-defined copy operator (the default one leaks)
    CollectionDescription& operator= (CollectionDescription&& rhs)
    { operator=( (const ICollectionDescription&) rhs ); return *this; }
 
    // Defaults should work for move.
    CollectionDescription (CollectionDescription&&) = default;
 
    virtual void setName( const std::string& name );
 
    virtual void setType( const std::string& type );
 
    virtual void setConnection( const std::string& connection );
 
    virtual void setEventReferenceColumnName( const std::string& columnName );
 
    virtual const ICollectionColumn&    insertColumn(
       const std::string& columnName, 
       const std::string& columnType,
       const std::string& annotation = "",
       int maxSize = 0,
       bool sizeIsFixed = true );
 
    virtual const ICollectionColumn&    insertTokenColumn(
       const std::string& columnName,
       const std::string& annotation = "");
    
 
    virtual const std::string& name() const;
 
    virtual const std::string& type() const;
 
    virtual const std::string& connection() const;
 
    virtual const std::string& eventReferenceColumnName() const;
 
    virtual int numberOfTokenColumns() const;
 
    virtual const ICollectionColumn& tokenColumn( int columnId ) const; 
 
    virtual int numberOfAttributeColumns() const;
 
    virtual const ICollectionColumn& attributeColumn( int columnId ) const;
 
    // set column ID, return the ID
    virtual int     setColumnId( const std::string& columnName, int id, const std::string& methodName );
    
 protected:
    // some helper methods for internal use:
 
    virtual void    copyFrom( const ICollectionDescription& rhs );
    
    // clear all internal structures
    virtual void    clearAll();
 
    // set or assign new column ID
    // return the ID
    virtual int     setColumnId( pool::CollectionColumn *column, int id = -1 );
 
    // rise an exception if the column aleready exists
    virtual void    checkNewColumnName( const std::string& name, const std::string& method ) const;
 
    // check if the column contains tokens
    virtual bool    isTokenColumn( const std::string& columnName, const std::string& method ) const;
 
    // this version includes the 'method name' in the error message
    virtual pool::CollectionColumn* column( const std::string& columnName, const std::string& methodName );
    virtual const pool::CollectionColumn* column( const std::string& columnName, const std::string& methodName ) const;
 
  private:
    std::string m_name;
 
    std::string m_type;
 
    std::string m_connection;
 
    std::string m_eventReferenceColumnName;
 
    // Token column description objects
    std::vector< pool::CollectionColumn* >  m_tokenColumns;
 
    std::vector< pool::CollectionColumn* >  m_attributeColumns;
 
    std::map< std::string, int > m_columnIdForColumnName;
 
    typedef     std::map< std::string, CollectionColumn* >      ColumnByName;
    ColumnByName        m_tokenColumnForColumnName;
 
    ColumnByName        m_attributeColumnForColumnName;
  };
}
 
#endif