template class Poco::UniqueAccessExpireStrategy

Overview

An UniqueExpireStrategy implements time based expiration of cache entries. More…

#include <UniqueAccessExpireStrategy.h>

template <
    class TKey,
    class TValue
    >
class UniqueAccessExpireStrategy: public Poco::AbstractStrategy
{
public:
    // typedefs

    typedef std::pair<TKey, Timespan> KeyExpire;
    typedef std::multimap<Timestamp, KeyExpire> TimeIndex;
    typedef TimeIndex::iterator IndexIterator;
    typedef TimeIndex::const_iterator ConstIndexIterator;
    typedef std::map<TKey, IndexIterator> Keys;
    typedef Keys::iterator Iterator;

    // methods

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

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

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

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

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

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

protected:
    // fields

    Keys _keys;
    TimeIndex _keyIndex;
};

Inherited Members

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;

Detailed Documentation

An UniqueExpireStrategy implements time based expiration of cache entries.

In contrast to ExpireStrategy which only allows to set a per cache expiration value, it allows to define expiration per CacheEntry. Each TValue object must thus offer the following method:

const Poco::Timestamp& getTimeout() const;

which returns the timespan for how long an object will be valid without being accessed.

Fields

Keys _keys

For faster replacement of keys, the iterator points to the _keyIndex map.

TimeIndex _keyIndex

Maps time to key value.

Methods

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

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
    )

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
    )

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

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

Removes all elements from the cache.

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

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

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

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.