This class provides a token that identifies in a unique way objects on the persistent storage. More...

#include <Token.h>

Collaboration diagram for Token:

Classes
struct	OID_t

Public Member Functions
	Token ()
	Standard Constructor.
	Token (const Token *source)
	Constructor with data assignment.
	Token (Token &&source) noexcept
	Allow move.
virtual	~Token ()
	Standard destructor: release all allocated resources.
bool	operator< (const Token &refToken) const
	Operator < to allow ordering.
bool	operator> (const Token &refToken) const
	Operator > to allow ordering.
bool	operator== (const Token &refToken) const
	Equality operator.
bool	operator!= (const Token &refToken) const
	Equality operator.
virtual bool	less (const Token &pTok) const
	Fast token comparison: operator less.
virtual bool	equal (const Token &pTok) const
	Fast token comparison: operator equals.
int	release ()
	Release token: Decrease reference count and eventually delete.
int	addRef ()
	Increase reference count.
const Guid &	dbID () const
	Access database identifier.
Token &	setDb (const Guid &db)
	Set database name.
Token &	setDb (const std::string &db)
const std::string &	contID () const
	Access container identifier.
Token &	setCont (const std::string &cnt)
	Set container name.
const Guid &	classID () const
	Access database identifier.
Token &	setClassID (const Guid &cl_id)
	Access database identifier.
int	technology () const
	Access technology type.
Token &	setTechnology (int t)
	Set technology type.
const OID_t &	oid () const
	Access object identifier.
OID_t &	oid ()
	Access object identifier.
Token &	setOid (const OID_t &oid)
	Set object identifier.
int	type () const
	Access token type.
Token &	setType (int t)
	Set token type.
const std::string &	auxString () const
	Access auxiliary string.
Token &	setAuxString (const std::string &auxString)
	Set auxiliary string.
virtual const std::string	toString () const
	Retrieve the string representation of the token.
virtual const std::string	key () const
	Retrieve token key.
Token &	fromString (const std::string_view from)
	Build from the string representation of a token.
const Token &	set (Token *pToken) const
	Set token information.
const Token &	setData (Token *pToken) const
	Set all the data part of the token.

Static Public Member Functions
static int	numInstances ()
	expose Token instance counter for debugging

Private Member Functions
	Token (const Token &copy)
	No copy allowed: put prototype to disable bit-wise copy.
Token &	operator= (const Token &copy)
	No assignment allowed: put prototype to disable bit-wise assignment.

Private Attributes
int	m_refCount
	Reference count.
unsigned int	m_technology
	Technology identifier.
Guid	m_dbID
	Database identifier.
std::string	m_cntID
	Container identifier.
Guid	m_classID
	Object global identifier.
OID_t	m_oid
	Persistent object identifier.
int	m_type
	Token type.
std::string	m_auxString
	Auxiliary string.

Detailed Description

This class provides a token that identifies in a unique way objects on the persistent storage.

Definition at line 21 of file Token.h.

Constructor & Destructor Documentation

◆ Token() [1/4]

Token::Token ( const Token & copy )

private

No copy allowed: put prototype to disable bit-wise copy.

Copy constructor.

Definition at line 37 of file Token.cxx.

                              : m_refCount(1),
    m_technology(copy.m_technology),
    m_dbID(copy.m_dbID),
    m_classID(copy.m_classID),
    m_oid(copy.m_oid),
    m_type(0) {
   copy.setData(this);
   s_numCount.fetch_add(1, std::memory_order_relaxed);
}

◆ Token() [2/4]

Token::Token ( )

Standard Constructor.

Standard Constructor(1): Empty constructor.

Definition at line 27 of file Token.cxx.

             : m_refCount(1),
    m_technology(0),
    m_dbID(Guid::null()),
    m_classID(Guid::null()),
    m_oid(OID_t(~0x0LL, ~0x0LL)),
    m_type(0) {
   s_numCount.fetch_add(1, std::memory_order_relaxed);
}

◆ Token() [3/4]

Token::Token ( const Token * source )

explicit

Constructor with data assignment.

Copy constructor.

Definition at line 48 of file Token.cxx.

                                : m_refCount(1),
    m_technology(0),
    m_dbID(Guid::null()),
    m_classID(Guid::null()),
    m_oid(OID_t(~0x0LL, ~0x0LL)),
    m_type(0) {
   if (source != 0) {
      source->setData(this);
   }
   s_numCount.fetch_add(1, std::memory_order_relaxed);
}

◆ Token() [4/4]

Token::Token ( Token && source )

explicitnoexcept

Allow move.

Move constructor.

Definition at line 61 of file Token.cxx.

  : m_refCount (1),
    m_technology (source.m_technology),
    m_dbID (std::move (source.m_dbID)),
    m_cntID (std::move (source.m_cntID)),
    m_classID (std::move (source.m_classID)),
    m_oid (std::move (source.m_oid)),
    m_type (source.m_type),
    m_auxString (std::move (source.m_auxString))
{
   s_numCount.fetch_add(1, std::memory_order_relaxed);
}

◆ ~Token()

Token::~Token ( )

virtual

Standard destructor: release all allocated resources.

Definition at line 75 of file Token.cxx.

              {
   s_numCount.fetch_sub(1, std::memory_order_relaxed);
}

Member Function Documentation

◆ addRef()

int Token::addRef ( )

inline

Increase reference count.

Definition at line 62 of file Token.h.

62{ return ++m_refCount; }

◆ auxString()

const std::string & Token::auxString ( ) const

inline

Access auxiliary string.

Definition at line 91 of file Token.h.

91{ return m_auxString; }

◆ classID()

const Guid & Token::classID ( ) const

inline

Access database identifier.

Definition at line 73 of file Token.h.

73{ return m_classID; }

◆ contID()

const std::string & Token::contID ( ) const

inline

Access container identifier.

Definition at line 69 of file Token.h.

69{ return m_cntID; }

◆ dbID()

const Guid & Token::dbID ( ) const

inline

Access database identifier.

Definition at line 64 of file Token.h.

64{ return m_dbID; }

◆ equal()

bool Token::equal ( const Token & pTok ) const

virtual

Fast token comparison: operator equals.

Equality operator.

Definition at line 97 of file Token.cxx.

                                         {
   if (&copy != this) {
      if (m_oid.second == copy.m_oid.second) {
         if (m_classID == copy.m_classID) {
            if (m_dbID == copy.m_dbID) {
               if (m_cntID == copy.m_cntID) {
                  return true;
               }
            }
         }
      }
      return false;
   }
   return true;
}

◆ fromString()

Token & Token::fromString ( const std::string_view from )

Build from the string representation of a token.

Definition at line 147 of file Token.cxx.

                                                    {
   m_auxString.clear();
   size_t pos = 0;
   while (pos < src.size()) {
      size_t start = src.find('[', pos);
      if (start == std::string_view::npos) break;
      size_t eq = src.find('=', start);
      size_t end = src.find(']', start);
      if (eq != std::string_view::npos && end != std::string_view::npos) {
         std::string_view label = src.substr(start, eq - start + 1);
         if (label == LABEL_DB) {
               m_dbID.fromString(src.substr(eq + 1, end - eq - 1));
         } else if (label == LABEL_CNT) {
               m_cntID = std::string(src.substr(eq + 1, end - eq - 1));
         } else if (label == LABEL_CLID) {
               m_classID.fromString(src.substr(eq + 1, end - eq - 1));
         } else if (label == LABEL_TECH) {
               std::string_view num_str = src.substr(eq + 1, end - eq - 1);
               int tech = 0;
               std::from_chars(num_str.data(), num_str.data() + num_str.size(), tech, 16);
               m_technology = tech;
         } else if (label == LABEL_OID) {
               std::string_view oid_str = src.substr(eq + 1, end - eq - 1);
               size_t dash = oid_str.find('-');
               if (dash != std::string_view::npos) {
                  std::string_view first_str = oid_str.substr(0, dash);
                  std::string_view second_str = oid_str.substr(dash + 1);
 
                  // Check if this is legacy format (8 digits) vs modern format (16 digits)
                  // Legacy format: 5 + 8 + 1 + 8 + 1 = 23 characters total for [OID=XXXXXXXX-XXXXXXXX]
                  // Modern format: 5 + 16 + 1 + 16 + 1 = 39 characters total for [OID=XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX]
                  bool is_legacy = (end - start + 1) == 23; // Total bracket length check
 
                  uint64_t first = 0;
                  uint64_t second = 0;
                  std::from_chars(first_str.data(), first_str.data() + first_str.size(), first, 16);
                  std::from_chars(second_str.data(), second_str.data() + second_str.size(), second, 16);
 
                  if (is_legacy) {
                     // Handle legacy format: extend 32-bit ~0x0 to 64-bit ~0x0LL
                     if (static_cast<uint32_t>(first) == ~0x0U) first = ~0x0ULL;
                     if (static_cast<uint32_t>(second) == ~0x0U) second = ~0x0ULL;
                  }
 
                  m_oid.first = static_cast<long long int>(first);
                  m_oid.second = static_cast<long long int>(second);
               }
         } else {
               m_auxString += src.substr(start, end - start + 1);
         }
         pos = end + 1;
      } else {
         break;
      }
   }
   return *this;
}

◆ key()

const std::string Token::key ( ) const

virtual

Retrieve token key.

Retrieve the string representation of the token.

Definition at line 206 of file Token.cxx.

                                 {
   return std::format(
      "[DB={}][CNT={}][CLID={}][TECH={:08X}]",
      m_dbID.to_fixed_string(),
      m_cntID,
      m_classID.to_fixed_string(),
      m_technology & KEY_MASK
   );
}

◆ less()

bool Token::less ( const Token & pTok ) const

virtual

Fast token comparison: operator less.

Operator to allow ordering.

Definition at line 114 of file Token.cxx.

                                        {
   if (&copy != this) {
      if (m_oid.second < copy.m_oid.second)
         return true;
      else if (m_oid.second > copy.m_oid.second)
         return false;
      if (!(m_classID == copy.m_classID)) {
         return (m_classID < copy.m_classID);
      }
      if (!(m_dbID == copy.m_dbID)) {
         return (m_dbID < copy.m_dbID);
      }
      int res = m_cntID.compare(copy.m_cntID);
      if (res != 0) {
         return (res < 0);
      }
   }
   return false;
}

◆ numInstances()

int Token::numInstances ( )

static

expose Token instance counter for debugging

Definition at line 24 of file Token.cxx.

24{ return s_numCount; }

◆ oid() [1/2]

OID_t & Token::oid ( )

inline

Access object identifier.

Definition at line 83 of file Token.h.

83{ return m_oid; }

◆ oid() [2/2]

const OID_t & Token::oid ( ) const

inline

Access object identifier.

Definition at line 81 of file Token.h.

81{ return m_oid; }

◆ operator!=()

bool Token::operator!= ( const Token & refToken ) const

inline

Equality operator.

Definition at line 54 of file Token.h.

54{ return !equal(refToken); }

Token::equal

virtual bool equal(const Token &pTok) const

Fast token comparison: operator equals.

Definition Token.cxx:97

◆ operator<()

bool Token::operator< ( const Token & refToken ) const

inline

Operator < to allow ordering.

Definition at line 45 of file Token.h.

45{ return less(refToken); }

Token::less

virtual bool less(const Token &pTok) const

Fast token comparison: operator less.

Definition Token.cxx:114

◆ operator=()

Token & Token::operator= ( const Token & copy )

private

No assignment allowed: put prototype to disable bit-wise assignment.

Assignment operator.

Definition at line 89 of file Token.cxx.

                                         {
  if (&copy != this) {
     copy.setData(this);
  }
  return *this;
}

◆ operator==()

bool Token::operator== ( const Token & refToken ) const

inline

Equality operator.

Definition at line 52 of file Token.h.

52{ return equal(refToken); }

◆ operator>()

bool Token::operator> ( const Token & refToken ) const

inline

Operator > to allow ordering.

Definition at line 47 of file Token.h.

                                               { 
      if (less(refToken)) return false;
      return !equal(refToken);
   }

◆ release()

int Token::release ( )

Release token: Decrease reference count and eventually delete.

Definition at line 80 of file Token.cxx.

                   {
   int cnt = --m_refCount;
   if (0 >= cnt) {
      delete this;
   }
   return cnt;
}

◆ set()

const Token & Token::set ( Token * pToken ) const

Set token information.

Definition at line 216 of file Token.cxx.

                                           {
   pToken->m_technology = m_technology;
   pToken->m_dbID = m_dbID;
   pToken->m_cntID = m_cntID;
   pToken->m_classID = m_classID;
   pToken->m_oid.first = m_oid.first;
   return *this;
}

◆ setAuxString()

Token & Token::setAuxString ( const std::string & auxString )

inline

Set auxiliary string.

Definition at line 93 of file Token.h.

93{ m_auxString = auxString; return *this; }

Token::auxString

const std::string & auxString() const

Access auxiliary string.

Definition Token.h:91

◆ setClassID()

Token & Token::setClassID ( const Guid & cl_id )

inline

Access database identifier.

Definition at line 75 of file Token.h.

75{ m_classID = cl_id; return *this; }

◆ setCont()

Token & Token::setCont ( const std::string & cnt )

inline

Set container name.

Definition at line 71 of file Token.h.

71{ m_cntID = cnt; return *this; }

◆ setData()

const Token & Token::setData ( Token * pToken ) const

Set all the data part of the token.

Definition at line 225 of file Token.cxx.

                                               {
   this->set(pToken);
   pToken->m_oid.second = m_oid.second;
   pToken->m_type = m_type;
   pToken->m_auxString = m_auxString;
   return *this;
}

◆ setDb() [1/2]

Token & Token::setDb ( const Guid & db )

inline

Set database name.

Definition at line 66 of file Token.h.

66{ m_dbID = db; return *this; }

CaloCondBlobAlgs_fillNoiseFromASCII.db

db

Definition CaloCondBlobAlgs_fillNoiseFromASCII.py:42

◆ setDb() [2/2]

Token & Token::setDb ( const std::string & db )

inline

Definition at line 67 of file Token.h.

67{ m_dbID.fromString(db); return *this; }

◆ setOid()

Token & Token::setOid ( const OID_t & oid )

inline

Set object identifier.

Definition at line 85 of file Token.h.

85{ m_oid = oid; return *this; }

Token::oid

const OID_t & oid() const

Access object identifier.

Definition Token.h:81

◆ setTechnology()

Token & Token::setTechnology ( int t )

inline

Set technology type.

Definition at line 79 of file Token.h.

79{ m_technology = t; return *this; }

read_hist_ntuple.t

t

Definition read_hist_ntuple.py:5

◆ setType()

Token & Token::setType ( int t )

inline

Set token type.

Definition at line 89 of file Token.h.

89{ m_type = t; return *this; }

◆ technology()

int Token::technology ( ) const

inline

Access technology type.

Definition at line 77 of file Token.h.

77{ return m_technology; }

◆ toString()

const std::string Token::toString ( ) const

virtual

Retrieve the string representation of the token.

Definition at line 134 of file Token.cxx.

                                      {
   return std::format(
      "[DB={}][CNT={}][CLID={}][TECH={:08X}][OID={:016X}-{:016X}]{}",
      m_dbID.to_fixed_string(),
      m_cntID,
      m_classID.to_fixed_string(),
      m_technology,
      static_cast<uint64_t>(m_oid.first),
      static_cast<uint64_t>(m_oid.second),
      m_auxString
   );
}

◆ type()

int Token::type ( ) const

inline

Access token type.

Definition at line 87 of file Token.h.

87{ return m_type; }

Member Data Documentation

◆ m_auxString

std::string Token::m_auxString

private

Auxiliary string.

Definition at line 125 of file Token.h.

◆ m_classID

Guid Token::m_classID

private

Object global identifier.

Definition at line 119 of file Token.h.

◆ m_cntID

std::string Token::m_cntID

private

Container identifier.

Definition at line 117 of file Token.h.

◆ m_dbID

Guid Token::m_dbID

private

Database identifier.

Definition at line 115 of file Token.h.

◆ m_oid

OID_t Token::m_oid

private

Persistent object identifier.

Definition at line 121 of file Token.h.

◆ m_refCount

int Token::m_refCount

private

Reference count.

Definition at line 111 of file Token.h.

◆ m_technology

unsigned int Token::m_technology

private

Technology identifier.

Definition at line 113 of file Token.h.

◆ m_type

int Token::m_type

private

Token type.

Definition at line 123 of file Token.h.

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

Classes

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Token() [1/4]

◆ Token() [2/4]

◆ Token() [3/4]

◆ Token() [4/4]

◆ ~Token()

Member Function Documentation

◆ addRef()

◆ auxString()

◆ classID()

◆ contID()

◆ dbID()

◆ equal()

◆ fromString()

◆ key()

◆ less()

◆ numInstances()

◆ oid() [1/2]

◆ oid() [2/2]

◆ operator!=()

◆ operator<()

◆ operator=()

◆ operator==()

◆ operator>()

◆ release()

◆ set()

◆ setAuxString()

◆ setClassID()

◆ setCont()

◆ setData()

◆ setDb() [1/2]

◆ setDb() [2/2]

◆ setOid()

◆ setTechnology()

◆ setType()

◆ technology()

◆ toString()

◆ type()

Member Data Documentation

◆ m_auxString

◆ m_classID

◆ m_cntID

◆ m_dbID

◆ m_oid

◆ m_refCount

◆ m_technology

◆ m_type