Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator > Class Template Reference

#include <NekManager.hpp>

Public Types
typedef std::shared_ptr< ValueT >	ValueType
typedef std::function< ValueType(const KeyType &key)>	CreateFuncType
typedef std::map< KeyType, ValueType >	ValueContainer
typedef std::shared_ptr< ValueContainer >	ValueContainerShPtr
typedef std::map< KeyType, CreateFuncType, opLessCreator >	CreateFuncContainer
typedef std::map< std::string, std::shared_ptr< ValueContainer > >	ValueContainerPool
typedef std::shared_ptr< bool >	BoolSharedPtr
typedef std::map< std::string, BoolSharedPtr >	FlagContainerPool

Public Member Functions
	NekManager (std::string whichPool="")
	NekManager (CreateFuncType f, std::string whichPool="")
	~NekManager ()
bool	RegisterCreator (const KeyType &key, const CreateFuncType &createFunc)
	Register the given function and associate it with the key. The return value is just to facilitate calling statically. More...
bool	RegisterGlobalCreator (const CreateFuncType &createFunc)
	Register the Global Create Function. The return value is just to facilitate calling statically. More...
bool	AlreadyCreated (const KeyType &key)
ValueType	operator[] (const KeyType &key)
void	DeleteObject (const KeyType &key)

Static Public Member Functions
static void	ClearManager (std::string whichPool="")
static bool	PoolCreated (std::string whichPool)
static void	EnableManagement (std::string whichPool="")
static void	DisableManagement (std::string whichPool="")

Private Member Functions
NekManager< KeyType, ValueType, opLessCreator > &	operator= (const NekManager< KeyType, ValueType, opLessCreator > &rhs)
	NekManager (const NekManager< KeyType, ValueType, opLessCreator > &rhs)

Private Attributes
ValueContainerShPtr	m_values
BoolSharedPtr	m_managementEnabled
CreateFuncType	m_globalCreateFunc
CreateFuncContainer	m_keySpecificCreateFuncs

Static Private Attributes
static ValueContainerPool	m_ValueContainerPool
static FlagContainerPool	m_managementEnabledContainerPool

Detailed Description

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>
class Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >

Definition at line 69 of file NekManager.hpp.

Member Typedef Documentation

BoolSharedPtr

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

typedef std::shared_ptr<bool> Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::BoolSharedPtr

Definition at line 78 of file NekManager.hpp.

CreateFuncContainer

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

typedef std::map<KeyType, CreateFuncType, opLessCreator> Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::CreateFuncContainer

Definition at line 76 of file NekManager.hpp.

CreateFuncType

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

typedef std::function<ValueType (const KeyType& key)> Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::CreateFuncType

Definition at line 73 of file NekManager.hpp.

FlagContainerPool

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

typedef std::map<std::string, BoolSharedPtr> Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::FlagContainerPool

Definition at line 79 of file NekManager.hpp.

ValueContainer

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

typedef std::map<KeyType, ValueType> Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::ValueContainer

Definition at line 74 of file NekManager.hpp.

ValueContainerPool

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

typedef std::map<std::string, std::shared_ptr<ValueContainer> > Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::ValueContainerPool

Definition at line 77 of file NekManager.hpp.

ValueContainerShPtr

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

typedef std::shared_ptr<ValueContainer> Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::ValueContainerShPtr

Definition at line 75 of file NekManager.hpp.

ValueType

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

typedef std::shared_ptr<ValueT> Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::ValueType

Definition at line 72 of file NekManager.hpp.

Constructor & Destructor Documentation

NekManager() [1/3]

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::NekManager ( std::string  whichPool = "" )

inline

Definition at line 81 of file NekManager.hpp.

                                                   :
                    m_values(),
                    m_globalCreateFunc(),
                    m_keySpecificCreateFuncs()

                {
                    if (!whichPool.empty())
                    {
                        auto iter = m_ValueContainerPool.find(whichPool);
                        if (iter != m_ValueContainerPool.end())
                        {
                            m_values = iter->second;
                            m_managementEnabled = m_managementEnabledContainerPool[whichPool];
                        }
                        else
                        {
                            m_values = ValueContainerShPtr(new ValueContainer);
                            m_ValueContainerPool[whichPool] = m_values;
                            if (m_managementEnabledContainerPool.find(whichPool) == m_managementEnabledContainerPool.end())
                            {
                                m_managementEnabledContainerPool[whichPool] = BoolSharedPtr(new bool(true));
                            }
                            m_managementEnabled = m_managementEnabledContainerPool[whichPool];
                        }
                    }
                    else
                    {
                        m_values = ValueContainerShPtr(new ValueContainer);
                        m_managementEnabled = BoolSharedPtr(new bool(true));
                    }
                };

NekManager() [2/3]

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::NekManager ( CreateFuncType  f, std::string  whichPool = ""  )

inlineexplicit

Definition at line 114 of file NekManager.hpp.

                                                                              :
                    m_values(),
                    m_globalCreateFunc(f),
                    m_keySpecificCreateFuncs()
                {
                    if (!whichPool.empty())
                    {
#ifdef NEKTAR_USE_THREAD_SAFETY
                        ReadLock v_rlock(m_mutex); // reading static members
#endif
                        auto iter = m_ValueContainerPool.find(whichPool);
                        if (iter != m_ValueContainerPool.end())
                        {
                            m_values = iter->second;
                            m_managementEnabled = m_managementEnabledContainerPool[whichPool];
                        }
                        else
                        {
#ifdef NEKTAR_USE_THREAD_SAFETY
                            v_rlock.unlock();
                            // now writing static members.  Apparently
                            // upgrade_lock has less desirable properties than
                            // just dropping read lock, grabbing write lock.
                            // write will block until all reads are done, but
                            // reads cannot be acquired if write lock is
                            // blocking.  In this context writes are supposed to
                            // be rare.
                            WriteLock v_wlock(m_mutex);
#endif
                            m_values = ValueContainerShPtr(new ValueContainer);
                            m_ValueContainerPool[whichPool] = m_values;
                            if (m_managementEnabledContainerPool.find(whichPool) == m_managementEnabledContainerPool.end())
                            {
                                m_managementEnabledContainerPool[whichPool] = BoolSharedPtr(new bool(true));
                            }
                            m_managementEnabled = m_managementEnabledContainerPool[whichPool];
                        }

                    }
                    else
                    {
                        m_values = ValueContainerShPtr(new ValueContainer);
                        m_managementEnabled = BoolSharedPtr(new bool(true));
                    }
                }

~NekManager()

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::~NekManager ( )

inline

Definition at line 160 of file NekManager.hpp.

                {
                }

NekManager() [3/3]

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::NekManager ( const NekManager< KeyType, ValueType, opLessCreator > &  rhs )

private

Member Function Documentation

AlreadyCreated()

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

bool Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::AlreadyCreated ( const KeyType &  key )

inline

Definition at line 183 of file NekManager.hpp.

                {
                    bool value = false;
                    auto found = m_values->find(key);
                    if( found != m_values->end() )
                    {
                        value = true;
                    }

                    return value;
                }

ClearManager()

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

static void Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::ClearManager ( std::string  whichPool = "" )

inlinestatic

Definition at line 244 of file NekManager.hpp.

                {
                    if (!whichPool.empty())
                    {
#ifdef NEKTAR_USE_THREAD_SAFETY
                        WriteLock v_wlock(m_mutex);
#endif
                        auto x = m_ValueContainerPool.find(whichPool);
                        ASSERTL1(x != m_ValueContainerPool.end(),
                                "Could not find pool " + whichPool);
                        x->second->clear();
                    }
                    else
                    {
#ifdef NEKTAR_USE_THREAD_SAFETY
                        WriteLock v_wlock(m_mutex);
#endif

                        for (auto &x : m_ValueContainerPool)
                        {
                            x.second->clear();
                        }
                    }
                }

DeleteObject()

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

void Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::DeleteObject ( const KeyType &  key )

inline

Definition at line 234 of file NekManager.hpp.

                {
                    auto found = m_values->find(key);

                    if( found != m_values->end() )
                    {
                        m_values->erase(found);
                    }
                }

DisableManagement()

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

static void Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::DisableManagement ( std::string  whichPool = "" )

inlinestatic

Definition at line 300 of file NekManager.hpp.

Referenced by Nektar::VortexWaveInteraction::ExecuteLoop().

                {
                    if (!whichPool.empty())
                    {
#ifdef NEKTAR_USE_THREAD_SAFETY
                        WriteLock v_wlock(m_mutex);
#endif
                        auto x = m_managementEnabledContainerPool.find(whichPool);
                        if (x != m_managementEnabledContainerPool.end())
                        {
                            (*x->second) = false;
                        }
                        else
                        {
                            m_managementEnabledContainerPool[whichPool] = BoolSharedPtr(new bool(false));
                        }
                    }
                }

EnableManagement()

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

static void Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::EnableManagement ( std::string  whichPool = "" )

inlinestatic

Definition at line 280 of file NekManager.hpp.

Referenced by Nektar::VortexWaveInteraction::ExecuteLoop().

                {
                    if (!whichPool.empty())
                    {
#ifdef NEKTAR_USE_THREAD_SAFETY
                        WriteLock v_wlock(m_mutex);
#endif

                        auto x = m_managementEnabledContainerPool.find(whichPool);
                        if (x != m_managementEnabledContainerPool.end())
                        {
                            (*x->second) = true;
                        }
                        else
                        {
                            m_managementEnabledContainerPool[whichPool] = BoolSharedPtr(new bool(true));
                        }
                    }
                }

operator=()

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

NekManager<KeyType, ValueType, opLessCreator>& Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::operator= ( const NekManager< KeyType, ValueType, opLessCreator > &  rhs )

private

operator[]()

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

ValueType Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::operator[] ( const KeyType &  key )

inline

Definition at line 195 of file NekManager.hpp.

                {
                    auto found = m_values->find(key);

                    if( found != m_values->end() )
                    {
                        return (*found).second;
                    }
                    else
                    {
                        // No object, create a new one.
                        CreateFuncType f = m_globalCreateFunc;
                        auto keyFound = m_keySpecificCreateFuncs.find(key);
                        if( keyFound != m_keySpecificCreateFuncs.end() )
                        {
                            f = (*keyFound).second;
                        }

                        if( f )
                        {
                            ValueType v = f(key);
                            if (*m_managementEnabled)
                            {
                                (*m_values)[key] = v;
                            }
                            return v;
                        }
                        else
                        {
                            std::stringstream ss;
                            ss << key;
                            std::string message = "No create func found for key " + ss.str();
                            NEKERROR(ErrorUtil::efatal, message.c_str());
                            static ValueType result;
                            return result;
                        }
                    }
                }

PoolCreated()

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

static bool Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::PoolCreated ( std::string  whichPool )

inlinestatic

Definition at line 269 of file NekManager.hpp.

                {
                    bool value = false;
                    auto x = m_ValueContainerPool.find(whichPool);
                    if (x != m_ValueContainerPool.end())
                    {
                        value = true;
                    }
                    return value;
                }

RegisterCreator()

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

bool Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::RegisterCreator ( const KeyType &  key, const CreateFuncType &  createFunc  )

inline

Register the given function and associate it with the key. The return value is just to facilitate calling statically.

Definition at line 166 of file NekManager.hpp.

                {
                    m_keySpecificCreateFuncs[key] = createFunc;

                    return true;
                }

RegisterGlobalCreator()

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

bool Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::RegisterGlobalCreator ( const CreateFuncType &  createFunc )

inline

Register the Global Create Function. The return value is just to facilitate calling statically.

Definition at line 176 of file NekManager.hpp.

Referenced by Nektar::LibUtilities::TimeIntegrationSchemeManager().

                {
                    m_globalCreateFunc = createFunc;

                    return true;
                }

Member Data Documentation

m_globalCreateFunc

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

CreateFuncType Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::m_globalCreateFunc

private

Definition at line 327 of file NekManager.hpp.

m_keySpecificCreateFuncs

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

CreateFuncContainer Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::m_keySpecificCreateFuncs

private

Definition at line 328 of file NekManager.hpp.

m_managementEnabled

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

BoolSharedPtr Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::m_managementEnabled

private

Definition at line 324 of file NekManager.hpp.

m_managementEnabledContainerPool

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

NekManager< KeyType, ValueT, opLessCreator >::FlagContainerPool Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::m_managementEnabledContainerPool

staticprivate

Definition at line 326 of file NekManager.hpp.

m_ValueContainerPool

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

NekManager< KeyType, ValueT, opLessCreator >::ValueContainerPool Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::m_ValueContainerPool

staticprivate

Definition at line 325 of file NekManager.hpp.

m_values

template<typename KeyType, typename ValueT, typename opLessCreator = defOpLessCreator<KeyType>>

ValueContainerShPtr Nektar::LibUtilities::NekManager< KeyType, ValueT, opLessCreator >::m_values

private

Definition at line 323 of file NekManager.hpp.