template class Poco::AbstractStrategy

Overview

An AbstractStrategy is the interface for all strategies. More…

#include <AbstractStrategy.h>

template <
    class TKey,
    class TValue
    >
class AbstractStrategy
{
public:
    // methods

    virtual
    void
    onUpdate(
        const void* pSender,
        const KeyValueArgs<TKey, TValue>& args
        );

    virtual
    void
    onAdd(
        const void* pSender,
        const KeyValueArgs<TKey, TValue>& key
        ) = 0;

    virtual
    void
    onRemove(
        const void* pSender,
        const TKey& key
        ) = 0;

    virtual
    void
    onGet(
        const void* pSender,
        const TKey& key
        ) = 0;

    virtual
    void
    onClear(
        const void* pSender,
        const EventArgs& args
        ) = 0;

    virtual
    void
    onIsValid(
        const void* pSender,
        ValidArgs<TKey>& key
        ) = 0;

    virtual
    void
    onReplace(
        const void* pSender,
        std::set<TKey>& elemsToRemove
        ) = 0;
};

// direct descendants

template <
    class TKey,
    class TValue
    >
class ExpireStrategy;

template <
    class TKey,
    class TValue
    >
class LRUStrategy;

template <
    class TKey,
    class TValue
    >
class StrategyCollection;

template <
    class TKey,
    class TValue
    >
class UniqueAccessExpireStrategy;

template <
    class TKey,
    class TValue
    >
class UniqueExpireStrategy;

Detailed Documentation

An AbstractStrategy is the interface for all strategies.

Methods

virtual
void
onUpdate(
    const void* pSender,
    const KeyValueArgs<TKey, TValue>& args
    )

Updates an existing entry.

virtual
void
onAdd(
    const void* pSender,
    const KeyValueArgs<TKey, TValue>& key
    ) = 0

Adds the key to the strategy.

If for the key already an entry exists, an exception will be thrown.

virtual
void
onRemove(
    const void* pSender,
    const TKey& key
    ) = 0

Removes an entry from the strategy.

If the entry is not found the remove is ignored.

virtual
void
onGet(
    const void* pSender,
    const TKey& key
    ) = 0

Informs the strategy that a read-access happens to an element.

virtual
void
onClear(
    const void* pSender,
    const EventArgs& args
    ) = 0

Removes all elements from the cache.

virtual
void
onIsValid(
    const void* pSender,
    ValidArgs<TKey>& key
    ) = 0

Used to query if a key is still valid (i.e. cached).

virtual
void
onReplace(
    const void* pSender,
    std::set<TKey>& elemsToRemove
    ) = 0

Used by the Strategy to indicate which elements should be removed from the cache.

Note that onReplace does not change the current list of keys. The cache object is reponsible to remove the elements.