Logo ROOT  
Reference Guide
TXMLFile.h
Go to the documentation of this file.
1// @(#)root/xml:$Id$
2// Author: Sergey Linev 10.05.2004
3
4/*************************************************************************
5 * Copyright (C) 1995-2004, 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_TXMLFile
13#define ROOT_TXMLFile
14
15#include "TFile.h"
16#include "TXMLSetup.h"
17#include "TXMLEngine.h"
18#include "Compression.h"
19#include <memory>
20
21class TKeyXML;
22class TList;
24class TStreamerInfo;
25
26class TXMLFile final : public TFile, public TXMLSetup {
27
28protected:
29 void InitXmlFile(Bool_t create);
30 // Interface to basic system I/O routines
31 Int_t SysOpen(const char *, Int_t, UInt_t) final { return 0; }
32 Int_t SysClose(Int_t) final { return 0; }
33 Int_t SysRead(Int_t, void *, Int_t) final { return 0; }
34 Int_t SysWrite(Int_t, const void *, Int_t) final { return 0; }
35 Long64_t SysSeek(Int_t, Long64_t, Int_t) final { return 0; }
36 Int_t SysStat(Int_t, Long_t *, Long64_t *, Long_t *, Long_t *) final { return 0; }
37 Int_t SysSync(Int_t) final { return 0; }
38
39 // Overwrite methods for directory I/O
42 void DirWriteKeys(TDirectory *) final;
43 void DirWriteHeader(TDirectory *) final;
44
45 InfoListRet GetStreamerInfoListImpl(bool lookupSICache) final;
46
47private:
48 TXMLFile(const TXMLFile &) = delete; // TXMLFile cannot be copied, not implemented
49 void operator=(const TXMLFile &) = delete; // TXMLFile cannot be copied, not implemented
50
51public:
52 TXMLFile() {} // NOLINT: not allowed to use = default because of TObject::kIsOnHeap detection, see ROOT-10300
53 TXMLFile(const char *filename, Option_t *option = "read", const char *title = "title", Int_t compression = ROOT::RCompressionSetting::EDefaults::kUseCompiledDefault);
54 virtual ~TXMLFile();
55
56 void Close(Option_t *option = "") final; // *MENU*
57 TKey *CreateKey(TDirectory *mother, const TObject *obj, const char *name, Int_t bufsize) final;
58 TKey *CreateKey(TDirectory *mother, const void *obj, const TClass *cl, const char *name, Int_t bufsize) final;
59 void DrawMap(const char * = "*", Option_t * = "") final {}
60 void FillBuffer(char *&) final {}
61 void Flush() final {}
62
63 Long64_t GetEND() const final { return 0; }
64 Int_t GetErrno() const final { return 0; }
65 void ResetErrno() const final {}
66
67 Int_t GetNfree() const final { return 0; }
68 Int_t GetNbytesInfo() const final { return 0; }
69 Int_t GetNbytesFree() const final { return 0; }
70 Long64_t GetSeekFree() const final { return 0; }
71 Long64_t GetSeekInfo() const final { return 0; }
72 Long64_t GetSize() const final { return 0; }
73
74 Int_t GetIOVersion() const { return fIOVersion; }
75
76 Bool_t IsOpen() const final;
77
78 void MakeFree(Long64_t, Long64_t) final {}
79 void MakeProject(const char *, const char * = "*", Option_t * = "new") final {} // *MENU*
80 void Map(Option_t *) final {} //
81 void Map() final {} //
82 void Paint(Option_t * = "") final {}
83 void Print(Option_t * = "") const final {}
84 Bool_t ReadBuffer(char *, Int_t) final { return kFALSE; }
85 Bool_t ReadBuffer(char *, Long64_t, Int_t) final { return kFALSE; }
86 void ReadFree() final {}
87 Int_t Recover() final { return 0; }
88 Int_t ReOpen(Option_t *mode) final;
89 void Seek(Long64_t, ERelativeTo = kBeg) final {}
90
91 void SetEND(Long64_t) final {}
92 Int_t Sizeof() const final { return 0; }
93
94 Bool_t WriteBuffer(const char *, Int_t) final { return kFALSE; }
95 Int_t Write(const char * = nullptr, Int_t = 0, Int_t = 0) final { return 0; }
96 Int_t Write(const char * = nullptr, Int_t = 0, Int_t = 0) const final { return 0; }
97 void WriteFree() final {}
98 void WriteHeader() final {}
99 void WriteStreamerInfo() final;
100
101 // XML specific functions
102
103 void SetXmlLayout(EXMLLayout layout) final;
104 void SetStoreStreamerInfos(Bool_t iConvert = kTRUE) final;
105 void SetUsedDtd(Bool_t use = kTRUE) final;
106 void SetUseNamespaces(Bool_t iUseNamespaces = kTRUE) final;
107
108 Bool_t AddXmlComment(const char *comment);
109 Bool_t AddXmlStyleSheet(const char *href, const char *type = "text/css", const char *title = nullptr, int alternate = -1,
110 const char *media = nullptr, const char *charset = nullptr);
111 Bool_t AddXmlLine(const char *line);
112
113 TXMLEngine *XML() { return fXML.get(); }
114
115protected:
116 // functions to store streamer infos
117
120
124 TDirectory *FindKeyDir(TDirectory *mother, Long64_t keyid);
125 void CombineNodesTree(TDirectory *dir, XMLNodePointer_t topnode, Bool_t dolink);
126
127 void SaveToFile();
128
129 static void ProduceFileNames(const char *filename, TString &fname, TString &dtdname);
130
131 XMLDocPointer_t fDoc{nullptr}; //!
132
133 XMLNodePointer_t fStreamerInfoNode{nullptr}; //! pointer of node with streamer info data
134
135 std::unique_ptr<TXMLEngine> fXML; //! object for interface with xml library
136
137 Int_t fIOVersion{0}; //! indicates format of ROOT xml file
138
139 Long64_t fKeyCounter{0}; //! counter of created keys, used for keys id
140
141 ClassDefOverride(TXMLFile, 3) // ROOT file in XML format
142};
143
144#endif
int Int_t
Definition: RtypesCore.h:41
unsigned int UInt_t
Definition: RtypesCore.h:42
const Bool_t kFALSE
Definition: RtypesCore.h:88
long Long_t
Definition: RtypesCore.h:50
bool Bool_t
Definition: RtypesCore.h:59
long long Long64_t
Definition: RtypesCore.h:69
const Bool_t kTRUE
Definition: RtypesCore.h:87
const char Option_t
Definition: RtypesCore.h:62
#define ClassDefOverride(name, id)
Definition: Rtypes.h:330
char name[80]
Definition: TGX11.cxx:109
int type
Definition: TGX11.cxx:120
void * XMLNodePointer_t
Definition: TXMLEngine.h:17
void * XMLDocPointer_t
Definition: TXMLEngine.h:20
TClass instances represent classes, structs and namespaces in the ROOT type system.
Definition: TClass.h:75
Describe directory structure in memory.
Definition: TDirectory.h:34
A ROOT file is a suite of consecutive data records (TKey instances) with a well defined format.
Definition: TFile.h:48
ERelativeTo
Definition: TFile.h:186
@ kBeg
Definition: TFile.h:186
Book space in a file, create I/O buffers, to fill them, (un)compress them.
Definition: TKey.h:24
A doubly linked list.
Definition: TList.h:44
Mother of all ROOT objects.
Definition: TObject.h:37
Describe Streamer information for one class version.
Definition: TStreamerInfo.h:43
Basic string class.
Definition: TString.h:131
Int_t SysOpen(const char *, Int_t, UInt_t) final
Interface to system open. All arguments like in POSIX open().
Definition: TXMLFile.h:31
Int_t SysSync(Int_t) final
Interface to system fsync. All arguments like in POSIX fsync().
Definition: TXMLFile.h:37
void Paint(Option_t *="") final
Paint all objects in the file.
Definition: TXMLFile.h:82
Bool_t IsOpen() const final
return kTRUE if file is opened and can be accessed
Definition: TXMLFile.cxx:364
Int_t Sizeof() const final
Return the size in bytes of the file header.
Definition: TXMLFile.h:92
void DrawMap(const char *="*", Option_t *="") final
Draw map of objects in this file.
Definition: TXMLFile.h:59
Int_t fIOVersion
object for interface with xml library
Definition: TXMLFile.h:137
TXMLFile()
Definition: TXMLFile.h:52
TDirectory * FindKeyDir(TDirectory *mother, Long64_t keyid)
Find a directory in motherdir with a seek equal to keyid.
Definition: TXMLFile.cxx:1048
TKey * CreateKey(TDirectory *mother, const TObject *obj, const char *name, Int_t bufsize) final
create XML key, which will store object in xml structures
Definition: TXMLFile.cxx:409
void ReadFree() final
Read the FREE linked list.
Definition: TXMLFile.h:86
void InitXmlFile(Bool_t create)
initialize xml file and correspondent structures identical to TFile::Init() function
Definition: TXMLFile.cxx:263
void Map() final
Definition: TXMLFile.h:81
Int_t SysRead(Int_t, void *, Int_t) final
Interface to system read. All arguments like in POSIX read().
Definition: TXMLFile.h:33
Bool_t AddXmlStyleSheet(const char *href, const char *type="text/css", const char *title=nullptr, int alternate=-1, const char *media=nullptr, const char *charset=nullptr)
Adds style sheet definition on the top of xml document Creates <?xml-stylesheet alternate="yes" title...
Definition: TXMLFile.cxx:982
InfoListRet GetStreamerInfoListImpl(bool lookupSICache) final
Read streamerinfo structures from xml format and provide them in the list It is user responsibility t...
Definition: TXMLFile.cxx:716
Int_t GetNfree() const final
Definition: TXMLFile.h:67
Long64_t GetEND() const final
Definition: TXMLFile.h:63
Int_t SysClose(Int_t) final
Interface to system close. All arguments like in POSIX close().
Definition: TXMLFile.h:32
void SaveToFile()
Saves xml structures to the file xml elements are kept in list of TKeyXML objects When saving,...
Definition: TXMLFile.cxx:455
Int_t Write(const char *=nullptr, Int_t=0, Int_t=0) final
Write memory objects to this file.
Definition: TXMLFile.h:95
XMLNodePointer_t fStreamerInfoNode
Definition: TXMLFile.h:133
Long64_t fKeyCounter
indicates format of ROOT xml file
Definition: TXMLFile.h:139
void CombineNodesTree(TDirectory *dir, XMLNodePointer_t topnode, Bool_t dolink)
Connect/disconnect all file nodes to single tree before/after saving.
Definition: TXMLFile.cxx:536
void Map(Option_t *) final
List the contents of a file sequentially.
Definition: TXMLFile.h:80
Bool_t ReadBuffer(char *, Int_t) final
Read a buffer from the file.
Definition: TXMLFile.h:84
void DirWriteHeader(TDirectory *) final
Write the directory header.
Definition: TXMLFile.cxx:1097
void FillBuffer(char *&) final
Encode file output buffer.
Definition: TXMLFile.h:60
Int_t DirReadKeys(TDirectory *) final
Read keys for directory Make sense only once, while next time no new subnodes will be created.
Definition: TXMLFile.cxx:1070
Bool_t AddXmlLine(const char *line)
Add just one line on the top of xml document For instance, line can contain special xml processing in...
Definition: TXMLFile.cxx:998
Long64_t GetSize() const final
Returns the current file size.
Definition: TXMLFile.h:72
void WriteHeader() final
Write File Header.
Definition: TXMLFile.h:98
void DirWriteKeys(TDirectory *) final
Update key attributes.
Definition: TXMLFile.cxx:1082
TXMLFile(const TXMLFile &)=delete
Int_t Recover() final
Attempt to recover file if not correctly closed.
Definition: TXMLFile.h:87
void WriteStreamerInfo() final
convert all TStreamerInfo, used in file, to xml format
Definition: TXMLFile.cxx:665
Int_t ReadKeysList(TDirectory *dir, XMLNodePointer_t topnode)
Read list of keys for directory.
Definition: TXMLFile.cxx:631
void WriteFree() final
Write FREE linked list on the file.
Definition: TXMLFile.h:97
void SetEND(Long64_t) final
Definition: TXMLFile.h:91
void SetXmlLayout(EXMLLayout layout) final
Change layout of objects in xml file Can be changed only for newly created file.
Definition: TXMLFile.cxx:910
Bool_t WriteBuffer(const char *, Int_t) final
Write a buffer to the file.
Definition: TXMLFile.h:94
void ResetErrno() const final
Method resetting the errno.
Definition: TXMLFile.h:65
Int_t SysStat(Int_t, Long_t *, Long64_t *, Long_t *, Long_t *) final
Return file stat information.
Definition: TXMLFile.h:36
Int_t Write(const char *=nullptr, Int_t=0, Int_t=0) const final
One can not save a const TDirectory object.
Definition: TXMLFile.h:96
void operator=(const TXMLFile &)=delete
Long64_t GetSeekInfo() const final
Definition: TXMLFile.h:71
void SetStoreStreamerInfos(Bool_t iConvert=kTRUE) final
If true, all correspondent to file TStreamerInfo objects will be stored in file this allows to apply ...
Definition: TXMLFile.cxx:922
void SetUseNamespaces(Bool_t iUseNamespaces=kTRUE) final
Specify usage of namespaces in xml file In current implementation every instrumented class in file ge...
Definition: TXMLFile.cxx:953
Long64_t SysSeek(Int_t, Long64_t, Int_t) final
Interface to system lseek.
Definition: TXMLFile.h:35
Int_t GetIOVersion() const
Definition: TXMLFile.h:74
void SetUsedDtd(Bool_t use=kTRUE) final
Specify usage of DTD for this file.
Definition: TXMLFile.cxx:933
virtual ~TXMLFile()
destructor of TXMLFile object
Definition: TXMLFile.cxx:356
XMLDocPointer_t fDoc
Definition: TXMLFile.h:131
void StoreStreamerElement(XMLNodePointer_t node, TStreamerElement *elem)
store data of single TStreamerElement in streamer node
Definition: TXMLFile.cxx:768
Int_t GetErrno() const final
Method returning errno.
Definition: TXMLFile.h:64
void Print(Option_t *="") const final
Print all objects in the file.
Definition: TXMLFile.h:83
void MakeFree(Long64_t, Long64_t) final
Mark unused bytes on the file.
Definition: TXMLFile.h:78
Int_t GetNbytesFree() const final
Definition: TXMLFile.h:69
Long64_t GetSeekFree() const final
Definition: TXMLFile.h:70
void ReadStreamerElement(XMLNodePointer_t node, TStreamerInfo *info)
read and reconstruct single TStreamerElement from xml node
Definition: TXMLFile.cxx:824
Bool_t ReadBuffer(char *, Long64_t, Int_t) final
Read a buffer from the file at the offset 'pos' in the file.
Definition: TXMLFile.h:85
void MakeProject(const char *, const char *="*", Option_t *="new") final
Generate source code necessary to access the objects stored in the file.
Definition: TXMLFile.h:79
Int_t SysWrite(Int_t, const void *, Int_t) final
Interface to system write. All arguments like in POSIX write().
Definition: TXMLFile.h:34
Int_t ReOpen(Option_t *mode) final
Reopen a file with a different access mode, like from READ to See TFile::Open() for details.
Definition: TXMLFile.cxx:373
std::unique_ptr< TXMLEngine > fXML
pointer of node with streamer info data
Definition: TXMLFile.h:135
void Close(Option_t *option="") final
Close a XML file For more comments see TFile::Close() function.
Definition: TXMLFile.cxx:300
Bool_t ReadFromFile()
read document from file Now full content of document reads into the memory Then document decomposed t...
Definition: TXMLFile.cxx:560
void Flush() final
Synchronize a file's in-memory and on-disk states.
Definition: TXMLFile.h:61
void Seek(Long64_t, ERelativeTo=kBeg) final
Seek to a specific position in the file. Pos it either kBeg, kCur or kEnd.
Definition: TXMLFile.h:89
TXMLEngine * XML()
Definition: TXMLFile.h:113
Bool_t AddXmlComment(const char *comment)
Add comment line on the top of the xml document This line can only be seen in xml editor and cannot b...
Definition: TXMLFile.cxx:964
Long64_t DirCreateEntry(TDirectory *) final
Create key for directory entry in the key.
Definition: TXMLFile.cxx:1009
TKeyXML * FindDirKey(TDirectory *dir)
Search for key which correspond to directory dir.
Definition: TXMLFile.cxx:1025
static void ProduceFileNames(const char *filename, TString &fname, TString &dtdname)
function produces pair of xml and dtd file names
Definition: TXMLFile.cxx:425
Int_t GetNbytesInfo() const final
Definition: TXMLFile.h:68
TText * text
TLine * line
@ kUseCompiledDefault
Use the compile-time default setting.
Definition: Compression.h:50