Logo ROOT   6.30.04
Reference Guide
 All Namespaces Files Pages
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);
76  Int_t RemoveDuplicates();
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; }
87  Long64_t GetNStagedFiles() const { return fNStagedFiles; }
88  Long64_t GetNCorruptFiles() const { return fNCorruptFiles; }
89  Float_t GetStagedPercentage() const
90  { return (fNFiles > 0) ? 100. * fNStagedFiles / fNFiles : 0; }
91  Float_t GetCorruptedPercentage() const
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 
103  TFileCollection *GetStagedSubset();
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