edm::eventsetup::DataProxy Class Reference

#include <DataProxy.h>

Inheritance diagram for edm::eventsetup::DataProxy:

Public Member Functions
bool	cacheIsValid () const
	DataProxy ()
	DataProxy (DataProxy const &)=delete
void	doGet (EventSetupRecordImpl const &, DataKey const &, bool iTransiently, ActivityRegistry const *, EventSetupImpl const *) const
void const *	get (EventSetupRecordImpl const &, DataKey const &, bool iTransiently, ActivityRegistry const *, EventSetupImpl const *) const
virtual void	initializeForNewIOV ()
void	invalidate ()
DataProxy const &	operator= (DataProxy const &)=delete
ComponentDescription const *	providerDescription () const
	returns the description of the DataProxyProvider which owns this Proxy More...
void	resetIfTransient ()
void	setProviderDescription (ComponentDescription const *iDesc)
virtual	~DataProxy ()

Protected Member Functions
void	clearCacheIsValid ()
virtual void const *	getImpl (EventSetupRecordImpl const &, DataKey const &iKey, EventSetupImpl const *)=0
virtual void	invalidateCache ()=0
virtual void	invalidateTransientCache ()

Private Attributes
void const *	cache_
std::atomic< bool >	cacheIsValid_
ComponentDescription const *	description_
std::atomic< bool >	nonTransientAccessRequested_

Detailed Description

Description: Base class for data Proxies held by a EventSetupRecord

Usage: This class defines the interface used to handle retrieving data from an EventSetup Record.

Definition at line 38 of file DataProxy.h.

Constructor & Destructor Documentation

DataProxy() [1/2]

DataProxy< RecordT, DataT, Initializer >::DataProxy

(

)

Definition at line 32 of file DataProxy.cc.

        : description_(dummyDescription()),
          cache_(nullptr),
          cacheIsValid_(false),
          nonTransientAccessRequested_(false) {}

DataProxy() [2/2]

edm::eventsetup::DataProxy::DataProxy ( DataProxy const &  )

delete

~DataProxy()

DataProxy< RecordT, DataT, Initializer >::~DataProxy ( )

virtual

Definition at line 38 of file DataProxy.cc.

{}

Member Function Documentation

cacheIsValid()

bool edm::eventsetup::DataProxy::cacheIsValid ( ) const

inline

Definition at line 46 of file DataProxy.h.

{ return cacheIsValid_.load(std::memory_order_acquire); }

References cacheIsValid_.

Referenced by get(), and edm::eventsetup::EventSetupRecordImpl::wasGotten().

clearCacheIsValid()

void DataProxy< RecordT, DataT, Initializer >::clearCacheIsValid ( )

protected

Definition at line 40 of file DataProxy.cc.

                                      {
      cacheIsValid_.store(false, std::memory_order_release);
      nonTransientAccessRequested_.store(false, std::memory_order_release);
      cache_ = nullptr;
    }

References cache_, cacheIsValid_, and nonTransientAccessRequested_.

Referenced by invalidate(), and resetIfTransient().

doGet()

void DataProxy< RecordT, DataT, Initializer >::doGet	(	EventSetupRecordImpl const &	iRecord,
		DataKey const &	iKey,
		bool	iTransiently,
		ActivityRegistry const *	activityRegistry,
		EventSetupImpl const *	iEventSetupImpl
	)		const

Definition at line 122 of file DataProxy.cc.

                                                                       {
      get(iRecord, iKey, iTransiently, activityRegistry, iEventSetupImpl);
    }

References get().

Referenced by edm::eventsetup::EventSetupRecordImpl::doGet().

get()

const void * DataProxy< RecordT, DataT, Initializer >::get	(	EventSetupRecordImpl const &	iRecord,
		DataKey const &	iKey,
		bool	iTransiently,
		ActivityRegistry const *	activityRegistry,
		EventSetupImpl const *	iEventSetupImpl
	)		const

Definition at line 93 of file DataProxy.cc.

                                                                            {
      if (!cacheIsValid()) {
        ESSignalSentry signalSentry(iRecord, iKey, providerDescription(), activityRegistry);
        std::lock_guard<std::recursive_mutex> guard(esGlobalMutex());
        signalSentry.sendPostLockSignal();
        if (!cacheIsValid()) {
          cache_ = const_cast<DataProxy*>(this)->getImpl(iRecord, iKey, iEventSetupImpl);
          cacheIsValid_.store(true, std::memory_order_release);
        }
      }
 
      //We need to set the AccessType for each request so this can't be called in the if block above.
      //This also must be before the cache_ check since we want to setCacheIsValid before a possible
      // exception throw. If we don't, 'getImpl' will be called again on a second request for the data.
 
      if (!iTransiently) {
        nonTransientAccessRequested_.store(true, std::memory_order_release);
      }
 
      if (nullptr == cache_) {
        throwMakeException(iRecord, iKey);
      }
      return cache_;
    }

References cache_, cacheIsValid(), cacheIsValid_, edm::esGlobalMutex(), nonTransientAccessRequested_, and providerDescription().

Referenced by Options.Options::__getitem__(), betterConfigParser.BetterConfigParser::__updateDict(), rrapi.RRApi::columns(), rrapi.RRApi::count(), rrapi.RRApi::data(), doGet(), betterConfigParser.BetterConfigParser::getCompares(), edm::eventsetup::EventSetupRecordImpl::getFromProxy(), betterConfigParser.BetterConfigParser::getGeneral(), betterConfigParser.BetterConfigParser::getResultingSection(), rrapi.RRApi::report(), rrapi.RRApi::reports(), rrapi.RRApi::tables(), rrapi.RRApi::tags(), rrapi.RRApi::templates(), and rrapi.RRApi::workspaces().

getImpl()

virtual void const* edm::eventsetup::DataProxy::getImpl ( EventSetupRecordImpl const &  , DataKey const &  iKey, EventSetupImpl const *    )

protectedpure virtual

This is the function which does the real work of getting the data if it is not already cached. The returning 'void const*' must point to an instance of the class type corresponding to the type designated in iKey. So if iKey refers to a base class interface the pointer must be a pointer to that base class interface and not a pointer to an inheriting class instance.

Implemented in edm::test::TestDataProxy< T >, edm::eventsetup::DataProxyTemplate< RecordT, DataT >, and edm::eventsetup::CallbackProxy< CallbackT, RecordT, DataT >.

initializeForNewIOV()

virtual void edm::eventsetup::DataProxy::initializeForNewIOV ( )

inlinevirtual

Reimplemented in DataProxy< RecordT, DataT, Initializer >.

Definition at line 72 of file DataProxy.h.

{}

invalidate()

void edm::eventsetup::DataProxy::invalidate ( )

inline

Definition at line 63 of file DataProxy.h.

                        {
        clearCacheIsValid();
        invalidateCache();
      }

References clearCacheIsValid(), and invalidateCache().

invalidateCache()

virtual void edm::eventsetup::DataProxy::invalidateCache ( )

protectedpure virtual

indicates that the Proxy should invalidate any cached information as that information has 'expired' (i.e. we have moved to a new IOV)

Implemented in edm::eventsetup::CallbackProxy< CallbackT, RecordT, DataT >, DataProxy< RecordT, DataT, Initializer >, and edm::test::TestDataProxy< T >.

Referenced by invalidate(), and invalidateTransientCache().

invalidateTransientCache()

void DataProxy< RecordT, DataT, Initializer >::invalidateTransientCache ( )

protectedvirtual

indicates that the Proxy should invalidate any cached information as that information was accessed transiently and therefore is not intended to be kept over the entire IOV. Default is to call invalidateCache().

Reimplemented in DataProxy< RecordT, DataT, Initializer >.

Definition at line 53 of file DataProxy.cc.

{ invalidateCache(); }

References invalidateCache().

Referenced by resetIfTransient().

operator=()

DataProxy const& edm::eventsetup::DataProxy::operator= ( DataProxy const &  )

delete

providerDescription()

ComponentDescription const* edm::eventsetup::DataProxy::providerDescription ( ) const

inline

returns the description of the DataProxyProvider which owns this Proxy

Definition at line 60 of file DataProxy.h.

{ return description_; }

References description_.

Referenced by edm::eventsetup::EventSetupRecordImpl::add(), edm::eventsetup::EventSetupRecordImpl::doGet(), get(), edm::eventsetup::EventSetupRecordImpl::getFromProxy(), and edm::eventsetup::EventSetupRecordImpl::providerDescription().

resetIfTransient()

void DataProxy< RecordT, DataT, Initializer >::resetIfTransient

(

)

Definition at line 46 of file DataProxy.cc.

                                     {
      if (!nonTransientAccessRequested_.load(std::memory_order_acquire)) {
        clearCacheIsValid();
        invalidateTransientCache();
      }
    }

References clearCacheIsValid(), invalidateTransientCache(), and nonTransientAccessRequested_.

setProviderDescription()

void edm::eventsetup::DataProxy::setProviderDescription ( ComponentDescription const *  iDesc )

inline

Definition at line 70 of file DataProxy.h.

{ description_ = iDesc; }

References description_.

Member Data Documentation

cache_

void const* edm::eventsetup::DataProxy::cache_

mutableprivate

Definition at line 100 of file DataProxy.h.

Referenced by clearCacheIsValid(), and get().

cacheIsValid_

std::atomic<bool> edm::eventsetup::DataProxy::cacheIsValid_

mutableprivate

Definition at line 101 of file DataProxy.h.

Referenced by cacheIsValid(), clearCacheIsValid(), and get().

description_

ComponentDescription const* edm::eventsetup::DataProxy::description_

private

Definition at line 99 of file DataProxy.h.

Referenced by providerDescription(), and setProviderDescription().

nonTransientAccessRequested_

std::atomic<bool> edm::eventsetup::DataProxy::nonTransientAccessRequested_

mutableprivate

Definition at line 134 of file DataProxy.h.

Referenced by clearCacheIsValid(), get(), and resetIfTransient().