agg_util::AggMemberDatasetWithDimensionCacheBase Class Reference

Inheritance diagram for agg_util::AggMemberDatasetWithDimensionCacheBase:

Collaboration diagram for agg_util::AggMemberDatasetWithDimensionCacheBase:

Public Member Functions
void	addPreDeleteCB (UseCountHitZeroCB *pCB)
	AggMemberDatasetWithDimensionCacheBase (const AggMemberDatasetWithDimensionCacheBase &proto)
	AggMemberDatasetWithDimensionCacheBase (const std::string &location)
virtual void	fillDimensionCacheByUsingDDS ()
virtual void	flushDimensionCache ()
virtual unsigned int	getCachedDimensionSize (const std::string &dimName) const
virtual const libdap::DDS *	getDDS ()=0
const std::string &	getLocation () const
virtual int	getRefCount () const
virtual bool	isDimensionCached (const std::string &dimName) const
virtual void	loadDimensionCache (std::istream &istr)
AggMemberDatasetWithDimensionCacheBase &	operator= (const AggMemberDatasetWithDimensionCacheBase &rhs)
virtual int	ref () const
virtual void	removeFromPool () const
void	removePreDeleteCB (UseCountHitZeroCB *pCB)
virtual void	saveDimensionCache (std::ostream &ostr)
virtual void	setDimensionCacheFor (const Dimension &dim, bool throwIfFound)
virtual std::string	toString () const
virtual int	unref () const

Detailed Description

Definition at line 41 of file AggMemberDatasetWithDimensionCacheBase.h.

Constructor & Destructor Documentation

AggMemberDatasetWithDimensionCacheBase() [1/2]

agg_util::AggMemberDatasetWithDimensionCacheBase::AggMemberDatasetWithDimensionCacheBase

(

const std::string &

location

)

Definition at line 72 of file AggMemberDatasetWithDimensionCacheBase.cc.

AggMemberDatasetWithDimensionCacheBase() [2/2]

agg_util::AggMemberDatasetWithDimensionCacheBase::AggMemberDatasetWithDimensionCacheBase

(

const AggMemberDatasetWithDimensionCacheBase &

proto

)

Definition at line 84 of file AggMemberDatasetWithDimensionCacheBase.cc.

~AggMemberDatasetWithDimensionCacheBase()

agg_util::AggMemberDatasetWithDimensionCacheBase::~AggMemberDatasetWithDimensionCacheBase ( )

virtual

Definition at line 78 of file AggMemberDatasetWithDimensionCacheBase.cc.

Member Function Documentation

addPreDeleteCB()

void agg_util::RCObject::addPreDeleteCB ( UseCountHitZeroCB * pCB )

inherited

Add uniquely. If it is added agan, the second time is ignored.

fillDimensionCacheByUsingDDS()

void agg_util::AggMemberDatasetWithDimensionCacheBase::fillDimensionCacheByUsingDDS ( )

virtual

Uses the getDDS() call in order to find all named dimensions within it and to seed them into the dimension cache table for faster later lookups. Potentially slow!

Implements agg_util::AggMemberDataset.

Definition at line 146 of file AggMemberDatasetWithDimensionCacheBase.cc.

flushDimensionCache()

void agg_util::AggMemberDatasetWithDimensionCacheBase::flushDimensionCache ( )

virtual

Flush out any cache for the Dimensions so that it will have to be loaded.

Implements agg_util::AggMemberDataset.

Definition at line 161 of file AggMemberDatasetWithDimensionCacheBase.cc.

getCachedDimensionSize()

unsigned int agg_util::AggMemberDatasetWithDimensionCacheBase::getCachedDimensionSize ( const std::string & dimName ) const

virtual

Get the size of the given dimension named dimName cached within the dataset. If not found in cache, throws.

If a cached value exists from a prior load of the DDS using loadDimensionCacheFromDDS() or from a call to setDimensionCacheFor(), return that.

Otherwise, this must load the DDS to get the values.

Implementation is left up to subclasses for efficiency.

Returns

the size of the dimension if found

Exceptions

agg_util::DimensionNotFoundException

if not located via any means.

Implements agg_util::AggMemberDataset.

Definition at line 102 of file AggMemberDatasetWithDimensionCacheBase.cc.

getDDS()

virtual const libdap::DDS * agg_util::AggMemberDataset::getDDS ( )

pure virtualinherited

Return the DDS for the location, loading it in if it hasn't yet been loaded. Can return NULL if there's a problem. (Not const due to lazy eval)

Returns

the DDS ptr containing the loaded dataset or NULL.

Implemented in agg_util::AggMemberDatasetDDSWrapper, agg_util::AggMemberDatasetSharedDDSWrapper, and agg_util::AggMemberDatasetUsingLocationRef.

getLocation()

const std::string & agg_util::AggMemberDataset::getLocation ( ) const

inherited

The location to which the AggMemberDataset refers Note: this could be "" for some subclasses if they are virtual or nested

getRefCount()

virtual int agg_util::RCObject::getRefCount ( ) const

virtualinherited

Get the current reference count

Implements agg_util::RCObjectInterface.

isDimensionCached()

bool agg_util::AggMemberDatasetWithDimensionCacheBase::isDimensionCached ( const std::string & dimName ) const

virtual

Return whether the dimension is already cached, or would have to be loaded to be found.

Implements agg_util::AggMemberDataset.

Definition at line 116 of file AggMemberDatasetWithDimensionCacheBase.cc.

loadDimensionCache()

void agg_util::AggMemberDatasetWithDimensionCacheBase::loadDimensionCache ( std::istream & istr )

virtual

Load the values in the dimension cache from the input stream

Implements agg_util::AggMemberDataset.

Definition at line 173 of file AggMemberDatasetWithDimensionCacheBase.cc.

operator=()

AggMemberDatasetWithDimensionCacheBase & agg_util::AggMemberDatasetWithDimensionCacheBase::operator=

(

const AggMemberDatasetWithDimensionCacheBase &

rhs

)

Definition at line 91 of file AggMemberDatasetWithDimensionCacheBase.cc.

ref()

virtual int agg_util::RCObject::ref ( ) const

virtualinherited

Increase the reference count by one. const since we do not consider the ref count part of the semantic constness of the rep

Implements agg_util::RCObjectInterface.

removeFromPool()

virtual void agg_util::RCObject::removeFromPool ( ) const

virtualinherited

If the object is in an auto-delete pool, remove it from the pool and force it to only delete when it's ref count goes to 0. Useful when we desire a particular object stay around outside of the pool's lifetime.

Implements agg_util::RCObjectInterface.

removePreDeleteCB()

void agg_util::RCObject::removePreDeleteCB ( UseCountHitZeroCB * pCB )

inherited

Remove it exists. If not, this unchanged.

saveDimensionCache()

void agg_util::AggMemberDatasetWithDimensionCacheBase::saveDimensionCache ( std::ostream & ostr )

virtual

Append the values in the dimension cache to the output stream

Implements agg_util::AggMemberDataset.

Definition at line 167 of file AggMemberDatasetWithDimensionCacheBase.cc.

setDimensionCacheFor()

void agg_util::AggMemberDatasetWithDimensionCacheBase::setDimensionCacheFor ( const Dimension & dim, bool throwIfFound )

virtual

Seed the dimension cache using the given dimension, so that later calls to getDimensionSize for dim.name will return the dim.size immediately without checking or loading the actual DDS.

If it already exists and throwIfFound then will throw an AggregationException.

If it exists and !throwIfFound, will replace the old one.

Parameters

dim	the dimension to seed
if	true, throw if name take. Else replace original.

Implements agg_util::AggMemberDataset.

Definition at line 122 of file AggMemberDatasetWithDimensionCacheBase.cc.

toString()

virtual std::string agg_util::RCObject::toString ( ) const

virtualinherited

Just prints the count and address

Implements agg_util::RCObjectInterface.

Reimplemented in ncml_module::AggregationElement, ncml_module::AttributeElement, ncml_module::DimensionElement, ncml_module::ExplicitElement, ncml_module::NCMLElement, ncml_module::NetcdfElement, ncml_module::ReadMetadataElement, ncml_module::RemoveElement, ncml_module::ScanElement, ncml_module::ValuesElement, ncml_module::VariableAggElement, and ncml_module::VariableElement.

unref()

virtual int agg_util::RCObject::unref ( ) const

virtualinherited

Decrease the reference count by one. If it goes from 1 to 0, delete this and this is no longer valid.

Returns

the new ref count. If it is 0, the caller knows the object was deleted.

It is illegal to unref() an object with a count of 0. We don't throw to allow use in dtors, so the caller is assumed not to do it!

const since the reference count is not part of the semantic constness of the rep

Implements agg_util::RCObjectInterface.

---

The documentation for this class was generated from the following files:

• AggMemberDatasetWithDimensionCacheBase.h
• AggMemberDatasetWithDimensionCacheBase.cc