ATLAS Offline Software
ReadCondHandle.h
Go to the documentation of this file.
1 /*
2  Copyright (C) 2002-2024 CERN for the benefit of the ATLAS collaboration
3 */
4 
5 #ifndef STOREGATE_READCONDHANDLE_H
6 #define STOREGATE_READCONDHANDLE_H 1
7 
10 #include "AthenaKernel/IOVEntryT.h"
12 
13 #include "StoreGate/ReadHandle.h"
15 #include "StoreGate/exceptions.h"
18 
19 #include "GaudiKernel/DataHandle.h"
20 #include "GaudiKernel/DataObjID.h"
21 #include "GaudiKernel/EventIDBase.h"
22 #include "GaudiKernel/EventContext.h"
23 #include "GaudiKernel/ThreadLocalContext.h"
24 
25 #include <string>
26 #include <stdexcept>
27 #include <any>
28 
29 
30 namespace SG {
31 
32 
40  const EventIDBase& eid,
41  const std::string& key);
42 
43  template <typename T>
45 
46  public:
47  typedef T* pointer_type; // FIXME: better handling of
48  typedef const T* const_pointer_type; // qualified T type ?
49  typedef T& reference_type;
50  typedef const T& const_reference_type;
51 
52  public:
55  const EventContext& ctx);
56 
58 
59  const std::string& key() const { return m_hkey.key(); }
60  const DataObjID& fullKey() const { return m_hkey.fullKey(); }
61 
63  const_pointer_type retrieve( const EventIDBase& t);
64 
68 
69 
70  bool isValid();
71  bool isValid(const EventIDBase& t) const ;
72 
73  bool range(EventIDRange& r);
74  bool range(const EventIDBase& t, EventIDRange& r) const;
75  const EventIDRange& getRange();
76 
77  CondCont<T>* getCC() { return m_cc; }
78 
79  private:
80 
82 
83  EventIDBase m_eid;
84  CondCont<T>* m_cc {nullptr};
85  const T* m_obj { nullptr };
86  const EventIDRange* m_range { nullptr };
87 
89  };
90 
91 
92  //---------------------------------------------------------------------------
93 
94  template <typename T>
96  ReadCondHandle(key, Gaudi::Hive::currentContext())
97  {
98  }
99 
100  //---------------------------------------------------------------------------
101 
102  template <typename T>
104  const EventContext& ctx):
105  m_eid( ctx.eventID() ),
106  m_cc( key.getCC() ),
107  m_hkey(key)
108  {
109  try {
110  EventIDBase::number_type conditionsRun =
112  if (conditionsRun != EventIDBase::UNDEFNUM) {
113  m_eid.set_run_number (conditionsRun);
114  }
115  }
116  catch (const std::bad_any_cast& e) {
117  throw SG::ExcBadContext (ctx, key.objKey());
118  }
119 
120  if (ATH_UNLIKELY(!key.isInit())) {
121  throw SG::ExcUninitKey (key.clid(), key.key(), key.storeHandle().name(),
122  "", "ReadCond");
123  }
124 
125  if (ATH_UNLIKELY(m_cc == 0)) {
126  // try to retrieve it
127  StoreGateSvc* cs = m_hkey.getCS();
128  CondContBase *cb(nullptr);
129  if (cs->retrieve(cb, m_hkey.key()).isFailure()) {
130  throw SG::ExcNoCondCont (m_hkey.fullKey().key(), "Can't retrieve.");
131  } else {
132  m_cc = dynamic_cast< CondCont<T>* > (cb);
133  if (m_cc == 0) {
134  throw SG::ExcNoCondCont (m_hkey.fullKey().key(), "Can't dcast CondContBase.");
135  }
136  }
137  }
138  }
139 
140  //---------------------------------------------------------------------------
141 
142  template <typename T>
143  bool
145 
146  if (m_obj != 0) return true;
147 
148  if ( ATH_UNLIKELY(!m_cc->find(m_eid, m_obj, &m_range)) ) {
149  ReadCondHandleNotFound (*m_cc, m_eid, m_hkey.objKey());
150  m_obj = nullptr;
151  return false;
152  }
153 
154  return true;
155  }
156 
157  //---------------------------------------------------------------------------
158 
159  template <typename T>
160  const T*
162 
163  if (m_obj == 0) {
164  if (!initCondHandle()) {
165  // std::ostringstream ost;
166  // m_cc->list(ost);
167  // MsgStream msg(Athena::getMessageSvc(), "ReadCondHandle");
168  // msg << MSG::ERROR
169  // << "ReadCondHandle::retrieve() could not find EventTime "
170  // << m_eid << " for key " << objKey() << "\n"
171  // << ost.str()
172  // << endmsg;
173  return nullptr;
174  }
175  }
176 
177  return m_obj;
178  }
179 
180  //---------------------------------------------------------------------------
181 
182  template <typename T>
183  const T*
184  ReadCondHandle<T>::retrieve(const EventIDBase& eid) {
185  if (eid == m_eid) {
186  return retrieve();
187  }
188 
189  // pointer_type obj(0);
190  const_pointer_type cobj(0);
191  if (! (m_cc->find(eid, cobj) ) ) {
192  ReadCondHandleNotFound (*m_cc, eid, m_hkey.objKey());
193  return nullptr;
194  }
195 
196  // const_pointer_type cobj = const_cast<const_pointer_type>( obj );
197 
198  return cobj;
199  }
200 
201  //---------------------------------------------------------------------------
202 
203  template <typename T>
204  bool
206 
207  return initCondHandle();
208  }
209 
210  //---------------------------------------------------------------------------
211 
212  template <typename T>
213  bool
214  ReadCondHandle<T>::isValid(const EventIDBase& t) const {
215 
216  return (m_cc->valid(t));
217  }
218 
219  //---------------------------------------------------------------------------
220 
221  template <typename T>
222  bool
223  ReadCondHandle<T>::range(EventIDRange& r) {
224 
225  if (m_obj == 0) {
226  if (!initCondHandle()) {
227  return false;
228  }
229  }
230 
231  if (m_range) {
232  r = *m_range;
233  return true;
234  }
235 
236  return false;
237  }
238 
239  template <typename T>
240  const EventIDRange&
242 
243  if (m_obj == 0) {
244  if (!initCondHandle()) {
246  }
247  }
248 
249  if (!m_range) {
250  throw SG::ExcNoRange();
251  }
252  return *m_range;
253 
254  }
255 
256 
257  //---------------------------------------------------------------------------
258 
259  template <typename T>
260  bool
261  ReadCondHandle<T>::range(const EventIDBase& eid, EventIDRange& r) const {
262 
263  return ( m_cc->range(eid, r) );
264  }
265 
266 
267  // helper methods to create a read cond handle from the corresponding key.
268  template <class T>
270  const EventContext& ctx = Gaudi::Hive::currentContext()) {
271  return SG::ReadCondHandle<T>(key, ctx);
272  }
273 
274 }
275 
276 #endif
277 
python.PyKernel.retrieve
def retrieve(aClass, aKey=None)
Definition: PyKernel.py:110
SG::ReadCondHandle::m_range
const EventIDRange * m_range
Definition: ReadCondHandle.h:86
SG::ReadCondHandle::range
bool range(const EventIDBase &t, EventIDRange &r) const
Definition: ReadCondHandle.h:261
beamspotman.r
def r
Definition: beamspotman.py:676
number_type
IEvtIdModifierSvc::number_type number_type
Definition: EvtIdModifierSvc.cxx:34
SG::ExcBadContext
Exception — Bad EventContext extension while building ReadCondHandle.
Definition: Control/StoreGate/StoreGate/exceptions.h:312
SG::ReadCondHandle::operator->
const_pointer_type operator->()
Definition: ReadCondHandle.h:65
SG::ReadCondHandle::getRange
const EventIDRange & getRange()
Definition: ReadCondHandle.h:241
SG
Forward declaration.
Definition: CaloCellPacker_400_500.h:32
SG::ReadCondHandle::fullKey
const DataObjID & fullKey() const
Definition: ReadCondHandle.h:60
CondCont.h
Hold mappings of ranges to condition objects.
SG::ReadCondHandle
Definition: ReadCondHandle.h:44
getMessageSvc.h
singleton-like access to IMessageSvc via open function and helper
beamspotVtxAnalysis.cs
list cs
Definition: beamspotVtxAnalysis.py:391
SG::ReadCondHandle::getCC
CondCont< T > * getCC()
Definition: ReadCondHandle.h:77
SG::ReadCondHandle::pointer_type
T * pointer_type
Definition: ReadCondHandle.h:47
Atlas::ExtendedEventContext::conditionsRun
EventIDBase::number_type conditionsRun() const
Definition: ExtendedEventContext.h:38
ExtendedEventContext.h
SG::ReadCondHandle::~ReadCondHandle
~ReadCondHandle()
Definition: ReadCondHandle.h:57
SG::ReadCondHandle::isValid
bool isValid()
Definition: ReadCondHandle.h:205
ATH_UNLIKELY
#define ATH_UNLIKELY(x)
Definition: AthUnlikelyMacros.h:17
SG::ReadCondHandle::range
bool range(EventIDRange &r)
Definition: ReadCondHandle.h:223
read_hist_ntuple.t
t
Definition: read_hist_ntuple.py:5
SG::ExcBadReadCondHandleInit
Exception — ReadCondHandle didn't initialize in getRange().
Definition: Control/StoreGate/StoreGate/exceptions.h:346
SG::ReadCondHandleNotFound
void ReadCondHandleNotFound(const CondContBase &cc, const EventIDBase &eid, const std::string &key)
Report a conditions container lookup failure.
Definition: ReadCondHandle.cxx:23
SG::ExcNoRange
Exception — Range not set in ReadCondHandle::getRange().
Definition: Control/StoreGate/StoreGate/exceptions.h:360
SG::ExcNoCondCont
Exception — Can't retrieve CondCont from ReadCondHandle.
Definition: Control/StoreGate/StoreGate/exceptions.h:330
m_range
float m_range[NbCaloPart][2]
Definition: CellClusterLinkTool.h:55
SG::makeHandle
SG::ReadCondHandle< T > makeHandle(const SG::ReadCondHandleKey< T > &key, const EventContext &ctx=Gaudi::Hive::currentContext())
Definition: ReadCondHandle.h:269
Atlas::getExtendedEventContext
const ExtendedEventContext & getExtendedEventContext(const EventContext &ctx)
Retrieve an extended context from a context object.
Definition: ExtendedEventContext.cxx:32
AthUnlikelyMacros.h
SG::ReadCondHandle::m_hkey
const SG::ReadCondHandleKey< T > & m_hkey
Definition: ReadCondHandle.h:88
StoreGateSvc
The Athena Transient Store API.
Definition: StoreGateSvc.h:128
SG::ReadCondHandle::retrieve
const_pointer_type retrieve()
Definition: ReadCondHandle.h:161
SG::ReadCondHandle::m_obj
const T * m_obj
Definition: ReadCondHandle.h:85
exceptions.h
Exceptions that can be thrown from StoreGate.
SG::ReadCondHandle::ReadCondHandle
ReadCondHandle(const SG::ReadCondHandleKey< T > &key)
Definition: ReadCondHandle.h:95
CondContBase
Base class for all conditions containers.
Definition: CondCont.h:140
SG::ReadCondHandle::operator*
const_pointer_type operator*()
Definition: ReadCondHandle.h:66
PixelCablingCondData
Definition: PixelCablingCondData.h:26
ReadCondHandleKey.h
SG::ReadCondHandle::isValid
bool isValid(const EventIDBase &t) const
Definition: ReadCondHandle.h:214
SG::ReadCondHandle::ReadCondHandle
ReadCondHandle(const SG::ReadCondHandleKey< T > &key, const EventContext &ctx)
Definition: ReadCondHandle.h:103
AthenaAttributeList.h
An AttributeList represents a logical row of attributes in a metadata table. The name and type of eac...
SG::ReadCondHandleKey
Definition: ReadCondHandleKey.h:20
SG::ReadCondHandle::initCondHandle
bool initCondHandle()
Definition: ReadCondHandle.h:144
DiTauMassTools::MaxHistStrategyV2::e
e
Definition: PhysicsAnalysis/TauID/DiTauMassTools/DiTauMassTools/HelperFunctions.h:26
CondCont
Hold mapping of ranges to condition objects.
Definition: CondCont.h:811
SG::ExcUninitKey
Exception — Tried to create a handle from an uninitialized key.
Definition: Control/StoreGate/StoreGate/exceptions.h:111
SG::ReadCondHandle::const_reference_type
const T & const_reference_type
Definition: ReadCondHandle.h:50
SG::ReadCondHandle::reference_type
T & reference_type
Definition: ReadCondHandle.h:49
SG::ReadCondHandle::const_pointer_type
const T * const_pointer_type
Definition: ReadCondHandle.h:48
IOVEntryT.h
SG::ReadCondHandle::m_eid
EventIDBase m_eid
Definition: ReadCondHandle.h:83
SG::ReadCondHandle::m_cc
CondCont< T > * m_cc
Definition: ReadCondHandle.h:84
Gaudi
=============================================================================
Definition: CaloGPUClusterAndCellDataMonitorOptions.h:273
ReadHandle.h
Handle class for reading from StoreGate.
SG::ReadCondHandle::key
const std::string & key() const
Definition: ReadCondHandle.h:59
SG::ReadCondHandle::retrieve
const_pointer_type retrieve(const EventIDBase &t)
Definition: ReadCondHandle.h:184
python.handimod.cc
int cc
Definition: handimod.py:523
mapkey::key
key
Definition: TElectronEfficiencyCorrectionTool.cxx:37
SG::ReadCondHandle::cptr
const_pointer_type cptr()
Definition: ReadCondHandle.h:67