EventAnalysis  1.2.2
DataStore.h
Go to the documentation of this file.
1 /*
2  * DataStore.h
3  *
4  * Created on: 03 Jan 2017
5  * Author: Nicola Mori
6  */
7 
10 #ifndef DATASTORE_H_
11 #define DATASTORE_H_
12 
13 #include "core/Info.h"
14 #include "core/ObjectMap.h"
15 #include "core/ObserverPtr.h"
16 #include "core/RetrievalResult.h"
17 #include "data/DataProvider.h"
18 #include "data/EventDataCache.h"
20 #include "data/ObjectCategory.h"
23 
24 #include <vector>
25 
26 namespace EA {
27 
28 class AlgoSequence;
29 
41 class DataStore : public Info, private ObjectMap {
42 public:
43  // Constructors/destructor
44 
50  DataStore(const std::string &name, ObjectCategory category);
51 
52  // ObjectMap interface
53 
64  template <class DataType>
65  void AddObject(const std::string &name, DataType &obj, const observer_ptr<ObjectProducer> &producer = nullptr);
66 
77  template <class DataType>
78  void AddObject(const std::string &name, observer_ptr<DataType> obj,
79  const observer_ptr<ObjectProducer> &producer = nullptr);
80 
91  void AddObject(const std::string &name, const char *obj, const observer_ptr<ObjectProducer> & = nullptr);
92 
103  template <class DataType>
104  void AddObject(const std::string &name, std::shared_ptr<DataType> obj,
105  const observer_ptr<ObjectProducer> &producer = nullptr);
106 
117  template <class DataType>
118  void AddObject(const std::string &name, std::unique_ptr<DataType> obj,
119  const observer_ptr<ObjectProducer> & = nullptr);
120 
128  void SetAlias(const std::string &objName, const std::string &objAlias);
129 
143  template <class DataType> observer_ptr<DataType> GetObject(const std::string &name);
144 
155  bool RemoveObject(const std::string &name, bool removeAliased = false);
156 
163  std::vector<std::string> GetObjects() const { return ObjectMap::GetObjects(); }
164 
170  bool IsPresent(const std::string &nameOrAlias) { return ObjectMap::IsPresent(nameOrAlias); }
171 
179  struct KnownObject {
180  std::string name;
181  std::set<std::string> aliases;
182 
190  bool operator==(const std::string &rhs) const { return name == rhs; };
191  };
192 
211  const std::vector<KnownObject> &GetKnownObjects();
212 
219  std::string GetAlias(const std::string &name) const { return ObjectMap::GetAlias(name); }
220 
225  std::vector<std::string> GetAliases() const { return ObjectMap::GetAliases(); }
226 
234  bool Clean();
235 
242 
249  bool IsAlias(const std::string &objName) { return ObjectMap::IsAlias(objName); }
250 
258  const std::string &GetNameOfAliasedObject(const std::string &aliasName) {
259  return ObjectMap::GetNameOfAliasedObject(aliasName);
260  }
261 
274  ObjectWrapper GetObjectWrapper(const std::string &objName);
275 
276  // DataStore interface
287 
292  const std::vector<observer_ptr<DataProvider>> GetAttachedProviders() { return _providers; }
293 
301  void TrackRemovedObjects(bool track = true);
302 
307  bool IsTrackingRemovedObjects() { return (bool)_remObjTracker; }
308 
319  bool FreeRemoved(Memory::Status memStatus);
320 
331  bool SetAlgoProducedObjects(const AlgoSequence &seq);
332 
338  bool IsAlgoProducedObject(const std::string nameOrAlias);
339 
340 protected:
346  template <class DataType> ObjPtr<DataType> GetFromMap(const std::string &name);
347 
356  RetrievalResult GetFromProvider(const std::string &name, ObjectWrapper &wrapper, std::string &actualName,
357  observer_ptr<ObjectProducer> &provider);
358 
373  template <class DataType>
374  ObjPtr<DataType> CastAndWrap(const std::string &name, const std::string &actualName, ObjectWrapper &&wrapper,
376 
381  void AddKnownObjects(const ObjectProducer &producer);
382 
383 private:
384  std::vector<observer_ptr<DataProvider>> _providers;
386  std::vector<KnownObject> _knownObjects;
388 
389  std::unique_ptr<RemovedObjectsTracker> _remObjTracker;
390 
391  // The following two containers are kept ordered
392  std::list<std::string> _algoProdObjects;
393  std::list<std::string> _algoProdAliases;
394 };
395 
401 class OwningDataStore : public DataStore {
402 public:
403  OwningDataStore(const std::string &name, ObjectCategory category) : DataStore(name, category) {}
404 
405  template <class DataType> void AddObject(const std::string &name, std::shared_ptr<DataType> obj) {
406  DataStore::AddObject(name, obj);
407  }
408 };
409 
411 public:
412  GlobalDataStore(const std::string &name) : OwningDataStore(name, ObjectCategory::GLOBAL) {}
413 };
414 
415 class PassDataStore : public DataStore {
416 public:
417  PassDataStore(const std::string &name) : DataStore(name, ObjectCategory::PASS) {}
418 };
419 
420 class EventDataStore : public DataStore {
421 public:
422  EventDataStore(const std::string &name) : DataStore(name, ObjectCategory::EVENT) {}
423 
432  bool AddEventCache(observer_ptr<EventDataCache> cache);
433 
446  template <class DataType> observer_ptr<DataType> GetObject(const std::string &name);
447 
448 private:
450 };
451 
452 } // namespace EA
453 
454 #include "data/DataStore.hpp"
455 
456 #endif /* DATASTORE_H_ */
bool AddProvider(observer_ptr< DataProvider > provider)
Adds a data provider in the data store.
Definition: DataStore.cpp:107
std::string GetAlias(const std::string &name) const
Get the alias of an object.
Definition: DataStore.h:219
std::string name
Definition: DataStore.h:180
bool IsAlias(const std::string &objName)
Checks if an object name is actually an alias.
Definition: DataStore.h:249
Objects with values defined on a per-event basis.
Class describing a pointer to an object retrieved from an ObjectMap.
Definition: ObjPtr.h:31
bool IsPresent(const std::string &nameOrAlias) const
Checks if an object is present in the map.
Definition: ObjectMap.cpp:123
std::unique_ptr< RemovedObjectsTracker > _remObjTracker
Definition: DataStore.h:389
Definition: DataStore.h:415
bool CleanAliases()
Removes all the aliases from the map.
Definition: ObjectMap.cpp:138
bool CleanAliases()
Removes all the aliases from the store.
Definition: DataStore.h:241
bool SetAlgoProducedObjects(const AlgoSequence &seq)
Notify the data store about objects that are produced by the algorithms.
Definition: DataStore.cpp:61
void TrackRemovedObjects(bool track=true)
Enables the tracking of removed objects.
Definition: DataStore.cpp:134
EventDataStore(const std::string &name)
Definition: DataStore.h:422
bool Clean()
Removes all the objects and aliases from the store.
Definition: DataStore.cpp:97
std::list< std::string > _algoProdAliases
Definition: DataStore.h:393
bool _providersCheckedForProducedObjects
Definition: DataStore.h:387
std::vector< std::string > GetAliases() const
Returns the aliases of the objects in the map.
Definition: DataStore.h:225
OwningDataStore(const std::string &name, ObjectCategory category)
Definition: DataStore.h:403
Descriptor for a known object.
Definition: DataStore.h:179
observer_ptr< EventDataCache > _eventCache
Definition: DataStore.h:449
bool operator==(const std::string &rhs) const
All the aliases that might be used for the object.
Definition: DataStore.h:190
A smart pointer not owning the wrapped object.
Definition: ObserverPtr.h:28
GlobalDataStore(const std::string &name)
Definition: DataStore.h:412
std::vector< KnownObject > _knownObjects
Definition: DataStore.h:386
const std::vector< observer_ptr< DataProvider > > GetAttachedProviders()
Gets all the providers attached to the data store.
Definition: DataStore.h:292
const std::string & GetNameOfAliasedObject(const std::string &aliasName)
Gets the name of the object corresponding to an alias.
Definition: ObjectMap.cpp:70
bool IsPresent(const std::string &nameOrAlias)
Checks if an object is present in the map.
Definition: DataStore.h:170
std::set< std::string > aliases
The name of the object.
Definition: DataStore.h:181
Interface for retrieving informations about an object.
Definition: Info.h:18
bool IsAlgoProducedObject(const std::string nameOrAlias)
Checks if a given object is produced by an algorithm.
Definition: DataStore.cpp:89
RetrievalResult
Definition: RetrievalResult.h:16
bool IsAlias(const std::string &objName)
Checks if an object name is actually an alias.
Definition: ObjectMap.cpp:203
const std::vector< KnownObject > & GetKnownObjects()
Returns a list of all the objects that are known to the store.
Definition: DataStore.cpp:44
Algorithm made by multiple basic algorithms.
Definition: AlgoSequence.h:37
IncludeFileExc.h IncludeFileExc class declaration.
Definition: Algorithm.h:21
A map between strings and objects of ObjectWrapper kind.
Definition: ObjectMap.h:32
bool RemoveObject(const std::string &name, bool removeAliased=false)
Removes an object or an alias from the map.
Definition: DataStore.cpp:27
void SetAlias(const std::string &objName, const std::string &objAlias)
Set an alias for the given object.
Definition: DataStore.cpp:37
void AddKnownObjects(const ObjectProducer &producer)
Definition: DataStore.cpp:195
A data store owning all of the contained objects.
Definition: DataStore.h:401
std::string GetAlias(const std::string &name) const
Get the alias of an object.
Definition: ObjectMap.cpp:184
ObjPtr< DataType > GetFromMap(const std::string &name)
Retrieves an object from the internal ObjectMap.
Definition: DataStore.hpp:108
Objects with values defined on a per-pass basis.
RetrievalResult GetFromProvider(const std::string &name, ObjectWrapper &wrapper, std::string &actualName, observer_ptr< ObjectProducer > &provider)
Retrieves an object from the registered providers.
Definition: DataStore.cpp:176
ObjectCategory
Category of objects.
Definition: ObjectCategory.h:17
Generic wrapper class.
Definition: ObjectWrapper.h:28
void AddObject(const std::string &name, DataType &obj, const observer_ptr< ObjectProducer > &producer=nullptr)
Adds an object to the map, storing also the producer.
Definition: DataStore.hpp:15
std::vector< std::string > GetObjects() const
Returns the names of the objects in the map.
Definition: ObjectMap.cpp:114
std::vector< std::string > GetObjects() const
Returns the names of the objects in the store.
Definition: DataStore.h:163
ObjPtr< DataType > CastAndWrap(const std::string &name, const std::string &actualName, ObjectWrapper &&wrapper, observer_ptr< ObjectProducer > provider)
Casts the wrapper to the template type, registers the object in the store and wraps it inside the ret...
Definition: DataStore.hpp:113
Definition: DataStore.h:420
PassDataStore(const std::string &name)
Definition: DataStore.h:417
std::vector< std::string > GetAliases() const
Returns the aliases of the objects in the map.
Definition: ObjectMap.cpp:194
std::list< std::string > _algoProdObjects
Definition: DataStore.h:392
Interface for a class which produced data objects.
Definition: ObjectProducer.h:29
DataStore(const std::string &name, ObjectCategory category)
Definition: DataStore.cpp:17
Status
Aliases for memory occupation levels.
Definition: Memory.h:23
bool IsTrackingRemovedObjects()
Checks whether the data store is tracking removed objects or not.
Definition: DataStore.h:307
std::vector< observer_ptr< DataProvider > > _providers
Definition: DataStore.h:384
Undefined value (for default initialization).
observer_ptr< DataType > GetObject(const std::string &name)
Provides a data object.
Definition: DataStore.hpp:67
void AddObject(const std::string &name, std::shared_ptr< DataType > obj)
Definition: DataStore.h:405
Definition: DataStore.h:410
Data store class.
Definition: DataStore.h:41
ObjectWrapper GetObjectWrapper(const std::string &objName)
Provides a data object wrapper.
Definition: DataStore.cpp:142
bool FreeRemoved(Memory::Status memStatus)
Release the memory allocated for removed objects.
Definition: DataStore.cpp:54
const std::string & GetNameOfAliasedObject(const std::string &aliasName)
Gets the name of the object corresponding to an alias.
Definition: DataStore.h:258
ObjectCategory _category
Definition: DataStore.h:385