Logo ROOT   6.10/09
Reference Guide
TFileCollection.h
Go to the documentation of this file.
1 // @(#)root/base:$Id$
2 // Author: Jan Fiete Grosse-Oetringhaus 01/06/07
3 
4 /*************************************************************************
5  * Copyright (C) 1995-2007, Rene Brun and Fons Rademakers. *
6  * All rights reserved. *
7  * *
8  * For the licensing terms see $ROOTSYS/LICENSE. *
9  * For the list of contributors see $ROOTSYS/README/CREDITS. *
10  *************************************************************************/
11 
12 #ifndef ROOT_TFileCollection
13 #define ROOT_TFileCollection
14 
15 //////////////////////////////////////////////////////////////////////////
16 // //
17 // TFileCollection //
18 // //
19 // Class that contains a list of TFileInfo's and accumulated meta //
20 // data information about its entries. This class is used to describe //
21 // file sets as stored by Grid file catalogs, by PROOF or any other //
22 // collection of TFile names. //
23 // //
24 //////////////////////////////////////////////////////////////////////////
25 
26 #include "TNamed.h"
27 
28 #include "TString.h"
29 
30 class THashList;
31 class TMap;
32 class TList;
33 class TCollection;
34 class TFileInfo;
35 class TFileInfoMeta;
36 class TObjString;
37 
38 
39 class TFileCollection : public TNamed {
40 
41 private:
42  THashList *fList; //-> list of TFileInfos
43  TList *fMetaDataList; //-> generic list of file meta data object(s)
44  // (summed over entries of fList)
45  TString fDefaultTree; // name of default tree
46  Long64_t fTotalSize; // total size of files in the list
47  Long64_t fNFiles; // number of files ( == fList->GetEntries(), needed
48  // because TFileCollection might be read without fList)
49  Long64_t fNStagedFiles; // number of staged files
50  Long64_t fNCorruptFiles; // number of corrupt files
51 
52  TFileCollection(const TFileCollection&); // not implemented
53  TFileCollection& operator=(const TFileCollection&); // not implemented
54 
55  void PrintDetailed(TString &showOnly) const;
56  void FormatSize(Long64_t bytes, TString &um, Double_t &size) const;
57 
58 public:
59  enum EStatusBits {
60  kRemoteCollection = BIT(15) // the collection is not staged
61  };
62  TFileCollection(const char *name = 0, const char *title = 0,
63  const char *file = 0, Int_t nfiles = -1, Int_t firstfile = 1);
64  virtual ~TFileCollection();
65 
66  Int_t Add(TFileInfo *info);
67  Int_t Add(TFileCollection *coll);
68  Int_t AddFromFile(const char *file, Int_t nfiles = -1, Int_t firstfile = 1);
69  Int_t Add(const char *path);
70  THashList *GetList() { return fList; }
71  void SetList(THashList* list) { fList = list; }
72 
73  TObjString *ExportInfo(const char *name = 0, Int_t popt = 0);
74 
75  Long64_t Merge(TCollection* list);
77  Int_t Update(Long64_t avgsize = -1);
78  void Sort(Bool_t useindex = kFALSE);
79  void SetAnchor(const char *anchor);
80  void Print(Option_t *option = "") const;
81 
82  void SetBitAll(UInt_t f);
83  void ResetBitAll(UInt_t f);
84 
85  Long64_t GetTotalSize() const { return fTotalSize; }
86  Long64_t GetNFiles() const { return fNFiles; }
90  { return (fNFiles > 0) ? 100. * fNStagedFiles / fNFiles : 0; }
92  { return (fNFiles > 0) ? 100. * fNCorruptFiles / fNFiles : 0; }
93 
94  const char *GetDefaultTreeName() const;
95  void SetDefaultTreeName(const char* treeName) { fDefaultTree = treeName; }
96  Long64_t GetTotalEntries(const char *tree) const;
97 
98  TFileInfoMeta *GetMetaData(const char *meta = 0) const;
99  void SetDefaultMetaData(const char *meta);
100  Bool_t AddMetaData(TObject *meta);
101  void RemoveMetaData(const char *meta = 0);
102 
104 
105  TFileCollection *GetFilesOnServer(const char *server);
106  TMap *GetFilesPerServer(const char *exclude = 0, Bool_t curronly = kFALSE);
107 
108  ClassDef(TFileCollection, 3) // Collection of TFileInfo objects
109 };
110 
111 #endif
TFileInfoMeta * GetMetaData(const char *meta=0) const
Returns the meta data object with the specified meta name.
TFileCollection * GetFilesOnServer(const char *server)
Return the subset of files served by 'server'.
const char * GetDefaultTreeName() const
Returns the tree set with SetDefaultTreeName if set Returns the name of the first tree in the meta da...
long long Long64_t
Definition: RtypesCore.h:69
void SetAnchor(const char *anchor)
Calls TUrl::SetAnchor() for all URLs contained in all TFileInfos.
Collectable string class.
Definition: TObjString.h:28
float Float_t
Definition: RtypesCore.h:53
const char Option_t
Definition: RtypesCore.h:62
Long64_t GetTotalSize() const
Float_t GetStagedPercentage() const
#define BIT(n)
Definition: Rtypes.h:75
Long64_t GetTotalEntries(const char *tree) const
Returns the number of entries for the specified tree (retrieved from meta data).
Basic string class.
Definition: TString.h:129
int Int_t
Definition: RtypesCore.h:41
bool Bool_t
Definition: RtypesCore.h:59
Long64_t fNStagedFiles
Int_t Update(Long64_t avgsize=-1)
Update accumulated information about the elements of the collection (e.g.
#define ClassDef(name, id)
Definition: Rtypes.h:297
THashList implements a hybrid collection class consisting of a hash table and a list to store TObject...
Definition: THashList.h:34
The TNamed class is the base class for all named ROOT classes.
Definition: TNamed.h:29
TFileCollection * GetStagedSubset()
Creates a subset of the files that have the kStaged & !kCorrupted bit set.
void RemoveMetaData(const char *meta=0)
Removes the indicated meta data object in all TFileInfos and this object If no name is given all meta...
Long64_t Merge(TCollection *list)
Merge all TFileCollection objects in li into this TFileCollection object.
A doubly linked list.
Definition: TList.h:43
TFileCollection & operator=(const TFileCollection &)
void Sort(Bool_t useindex=kFALSE)
Sort the collection.
Bool_t AddMetaData(TObject *meta)
Add's a meta data object to the file collection object.
TObjString * ExportInfo(const char *name=0, Int_t popt=0)
Export the relevant info as a string; use 'name' as collection name, if defined, else use GetName()...
Int_t RemoveDuplicates()
Remove duplicates based on the UUID, typically after a verification.
THashList * GetList()
Int_t Add(TFileInfo *info)
Add TFileInfo to the collection.
Long64_t GetNFiles() const
void Print(Option_t *option="") const
Prints the contents of the TFileCollection.
Collection abstract base class.
Definition: TCollection.h:42
unsigned int UInt_t
Definition: RtypesCore.h:42
void FormatSize(Long64_t bytes, TString &um, Double_t &size) const
Format size.
THashList * fList
const Bool_t kFALSE
Definition: RtypesCore.h:92
TFileCollection(const TFileCollection &)
void SetDefaultTreeName(const char *treeName)
double f(double x)
double Double_t
Definition: RtypesCore.h:55
TMap implements an associative array of (key,value) pairs using a THashTable for efficient retrieval ...
Definition: TMap.h:40
Mother of all ROOT objects.
Definition: TObject.h:37
Int_t AddFromFile(const char *file, Int_t nfiles=-1, Int_t firstfile=1)
Add file names contained in the specified text file.
void SetDefaultMetaData(const char *meta)
Moves the indicated meta data in the first position, so that it becomes effectively the default...
void PrintDetailed(TString &showOnly) const
Print detailed.
Long64_t fNCorruptFiles
virtual ~TFileCollection()
Cleanup.
Class that contains a list of TFileInfo's and accumulated meta data information about its entries...
Definition: file.py:1
void ResetBitAll(UInt_t f)
Reset the bit for all TFileInfos.
Float_t GetCorruptedPercentage() const
Definition: tree.py:1
Class describing a generic file including meta information.
Definition: TFileInfo.h:38
Long64_t GetNCorruptFiles() const
TMap * GetFilesPerServer(const char *exclude=0, Bool_t curronly=kFALSE)
Return a map of TFileCollections with the files on each data server, excluding servers in the comma-s...
void SetBitAll(UInt_t f)
Set the bit for all TFileInfos.
Long64_t GetNStagedFiles() const
void SetList(THashList *list)