Easy-to-use templated class for defining converters. More...

#include <TVirtualConverter.h>

Inheritance diagram for TVirtualConverter_T< TTrans, TPers >:

Collaboration diagram for TVirtualConverter_T< TTrans, TPers >:

Public Member Functions
	TVirtualConverter_T (TClass trans_cls=0, TClass pers_cls=0)
	Constructor, with class pointers. More...

	TVirtualConverter_T (UInt_t checksum, TClass trans_cls=0, TClass pers_cls=0)
	Constructor, with checksum and class pointers. More...

virtual void	ConvertVoid (void transobj, const void persobj)
	Do the conversion. More...

virtual void	Convert (TTrans transobj, const TPers persobj)=0
	Do the conversion. More...

TClass *	GetTransClass ()
	Return the transient class, to which we're converting. More...

TClass *	GetPersClass ()
	Return the persistent class, from which we're converting. More...

int	GetCheckSum () const
	Return the checksum of the class from which we're converting. More...

virtual void *	NewPersObj ()
	Create a new instance of the persistent class. More...

virtual void	DeletePersObj (void *persobj)
	Destroy an instance of the persistent class. More...

virtual void	ReadBuffer (TBuffer &b, void *obj, Version_t version, UInt_t R__S, UInt_t R__c)
	Read object in non-split mode. More...

Static Public Member Functions
static TClass *	ToClass (const std::string &name)
	Helper to convert a class name to a Root class pointer. More...

static TClass *	ToClass (const std::type_info &id)
	Helper to convert a `type_info` to a Root class pointer. More...

Protected Member Functions
void	SetCtorInfo (UInt_t checksum, TClass trans_cls, TClass pers_cls)
	Set the parameters that would normally be passed to the constructor. More...

Protected Attributes
void *	fPersObj
	The temporary persistent object instance, used for conversions (in non-split mode). More...

Private Member Functions
void	CheckStreamInfos ()
	Helper to allow for automatic schema evolution for persistent classes. More...

void	CheckClasses ()
	Helper to check that the classes have been defined properly. More...

Private Attributes
TClass *	fTransClass
	The declared transient class. More...

TClass *	fPersClass
	The declared persistent class. More...

UInt_t	fCheckSum
	The declared checksum. More...

int	fOldLast
	Used by `CheckStreamInfos:` the length of the streamerinfo list that we saw on the last `CheckStreamInfos` call. More...

Detailed Description

template<class TTrans, class TPers>
class TVirtualConverter_T< TTrans, TPers >

Easy-to-use templated class for defining converters.

The classes for the conversion are given by the TTrans and TPers template arguments. In the simple case, you shouldn't need to give any arguments to the constructor.

Definition at line 283 of file TVirtualConverter.h.

Constructor & Destructor Documentation

◆ TVirtualConverter_T() [1/2]

template<class TTrans , class TPers >

TVirtualConverter_T< TTrans, TPers >::TVirtualConverter_T	(	TClass *	trans_cls = `0`,
		TClass *	pers_cls = `0`
	)

Constructor, with class pointers.

Parameters

trans_cls	The transient class to which we will be converting.
pers_cls	The persistent class from which we will be converting.

The checksum will be calculated automatically from the provided classes.

If either of the class pointers is defaulted to 0, the class pointer will be computed from the appropriate template parameter.

◆ TVirtualConverter_T() [2/2]

template<class TTrans , class TPers >

TVirtualConverter_T< TTrans, TPers >::TVirtualConverter_T	(	UInt_t	checksum,
		TClass *	trans_cls = `0`,
		TClass *	pers_cls = `0`
	)

Constructor, with checksum and class pointers.

Parameters

checksum	The Root checksum of the persistent class we'll convert.
trans_cls	The transient class to which we will be converting.
pers_cls	The persistent class from which we will be converting.

If either of the class pointers is defaulted to 0, the class pointer will be computed from the appropriate template parameter.

Member Function Documentation

◆ CheckClasses()

void TVirtualConverter::CheckClasses ( )

privateinherited

Helper to check that the classes have been defined properly.

Check that the class pointers got defined.

Definition at line 189 of file TVirtualConverter.cxx.

 {
   if (fTransClass == 0) {
     if (fPersClass == 0)
       Error ("TVirtualConverter",
              "Both transient and persistent classes are null.");
     else
       Error ("TVirtualConverter",
              "Transient class is null for persistent class `%s'",
              fPersClass->GetName());
   }
   else if (fPersClass == 0)
     Error ("TVirtualConverter",
            "Persistent class is null for transient class `%s'",
            fTransClass->GetName());
 }

◆ CheckStreamInfos()

void TVirtualConverter::CheckStreamInfos ( )

privateinherited

Helper to allow for automatic schema evolution for persistent classes.

Automatic schema evolution doesn't work for persistent classes ‘out-of-the-box’ because we're reading the ‘persistent class’, but the relevant StreamerInfo stored in the file will have the name of the ‘transient class’.

This gets called each time we try to read an object (in non-split mode).

Definition at line 369 of file TVirtualConverter.cxx.

 {
   // First check to see if the list of TStreamerInfo's for the transient
   // class has changed since the last time we were called.  If not,
   // then don't do anything.
   const TObjArray* trans_sis = fTransClass->GetStreamerInfos();
   if (trans_sis->GetLast() != fOldLast) {
     // There was a change.  Compare the TStreamerInfo list for the
     // persistent class and the transient class.  Look for entries
     // where the transient class has a TStreamerInfo but the persistent
     // class does not.
     //
     // Note: don't do this for `version' -1.
     // That should always be built from the internal dictionary.
     // (Otherwise, root can crash.)
     const TObjArray* pers_sis = fPersClass->GetStreamerInfos();
     assert (trans_sis->LowerBound() == pers_sis->LowerBound());
     for (Int_t v = trans_sis->LowerBound(); v <= trans_sis->GetLast(); ++v) {
       if (v != -1 &&
           trans_sis->At(v) != 0 &&
           (v > pers_sis->GetLast() || pers_sis->At(v) == 0))
       {
         // Ok, at this index, the transient class has a TStreamerInfo
         // but the persistent class does not.  Copy the TStreamerInfo
         // (changing the class that it applies to to the persistent
         // class), and add it to the persistent class's list.
         TStreamerInfo* new_si =(TStreamerInfo*)(trans_sis->At(v)->Clone());
         new_si->SetClass (fPersClass);
         fPersClass->RegisterStreamerInfo (new_si);
       }
     }
  
     // Remember how many entries there were in the list for next time.
     fOldLast = trans_sis->GetLast();
   }
 }

◆ Convert()

template<class TTrans , class TPers >

virtual void TVirtualConverter_T< TTrans, TPers >::Convert	(	TTrans *	transobj,
		const TPers *	persobj
	)

pure virtual

Do the conversion.

Parameters

transobj	Pointer to an instance of the transient class.
persobj	Pointer to an instance of the persistent class.

An implementation of this must be provided in derived classes. It should initialize the object at transobj from the one at persobj.

Implemented in TrigSpacePointCounts_p1_old_cnv, TrigInDetTrackTruthMap_old_cnv, TauJetContainer_p1_old_cnv, and DetDescrCondIdentifier_old_cnv.

◆ ConvertVoid()

template<class TTrans , class TPers >

virtual void TVirtualConverter_T< TTrans, TPers >::ConvertVoid	(	void *	transobj,
		const void *	persobj
	)

virtual

Do the conversion.

Parameters

transobj	Pointer to an instance of the transient class.
persobj	Pointer to an instance of the persistent class.

This implementation simply calls the Convert below with the appropriate casting.

Implements TVirtualConverter.

◆ DeletePersObj()

void TVirtualConverter::DeletePersObj ( void * persobj )

virtualinherited

Destroy an instance of the persistent class.

Parameters

persobj Pointer to the instance to destroy.

The provided implementation of this uses TClass::Destructor, but you can override it if need be.

Definition at line 264 of file TVirtualConverter.cxx.

 {
   return fPersClass->Destructor (persobj);
 }

◆ GetCheckSum()

int TVirtualConverter::GetCheckSum ( ) const

inherited

Return the checksum of the class from which we're converting.

Definition at line 239 of file TVirtualConverter.cxx.

 {
   return fCheckSum;
 }

◆ GetPersClass()

TClass * TVirtualConverter::GetPersClass ( )

inherited

Return the persistent class, from which we're converting.

Definition at line 230 of file TVirtualConverter.cxx.

 {
   return fPersClass;
 }

◆ GetTransClass()

TClass * TVirtualConverter::GetTransClass ( )

inherited

Return the transient class, to which we're converting.

Definition at line 221 of file TVirtualConverter.cxx.

 {
   return fTransClass;
 }

◆ NewPersObj()

void * TVirtualConverter::NewPersObj ( )

virtualinherited

Create a new instance of the persistent class.

The provided implementation of this uses TClass::New, but you can override it if need be.

Definition at line 251 of file TVirtualConverter.cxx.

 {
   return fPersClass->New();
 }

◆ ReadBuffer()

void TVirtualConverter::ReadBuffer	(	TBuffer &	b,
		void *	obj,
		Version_t	version,
		UInt_t	R__s,
		UInt_t	R__c
	)

virtualinherited

Read object in non-split mode.

Parameters

b	The source of the data.
obj	The object into which we're reading. (This will be the transient object.)
version	The version number of the class.
R__s	The starting position in the buffer.
R__c	The number of bytes for this object in the buffer.

You normally shouldn't have to worry about this, but it's exposed here so that it can be overridden if needed. It's only used when reading in non-split mode.

Definition at line 283 of file TVirtualConverter.cxx.

 {
   // Make sure that we've done automatic schema evolution on the
   // persistent side.
   CheckStreamInfos();
  
   // Make an instance of the persistent class, if we haven't done so already.
   if (fPersObj == 0)
     fPersObj = NewPersObj();
  
   // Read in the object, as an instance of the persistent class.
   fPersClass->ReadBuffer (b, fPersObj, version, R__s, R__c);
  
   // Convert to the transient representation.
   ConvertVoid (obj, fPersObj);
 }

◆ SetCtorInfo()

void TVirtualConverter::SetCtorInfo	(	UInt_t	checksum,
		TClass *	trans_cls,
		TClass *	pers_cls
	)

protectedinherited

Set the parameters that would normally be passed to the constructor.

Parameters

checksum	The Root checksum of the persistent class we'll convert.
trans_cls	The transient class to which we will be converting.
pers_cls	The persistent class from which we will be converting.

Intended for use with T_AthenaRootConverter only!

Definition at line 431 of file TVirtualConverter.cxx.

 {
   assert (fTransClass == 0);
  
   fCheckSum = checksum;
   fTransClass = trans_cls;
   fPersClass = pers_cls;
   CheckClasses();
 }

◆ ToClass() [1/2]

TClass * TVirtualConverter::ToClass ( const std::string & name )

staticinherited

Helper to convert a class name to a Root class pointer.

Parameters

name	The name of the class to convert.

Returns 0 on failure.

Definition at line 311 of file TVirtualConverter.cxx.

 {
   return gROOT->GetClass (name.c_str());
 }

◆ ToClass() [2/2]

TClass * TVirtualConverter::ToClass ( const std::type_info & id )

staticinherited

Helper to convert a type_info to a Root class pointer.

Parameters

name	The `type_info` of the class to convert.

Returns 0 on failure.

Definition at line 323 of file TVirtualConverter.cxx.

 {
   TClass* cl = gROOT->GetClass (id);
   if (cl) return cl;
  
   // This may fail if the dictionary hasn't been loaded yet,
   // since we can auto-load only on the name.
   // Make some attempt to get a name from the type_info.
   const char* name = id.name();
   cl = gROOT->GetClass (name);
   if (cl) return cl;
  
   const char* n2 = name;
   while (isdigit(*n2))
     ++n2;
   cl = gROOT->GetClass (n2);
   if (cl) return cl;
  
   int errorCode = 0;
   char* demname = nullptr;
   {
     // Protect against data race inside TClassEdit.
     // https://github.com/root-project/root/issues/10353
     // Should be fixed in root 6.26.02.
     R__WRITE_LOCKGUARD(ROOT::gCoreMutex);
     demname = TClassEdit::DemangleTypeIdName (id, errorCode);
   }
   if (demname) {
     cl = gROOT->GetClass (demname);
     free (demname);
   }
   return cl;
 }

Member Data Documentation

◆ fCheckSum

UInt_t TVirtualConverter::fCheckSum

privateinherited

The declared checksum.

Definition at line 261 of file TVirtualConverter.h.

◆ fOldLast

int TVirtualConverter::fOldLast

privateinherited

Used by CheckStreamInfos: the length of the streamerinfo list that we saw on the last CheckStreamInfos call.

Definition at line 265 of file TVirtualConverter.h.

◆ fPersClass

TClass* TVirtualConverter::fPersClass

privateinherited

The declared persistent class.

Definition at line 258 of file TVirtualConverter.h.

◆ fPersObj

void* TVirtualConverter::fPersObj

protectedinherited

The temporary persistent object instance, used for conversions (in non-split mode).

Definition at line 271 of file TVirtualConverter.h.

◆ fTransClass

TClass* TVirtualConverter::fTransClass

privateinherited

The declared transient class.

Definition at line 255 of file TVirtualConverter.h.

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

TVirtualConverter.h

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

template<class TTrans, class TPers> class TVirtualConverter_T< TTrans, TPers >

Constructor & Destructor Documentation

◆ TVirtualConverter_T() [1/2]

◆ TVirtualConverter_T() [2/2]

Member Function Documentation

◆ CheckClasses()

◆ CheckStreamInfos()

◆ Convert()

◆ ConvertVoid()

◆ DeletePersObj()

◆ GetCheckSum()

◆ GetPersClass()

◆ GetTransClass()

◆ NewPersObj()

◆ ReadBuffer()

◆ SetCtorInfo()

◆ ToClass() [1/2]

◆ ToClass() [2/2]

Member Data Documentation

◆ fCheckSum

◆ fOldLast

◆ fPersClass

◆ fPersObj

◆ fTransClass

template<class TTrans, class TPers>
class TVirtualConverter_T< TTrans, TPers >