TRefTable

class TRefTable : public TObject

    protected:

              Int_t AddInternalIdxForPID(TProcessID* procid)
      virtual Int_t ExpandForIID(Int_t iid, Int_t newsize)
               void ExpandPIDs(Int_t numpids)
              Int_t FindPIDGUID(const char* guid) const
              Int_t GetInternalIdxForPID(TProcessID* procid) const
              Int_t GetInternalIdxForPID(Int_t pid) const

    public:

                        TRefTable()
                        TRefTable(TObject* owner, Int_t size)
                        TRefTable(const TRefTable&)
                virtual ~TRefTable()
          virtual Int_t Add(Int_t uid, TProcessID* context = 0)
         static TClass* Class()
           virtual void Clear(Option_t* = "")
          virtual Int_t Expand(Int_t pid, Int_t newsize)
           virtual void FillBuffer(TBuffer& b)
                  Int_t GetN(Int_t pid) const
                  Int_t GetNumPIDs() const
               TObject* GetOwner() const
               TObject* GetParent(Int_t uid, TProcessID* context = 0) const
             TObjArray* GetParents() const
      static TRefTable* GetRefTable()
                  Int_t GetSize(Int_t pid) const
                 UInt_t GetUID() const
            TProcessID* GetUIDContext() const
        virtual TClass* IsA() const
         virtual Bool_t Notify()
             TRefTable& operator=(const TRefTable&)
           virtual void ReadBuffer(TBuffer& b)
           virtual void Reset(Option_t* = "")
          virtual Int_t SetParent(const TObject* parent)
            static void SetRefTable(TRefTable* table)
           virtual void SetUID(UInt_t uid, TProcessID* context = 0)
           virtual void ShowMembers(TMemberInspector& insp, char* parent)
           virtual void Streamer(TBuffer& b)
                   void StreamerNVirtual(TBuffer& b)

Data Members

    protected:

                    Int_t fNumPIDs           !number of known ProcessIDs
                   Int_t* fAllocSize         ![fNumPIDs] allocated size of array fParentIDs for each ProcessID
                   Int_t* fN                 ![fNumPIDs] current maximum number of IDs in array fParentIDs for each ProcessID
                  Int_t** fParentIDs         ![fNumPIDs][fAllocSize] array of Parent IDs
                    Int_t fParentID          !current parent ID in fParents (latest call to SetParent)
                    Int_t fDefaultSize       !default size for a new PID array
                   UInt_t fUID               !Current uid (set by TRef::GetObject)
              TProcessID* fUIDContext        !TProcessID the current uid is referring to
                    Int_t fSize              dummy for backward compatibility
               TObjArray* fParents           array of Parent objects  (eg TTree branch) holding the referenced objects
                 TObject* fOwner             Object owning this TRefTable
      vector<std::string> fProcessGUIDs      UUIDs of TProcessIDs used in fParentIDs
            vector<Int_t> fMapPIDtoInternal  ! cache of pid to index in fProcessGUIDs
        static TRefTable* fgRefTable         Pointer to current TRefTable

Class Description

                                                                      
 A TRefTable maintains the association between a referenced object    
 and the parent object supporting this referenced object.             
                                                                      
 The parent object is typically a branch of a TTree. For each object  
 referenced in a TTree entry, the corresponding entry in the TTree's  
 TBranchRef::fRefTable contains the index of the branch that          
 needs to be loaded to bring the object into memory.                  
                                                                      
 Persistency of a TRefTable is split into two parts:                  
 * entry specific information is stored (read) by FillBuffer          
   (ReadBuffer). For each referenced object the object's fUniqueID    
   and the referencing TRef::fPID is stored (to allow the TRefTable   
   to autoload references created by different processes).            
 * non-entry specific, i.e. global information is stored (read) by    
   the Streamer function. This comprises all members marked as        
   persistent.                                                        
                                                                      
 As TObject::fUniqueID is only unique for a given TProcessID, a table 
 of unique IDs is kept for each used TProcessID. There is no natural  
 order of TProcessIDs, so TRefTable stores a vector of the TGUID of   
 all known TProcessIDs in fProcessGUIDs; the index of a TProcessID in 
 this vector defines the index of the auto-loading info in fParentIDs 
 for that TProcessID. The mapping of TProcessID* to index is cached   
 for quick non-persistent lookup.                                     
                                                                      

 Default constructor for I/O.

 Create a TRefTable with initial size.

 Destructor.

 Add a new uid to the table.
 we add a new pair (uid,fparent) to the map
 This function is called by TObject::Streamer or TStreamerInfo::WriteBuffer

 Add the internal index for fProcessIDs, fAllocSize, etc given a PID.

 Clear all entries in the table.

 Expand fParentIDs to newsize for ProcessID pid.

 Expand fParentIDs to newsize for internel ProcessID index iid.

 Expand the arrays of managed PIDs

 Fill buffer b with the fN elements in fParentdIDs.
 This function is called by TBranchRef::FillLeaves.

 Get fProcessGUIDs' index of the TProcessID with GUID guid

 Return object corresponding to uid.

 Get the index for fProcessIDs, fAllocSize, etc given a PID.
 Uses fMapPIDtoInternal and the pid's GUID / fProcessGUID

 Get the index for fProcessIDs, fAllocSize, etc given a PID.
 Uses fMapPIDtoInternal and the pid's GUID / fProcessGUID

 Static function returning the current TRefTable.

 This function is called by TRef::Streamer or TStreamerInfo::ReadBuffer
 when reading a reference.
 This function, in turns, notifies the TRefTable owner for action.
 eg, when the owner is a TBranchRef, TBranchRef::Notify is called
 to read the branch containing the referenced object.

 Fill buffer b with the fN elements in fParentdIDs.
 This function is called by TBranchRef::ReadLeaves

 Clear all entries in the table.

 Set Current parent object.
 The parent object is typically a branch of a Tree.
 This function is called by TBranchElement::Fill.

 Static function setting the current TRefTable.

Inline Functions

              Int_t GetNumPIDs() const
              Int_t GetSize(Int_t pid) const
              Int_t GetN(Int_t pid) const
           TObject* GetOwner() const
         TObjArray* GetParents() const
             UInt_t GetUID() const
        TProcessID* GetUIDContext() const
               void SetUID(UInt_t uid, TProcessID* context = 0)
            TClass* Class()
            TClass* IsA() const
               void ShowMembers(TMemberInspector& insp, char* parent)
               void Streamer(TBuffer& b)
               void StreamerNVirtual(TBuffer& b)
          TRefTable TRefTable(const TRefTable&)
         TRefTable& operator=(const TRefTable&)