ATLAS Offline Software
Loading...
Searching...
No Matches
DbDatabaseObj.h
Go to the documentation of this file.
1/*
2 Copyright (C) 2002-2026 CERN for the benefit of the ATLAS collaboration
3*/
4
5//====================================================================
6// DbDatabaseObj object definition
7//--------------------------------------------------------------------
8//
9// Package : System (The POOL project)
10//
11// Description: Generic data persistency
12//
13// @author M.Frank
14//====================================================================
15#ifndef POOL_DBDATABASEOBJ_H
16#define POOL_DBDATABASEOBJ_H 1
17
18// We need the definition of the domain for defining the Database
20#include "StorageSvc/DbDomain.h"
23#include "StorageSvc/DbPrint.h"
24#include "DbAccessObj.h"
25
26// STL include files
27#include <map>
28#include <string>
29#include <vector>
30
31
32/*
33 * POOL namespace declaration
34 */
35namespace pool {
36
47 class DbDatabaseObj : public DbAccessObj<std::string, DbContainerObj >, public APRMessaging {
48 private:
50 typedef std::pair<std::string, std::string> Parameter;
52 typedef std::vector< Parameter > Parameters;
54 typedef std::vector< DbContainerObj > Containers;
56 typedef std::map<std::string, std::string, std::less<>> ParamMap;
58 typedef std::map< Guid , Token* > LinkMap;
60 typedef std::vector<Token*> LinkVector;
62 typedef std::map< Guid , const DbTypeInfo* > ShapeMap;
64 typedef std::map< long long int , int > IndexMap;
67
89 std::map<RootType, const DbTypeInfo*> m_classMap;
95 std::string m_logon;
100
101 private:
103 void cleanup();
104
105 public:
108 const std::string& pfn,
109 const std::string& fid,
110 Io::IoFlag mode = Io::READ);
112 virtual ~DbDatabaseObj();
114 const std::string& logon() const { return m_logon; }
116 long long int size() const;
118 IDbDatabase* info() { return m_info; }
119 const IDbDatabase* info() const { return m_info; }
121 DbDomain& domain() { return m_dom; }
122 const DbDomain& domain() const { return m_dom; }
124 int age() const { return m_fileAge; }
126 const Token* token() const { return m_token; }
127
129 StatusCode open();
131 StatusCode close();
133 StatusCode retire();
135 StatusCode transAct(Transaction::Action action);
136
138 StatusCode read(const Token& token, ShapeH shape, void** object);
140 std::string cntName(Token& token) const;
142 StatusCode makeLink(Token* pToken, Token::OID_t& refLink);
144 const DbTypeInfo* objectShape(const RootType& classH) const;
146 const DbTypeInfo* objectShape(const Guid& nam) const;
148 const DbTypeInfo* contShape(const std::string& nam) const;
150 StatusCode addShape (const DbTypeInfo* pType);
152 const Token* cntToken(const std::string& cntName);
154 StatusCode containers(std::vector<const Token*>& conts, bool intern);
155 StatusCode containers(std::vector<IDbContainer*>& conts, bool intern);
157 StatusCode addParam(const std::string& nam, const std::string& val);
159 StatusCode param(const std::string& nam, std::string& val) const;
161 StatusCode setOption(const DbOption& refOpt);
163 StatusCode getOption(DbOption& refOpt);
164
166 void setAge(int value);
167 };
168} // End namespace pool
169#endif // POOL_DBDATABASEOBJ_H
This file contains the class definition for the Guid class (migrated from POOL).
TTypeAdapter RootType
Definition RootType.h:211
This class provides a encapsulation of a GUID/UUID/CLSID/IID data structure (128 bit number).
Definition Guid.h:25
This class provides a token that identifies in a unique way objects on the persistent storage.
Definition Token.h:22
APRMessaging(const std::string &name)
Description:
Description: Definition of the object describing a database container Handle managing a DbContainerOb...
Definition DbContainer.h:48
StatusCode param(const std::string &nam, std::string &val) const
Retrieve existing parameter by name.
IDbDatabase * info()
Access to technology dependent implementation.
StatusCode containers(std::vector< const Token * > &conts, bool intern)
Allow access to all known containers.
StatusCode open()
Open Database object.
std::vector< Token * > LinkVector
Definition of array with link elements.
Containers m_retiredConts
Collection of retired database containers.
StatusCode close()
Close database object.
int age() const
Access age value.
StatusCode read(const Token &token, ShapeH shape, void **object)
read an object referenced by the token
const DbTypeInfo * objectShape(const Guid &nam) const
Retrieve persistent type information by shape identifier.
DbDatabaseObj(DbDomain &dom, const std::string &pfn, const std::string &fid, Io::IoFlag mode=Io::READ)
Standard constructor of a Database obejct.
LinkMap m_linkMap
Map containing all links.
ParamMap m_paramMap
Map with all cached file properties.
int m_fileAge
File age counter.
long long int size() const
Access the size of the database: May be undefined for some technologies.
std::map< long long int, int > IndexMap
Definition of map with index elements.
IDbDatabase * m_info
Technology dependent implementation block.
std::string m_logon
Physical Database login.
std::map< std::string, std::string, std::less<> > ParamMap
Parameter map definition.
virtual ~DbDatabaseObj()
Standard Destructor.
DbAccessObj< std::string, DbContainerObj > Base
Base class convenience typdef.
std::string cntName(Token &token) const
Retrieve container name from link container (using token oid, rather than contID).
DbDomain m_dom
Handle to domain.
const Token * token() const
Access the token of the database object.
DbContainer m_params
Handle to the parameter container.
std::vector< DbContainerObj > Containers
Collection of retired database containers.
const DbTypeInfo * m_string_t
Internal string representation type.
StatusCode getOption(DbOption &refOpt)
Access options.
StatusCode transAct(Transaction::Action action)
Execute Database Transaction action.
std::map< RootType, const DbTypeInfo * > m_classMap
Map with all cached mappings between known reflection classes.
DbDomain & domain()
Access to domain handle (CONST).
std::map< Guid, const DbTypeInfo * > ShapeMap
Definition of map with shape elements.
LinkVector m_linkVec
Random access array containing all links.
ShapeMap m_shapeMap
Map containing all shapes.
IndexMap m_indexMap
Map containing all index.
const IDbDatabase * info() const
StatusCode retire()
End database access, but still leave database accessible.
void cleanup()
Perform cleanup of internal data structures.
const DbDomain & domain() const
std::vector< Parameter > Parameters
Database parameter container definition.
Token * m_token
Token describing the object.
std::map< Guid, Token * > LinkMap
Definition of map with link elements.
const std::string & logon() const
Access to the logon string.
std::pair< std::string, std::string > Parameter
Database parameter definition.
DbContainer m_links
Handle to link container.
StatusCode containers(std::vector< IDbContainer * > &conts, bool intern)
const DbTypeInfo * contShape(const std::string &nam) const
Retrieve persistent type information by container.
void setAge(int value)
Update database age.
StatusCode makeLink(Token *pToken, Token::OID_t &refLink)
Add association link to link container.
StatusCode setOption(const DbOption &refOpt)
Set options.
const Token * cntToken(const std::string &cntName)
Access local container token (if container exists).
const DbTypeInfo * objectShape(const RootType &classH) const
Retrieve persistent type information by class handle.
StatusCode addShape(const DbTypeInfo *pType)
Add persistent type to the Database.
DbContainer m_shapes
Handle to shapes container.
StatusCode addParam(const std::string &nam, const std::string &val)
Add a persistent parameter to the file.
Description:
Definition DbDomain.h:47
Description: Definition an option to be supplied to database objects.
Definition DbOption.h:36
Definition of class DbTypeInfo.
Definition DbTypeInfo.h:49
IDbDatabase interface.
Definition IDbDatabase.h:41
Framework include files.
Definition libname.h:15
const class Shape * ShapeH