IdentifiableCacheBase.h

Go to the documentation of this file.

// This file's extension implies that it's C, but it's really -*- C++ -*-.
 
/*
  Copyright (C) 2002-2025 CERN for the benefit of the ATLAS collaboration
*/
 
#ifndef EVENTCONTAINERS_IDENTIFIABLECACHEBASE_H
#define EVENTCONTAINERS_IDENTIFIABLECACHEBASE_H
 
 
#include "Identifier/IdentifierHash.h"
#include <memory>
#include <mutex>
#include <atomic>
#include "EventContainers/IDC_WriteHandleBase.h"
 
 
namespace EventContainers {
 
 
 
class IdentifiableCacheBase
{
 
public:
//here for access from other classes
static constexpr uintptr_t INVALIDflag = UINTPTR_MAX;
static constexpr uintptr_t ABORTEDflag = UINTPTR_MAX-1;
 
 
typedef std::true_type thread_safe;
 
#include "EventContainers/deleter.h"
 
  struct IMaker
  {
    bool m_IsReEntrant = false;
    virtual ~IMaker() {}
    virtual void_unique_ptr typelessMake (IdentifierHash hash) const = 0;  // unique_ptr<T>??
  };
  
  const void* find (IdentifierHash hash) noexcept;
  const void* findWait (IdentifierHash hash);
 
  const void* get (IdentifierHash hash);
 
  std::vector<IdentifierHash> ids();
  
  std::pair<bool, const void*> add (IdentifierHash hash, const void* p) noexcept;
 
  // addLock is same as method above except we check for invalid state first,
  // more optimal for calling using writehandle lock method
  std::pair<bool, const void*> addLock (IdentifierHash hash, const void* p) noexcept;
  std::pair<bool, const void*> addLock (IdentifierHash hash, void_unique_ptr p) noexcept;
  std::pair<bool, const void*> add (IdentifierHash hash, void_unique_ptr p) noexcept;
 
  bool IMakerPresent() const { return m_maker!=nullptr; }
 
  int tryLock(IdentifierHash, IDC_WriteHandleBase &, std::vector<IdentifierHash>&);
 
  int itemAborted(IdentifierHash);
 
  int itemInProgress(IdentifierHash);
 
  const void* waitFor(IdentifierHash);
 
  void createSet (const std::vector<IdentifierHash>& hashes, std::vector<bool> &mask);
 
  size_t fullSize() const { return m_vec.size(); }
  size_t numberOfHashes();
 
protected:
  IdentifiableCacheBase (IdentifierHash maxHash, const IMaker* maker);
  ~IdentifiableCacheBase();
  void clear (deleter_f* deleter);
  void cleanUp(deleter_f* deleter);//Call once before destruction
  void notifyHash(IdentifierHash hash);
private:
  std::vector<std::atomic<const void*> > m_vec;
  friend class InternalOnline;
  const IMaker* m_maker;
 
  typedef std::mutex mutex_t;
  typedef std::scoped_lock<mutex_t> lock_t;
  typedef std::unique_lock<mutex_t> uniqueLock;
  mutex_t m_mutex;
  std::atomic<size_t> m_currentHashes;
};
 
 
} // namespace EventContainers
 
 
#endif // not EVENTCONTAINERS_IDENTIFIABLECACHEBASE_H