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 (std::string &&auxString)
	Set auxiliary string.
void	setAuxString (std::string_view auxString)
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 22 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 38 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 28 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 49 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 62 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 76 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 63 of file Token.h.

63{ return ++m_refCount; }

◆ auxString()

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

inline

Access auxiliary string.

Definition at line 92 of file Token.h.

92{ return m_auxString; }

◆ classID()

const Guid & Token::classID ( ) const

inline

Access database identifier.

Definition at line 74 of file Token.h.

74{ return m_classID; }

◆ contID()

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

inline

Access container identifier.

Definition at line 70 of file Token.h.

70{ return m_cntID; }

◆ dbID()

const Guid & Token::dbID ( ) const

inline

Access database identifier.

Definition at line 65 of file Token.h.

65{ return m_dbID; }

◆ equal()

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

virtual

Fast token comparison: operator equals.

Equality operator.

Definition at line 98 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 169 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 228 of file Token.cxx.

                                 {
   //Do not replace with std::format unless it is found to be more performant
   // m_technology & KEY_MASK yields an unsigned int -> 8 hex digits
   CxxUtils::HexString<"[TECH={}]"> techHex(m_technology & KEY_MASK);
 
   std::string res;
   // "[DB=" (4) + Guid (36) + "][CNT=" (6) + CNT + "][CLID=" (7) + Guid (36) + "]" (1) 
   res.reserve(4 + 36 + 6 + m_cntID.size() + 7 + 36 + 1 + techHex.size());
   
   res += "[DB=";
   size_t pos = res.size();
   res.resize(pos + 36);
   m_dbID.toString(std::span<char, 36>(res.data() + pos, 36));
   
   res += "][CNT=";
   res += m_cntID;
   
   res += "][CLID=";
   pos = res.size();
   res.resize(pos + 36);
   m_classID.toString(std::span<char, 36>(res.data() + pos, 36));
   res += ']';
   
   res += static_cast<std::string_view>(techHex);
   
   return res;
}

◆ less()

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

virtual

Fast token comparison: operator less.

Operator to allow ordering.

Definition at line 115 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 25 of file Token.cxx.

25{ return s_numCount; }

◆ oid() [1/2]

OID_t & Token::oid ( )

inline

Access object identifier.

Definition at line 84 of file Token.h.

84{ return m_oid; }

◆ oid() [2/2]

const OID_t & Token::oid ( ) const

inline

Access object identifier.

Definition at line 82 of file Token.h.

82{ return m_oid; }

◆ operator!=()

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

inline

Equality operator.

Definition at line 55 of file Token.h.

55{ return !equal(refToken); }

Token::equal

virtual bool equal(const Token &pTok) const

Fast token comparison: operator equals.

Definition Token.cxx:98

◆ operator<()

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

inline

Operator < to allow ordering.

Definition at line 46 of file Token.h.

46{ return less(refToken); }

Token::less

virtual bool less(const Token &pTok) const

Fast token comparison: operator less.

Definition Token.cxx:115

◆ operator=()

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

private

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

Assignment operator.

Definition at line 90 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 53 of file Token.h.

53{ return equal(refToken); }

◆ operator>()

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

inline

Operator > to allow ordering.

Definition at line 48 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 81 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 256 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() [1/2]

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

inline

Set auxiliary string.

Definition at line 94 of file Token.h.

94{ m_auxString = std::move(auxString); return *this; }

Token::auxString

const std::string & auxString() const

Access auxiliary string.

Definition Token.h:92

◆ setAuxString() [2/2]

void Token::setAuxString ( std::string_view auxString )

inline

Definition at line 95 of file Token.h.

95{ m_auxString = auxString; }

◆ setClassID()

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

inline

Access database identifier.

Definition at line 76 of file Token.h.

76{ m_classID = cl_id; return *this; }

◆ setCont()

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

inline

Set container name.

Definition at line 72 of file Token.h.

72{ m_cntID = cnt; return *this; }

◆ setData()

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

Set all the data part of the token.

Definition at line 265 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 67 of file Token.h.

67{ 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 68 of file Token.h.

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

◆ setOid()

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

inline

Set object identifier.

Definition at line 86 of file Token.h.

86{ m_oid = oid; return *this; }

Token::oid

const OID_t & oid() const

Access object identifier.

Definition Token.h:82

◆ setTechnology()

Token & Token::setTechnology ( int t )

inline

Set technology type.

Definition at line 80 of file Token.h.

80{ m_technology = t; return *this; }

read_hist_ntuple.t

t

Definition read_hist_ntuple.py:8

◆ setType()

Token & Token::setType ( int t )

inline

Set token type.

Definition at line 90 of file Token.h.

90{ m_type = t; return *this; }

◆ technology()

int Token::technology ( ) const

inline

Access technology type.

Definition at line 78 of file Token.h.

78{ return m_technology; }

◆ toString()

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

virtual

Retrieve the string representation of the token.

Definition at line 135 of file Token.cxx.

                                      {
// Pre-compute the hex representations using the format strings
   CxxUtils::HexString<"[TECH={}]"> techHex(m_technology);
   CxxUtils::HexString<"[OID={}-"> oid1Hex(static_cast<uint64_t>(m_oid.first));
   CxxUtils::HexString<"{}]"> oid2Hex(static_cast<uint64_t>(m_oid.second));
 
   std::string res;
   // Reserve exact capacity to prevent reallocations. 
   // "[DB=" (4) + Guid (36) + "][CNT=" (6) + CNT + "][CLID=" (7) + Guid (36) + "]" (1) 
   res.reserve(4 + 36 + 6 + m_cntID.size() + 7 + 36 + 1 + 
               techHex.size() + oid1Hex.size() + oid2Hex.size() + m_auxString.size());
   
   res += "[DB=";
   size_t pos = res.size();
   res.resize(pos + 36);
   m_dbID.toString(std::span<char, 36>(res.data() + pos, 36));
   
   res += "][CNT=";
   res += m_cntID;
   
   res += "][CLID=";
   pos = res.size();
   res.resize(pos + 36);
   m_classID.toString(std::span<char, 36>(res.data() + pos, 36));
   res += ']';
   
   res += static_cast<std::string_view>(techHex);
   res += static_cast<std::string_view>(oid1Hex);
   res += static_cast<std::string_view>(oid2Hex);
   res += m_auxString;
   
   return res;
}

◆ type()

int Token::type ( ) const

inline

Access token type.

Definition at line 88 of file Token.h.

88{ return m_type; }

Member Data Documentation

◆ m_auxString

std::string Token::m_auxString

private

Auxiliary string.

Definition at line 127 of file Token.h.

◆ m_classID

Guid Token::m_classID

private

Object global identifier.

Definition at line 121 of file Token.h.

◆ m_cntID

std::string Token::m_cntID

private

Container identifier.

Definition at line 119 of file Token.h.

◆ m_dbID

Guid Token::m_dbID

private

Database identifier.

Definition at line 117 of file Token.h.

◆ m_oid

OID_t Token::m_oid

private

Persistent object identifier.

Definition at line 123 of file Token.h.

◆ m_refCount

int Token::m_refCount

private

Reference count.

Definition at line 113 of file Token.h.

◆ m_technology

unsigned int Token::m_technology

private

Technology identifier.

Definition at line 115 of file Token.h.

◆ m_type

int Token::m_type

private

Token type.

Definition at line 125 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() [1/2]

◆ setAuxString() [2/2]

◆ 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