cutelyst 3.9.1
A C++ Web Framework built on top of Qt, using the simple approach of Catalyst (Perl) framework.
Cutelyst::MemcachedSessionStore Class Reference

Memcached based session store. More...

#include <memcachedsessionstore.h>

Inheritance diagram for Cutelyst::MemcachedSessionStore:

Public Member Functions

 MemcachedSessionStore (Application *app, QObject *parent=nullptr)
 ~MemcachedSessionStore ()
virtual bool deleteExpiredSessions (Context *c, quint64 expires) final
virtual bool deleteSessionData (Context *c, const QString &sid, const QString &key) final
virtual QVariant getSessionData (Context *c, const QString &sid, const QString &key, const QVariant &defaultValue) final
void setGroupKey (const QString &groupKey)
virtual bool storeSessionData (Context *c, const QString &sid, const QString &key, const QVariant &value) final
Public Member Functions inherited from Cutelyst::SessionStore
 SessionStore (QObject *parent=nullptr)
Public Member Functions inherited from QObject
 QObject (QObject *parent)
bool blockSignals (bool block)
const QObjectListchildren () const const
QMetaObject::Connection connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const const
void deleteLater ()
void destroyed (QObject *obj)
bool disconnect (const char *signal, const QObject *receiver, const char *method) const const
bool disconnect (const QObject *receiver, const char *method) const const
void dumpObjectInfo ()
void dumpObjectInfo () const const
void dumpObjectTree ()
void dumpObjectTree () const const
QList< QByteArraydynamicPropertyNames () const const
virtual bool event (QEvent *e)
virtual bool eventFilter (QObject *watched, QEvent *event)
findChild (const QString &name, Qt::FindChildOptions options) const const
QList< T > findChildren (const QRegExp &regExp, Qt::FindChildOptions options) const const
QList< T > findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const
QList< T > findChildren (const QString &name, Qt::FindChildOptions options) const const
bool inherits (const char *className) const const
void installEventFilter (QObject *filterObj)
bool isWidgetType () const const
bool isWindowType () const const
void killTimer (int id)
virtual const QMetaObjectmetaObject () const const
void moveToThread (QThread *targetThread)
QString objectName () const const
void objectNameChanged (const QString &objectName, QPrivateSignal)
QObjectparent () const const
QVariant property (const char *name) const const
 Q_CLASSINFO (Name, Value)
 Q_DISABLE_COPY (Class)
 Q_DISABLE_COPY_MOVE (Class)
 Q_DISABLE_MOVE (Class)
 Q_EMIT Q_EMIT
 Q_ENUM (...)
 Q_ENUM_NS (...)
 Q_ENUMS (...)
 Q_FLAG (...)
 Q_FLAG_NS (...)
 Q_FLAGS (...)
 Q_GADGET Q_GADGET
 Q_INTERFACES (...)
 Q_INVOKABLE Q_INVOKABLE
 Q_NAMESPACE Q_NAMESPACE
 Q_NAMESPACE_EXPORT (EXPORT_MACRO)
 Q_OBJECT Q_OBJECT
 Q_PROPERTY (...)
 Q_REVISION Q_REVISION
 Q_SET_OBJECT_NAME (Object)
 Q_SIGNAL Q_SIGNAL
 Q_SIGNALS Q_SIGNALS
 Q_SLOT Q_SLOT
 Q_SLOTS Q_SLOTS
qFindChild (const QObject *obj, const QString &name)
QList< T > qFindChildren (const QObject *obj, const QRegExp &regExp)
QList< T > qFindChildren (const QObject *obj, const QString &name)
qobject_cast (const QObject *object)
qobject_cast (QObject *object)
 QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT
void removeEventFilter (QObject *obj)
void setObjectName (const QString &name)
void setParent (QObject *parent)
bool setProperty (const char *name, const QVariant &value)
bool signalsBlocked () const const
int startTimer (int interval, Qt::TimerType timerType)
int startTimer (std::chrono::milliseconds time, Qt::TimerType timerType)
QThreadthread () const const

Additional Inherited Members

Static Public Member Functions inherited from QObject
QMetaObject::Connection connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
QMetaObject::Connection connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, const QObject *context, Functor functor, Qt::ConnectionType type)
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method, Qt::ConnectionType type)
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)
bool disconnect (const QMetaObject::Connection &connection)
bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
bool disconnect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method)
QString tr (const char *sourceText, const char *disambiguation, int n)
QString trUtf8 (const char *sourceText, const char *disambiguation, int n)
Public Attributes inherited from QObject
typedef QObjectList
Protected Member Functions inherited from QObject
virtual void childEvent (QChildEvent *event)
virtual void connectNotify (const QMetaMethod &signal)
virtual void customEvent (QEvent *event)
virtual void disconnectNotify (const QMetaMethod &signal)
bool isSignalConnected (const QMetaMethod &signal) const const
int receivers (const char *signal) const const
QObjectsender () const const
int senderSignalIndex () const const
virtual void timerEvent (QTimerEvent *event)
Properties inherited from QObject
 objectName

Detailed Description

This session store saves session data to Memcached servers using the Memcached plugin. It obsoletes the SessionStoreMemcached class.

Note
The memcached server does not guarantee the existence of the session data. It might for example delete the data because it runs out of memory and deletes session data. So be careful when using this plugin to store sessions.

Configuration

The MemcachedSessionStore plugin can be configured in the cutelyst configuration file in the Cutelyst_MemcachedSessionStore_Plugin section.

Currently there are the following configuration options:

  • group_key - string value, defines a group key to store the data on a specific server (default: empty)

Configuration example

[Cutelyst_MemcachedSessionStore_Plugin]
group_key=sessions

Usage example

#include <Cutelyst/Plugins/Memcached/Memcached>
#include <Cutelyst/Plugins/MemcachedSessionStore/MemcachedSessionStore>
bool MyCutelystApp::init()
{
// other initilization stuff
// ...
new Memcached(this);
auto sess = new Session(this);
sess->setStorage(new MemcachedSessionStore(this));
// maybe more initilization stuff
// ...
}
MemcachedSessionStore(Application *app, QObject *parent=nullptr)
Cutelyst Memcached plugin.
Definition memcached.h:158

Build requirements

To build this plugin you need the development and header files for libmemcached and have to enable the Memcached plugin. If the Memcached plugin is enabled, the MemcachedSessionStore plugin will be enabled automatically, too. To disable the build of the MemcachedSessionStore plugin, run cmake with -DPLUGIN_MEMCACHEDSESSIONSTORE:BOOL=OFF.

Since
Cutelyst 1.11.0

Definition at line 72 of file memcachedsessionstore.h.

Constructor & Destructor Documentation

◆ MemcachedSessionStore()

MemcachedSessionStore::MemcachedSessionStore ( Cutelyst::Application * app,
QObject * parent = nullptr )

Constructs a new MemcachedSessionStore object with the given parent and app. The pointer to the Application object is used to load the plugin configuration from the configuration file section Cutelyst_MemcachedSessionStore_Plugin.

Definition at line 25 of file memcachedsessionstore.cpp.

References MemcachedSessionStore(), QObject::QObject(), Cutelyst::SessionStore::SessionStore(), Cutelyst::Engine::config(), Cutelyst::Application::engine(), and QObject::parent().

Referenced by MemcachedSessionStore(), deleteSessionData(), getSessionData(), setGroupKey(), and storeSessionData().

◆ ~MemcachedSessionStore()

MemcachedSessionStore::~MemcachedSessionStore ( )

Deconstructs the MemcachedSessionStore object

Definition at line 38 of file memcachedsessionstore.cpp.

Member Function Documentation

◆ deleteExpiredSessions()

bool MemcachedSessionStore::deleteExpiredSessions ( Context * c,
quint64 expires )
finalvirtual

Removes all expired sessions which are above expires.

Implements Cutelyst::SessionStore.

Definition at line 79 of file memcachedsessionstore.cpp.

◆ deleteSessionData()

bool MemcachedSessionStore::deleteSessionData ( Context * c,
const QString & sid,
const QString & key )
finalvirtual

Removes all session data for the given session id sid and key.

Implements Cutelyst::SessionStore.

Definition at line 68 of file memcachedsessionstore.cpp.

References MemcachedSessionStore(), and Cutelyst::Context::setStash().

◆ getSessionData()

QVariant MemcachedSessionStore::getSessionData ( Context * c,
const QString & sid,
const QString & key,
const QVariant & defaultValue )
finalvirtual

Returns the session data for the given session id sid and key, if key does not exist returns defaultValue.

Implements Cutelyst::SessionStore.

Definition at line 42 of file memcachedsessionstore.cpp.

References MemcachedSessionStore(), and QVariant::value().

◆ setGroupKey()

void MemcachedSessionStore::setGroupKey ( const QString & groupKey)

Sets the groupKey to define the servers to store the sessions on. This can also be set in the configuration file.

Definition at line 87 of file memcachedsessionstore.cpp.

References MemcachedSessionStore().

◆ storeSessionData()

bool MemcachedSessionStore::storeSessionData ( Context * c,
const QString & sid,
const QString & key,
const QVariant & value )
finalvirtual

Stores the session data for the given session id sid and key to value.

Implements Cutelyst::SessionStore.

Definition at line 54 of file memcachedsessionstore.cpp.

References MemcachedSessionStore(), and Cutelyst::Context::setStash().