Cutelyst::StatusMessage Class Reference

Manage status messages over multiple requests stored in the Session. More...

#include <Cutelyst/Plugins/StatusMessage>

Inheritance diagram for Cutelyst::StatusMessage:

Public Member Functions
	StatusMessage (Application *parent)
virtual	~StatusMessage () override
QString	errorMgStashKey () const noexcept
QString	sessionPrefix () const noexcept
void	setErrorMgStashKey (const QString &errorMgStashKey)
void	setSessionPrefix (const QString &sessionPrefix)
void	setStatusMsgStashKey (const QString &statusMsgStashKey)
void	setTokenParam (const QString &tokenParam)
QString	statusMsgStashKey () const noexcept
QString	tokenParam () const noexcept
Public Member Functions inherited from Cutelyst::Plugin
	Plugin (Application *parent)
virtual bool	setup (Application *app)

Static Public Member Functions
static QString	error (Context *c, const QString &msg)
static ParamsMultiMap	errorQuery (Context *c, const QString &msg, ParamsMultiMap query={})
static void	load (Context *c)
static QString	status (Context *c, const QString &msg)
static ParamsMultiMap	statusQuery (Context *c, const QString &msg, ParamsMultiMap query={})

Protected Member Functions
virtual bool	setup (Application *app) override

Detailed Description

The StatusMessage plugin can be used to generate status messages that are saved to the user’s session that will be available over multiple requests. It distinguishes between normal status messages set via status() or statusQuery() and error messages set via error() or errorQuery(). The static load() method loads the status messages into the Context::stash() at appropriate places like the Auto() method of the root controller. The status messages will be identified by a message id put into the URL query of the request URL using the "mid" query key by default.

Usage example

Load the plugin in your applications’s init method:

#include <Cutelyst/Plugins/StatusMessage/StatusMessage>
 
bool MyCutelystApp::init()
{
     // other initialization stuff
     // ...
 
     new StatusMessage(this);
 
     // maybe more initialization stuff
     // ...
}

Then use for example your root controller’s Auto method to load the messages into the stash:

#include <Cutelyst/Plugins/StatusMessage/StatusMessage>
 
bool Root::Auto(Context *c)
{
     // other stuff
     // ...
 
     StatusMessage::load(c);
}

In another controller we can now generate a status and/or error message:

#include <Cutelyst/Plugins/StatusMessage/StatusMessage>
 
void MyOtherController::dostuff(Context *c)
{
     // do some stuff like creating something
 
     if (ok) {
         // this will redirect to a new URL that has a query set with mid=messagetoken
         // that will be used to load the message in the Auto method of the root controller
         // into the stash
         c->response()->redirect("/stuffdone",
                                 {},
                                 StatusMessage::statusQuery(c, "Successfully done your stuff."));
         return;
     }
 
     // handle errors
     // ...
}

Logging category

cutelyst.plugins.statusmessage
Logging with Cutelyst

Definition at line 84 of file statusmessage.h.

Constructor & Destructor Documentation

StatusMessage()

StatusMessage::StatusMessage

(

Application *

parent

)

Constructs a new StatusMessage object with the given Application parent.

Definition at line 42 of file statusmessage.cpp.

~StatusMessage()

StatusMessage::~StatusMessage ( )

overridevirtual

Destroys the StatusMessage object.

Definition at line 49 of file statusmessage.cpp.

Member Function Documentation

error()

QString StatusMessage::error ( Context *  c, const QString &  msg  )

static

Saves an error message msg and returns the generated message id (mid).

Definition at line 141 of file statusmessage.cpp.

References Cutelyst::Session::setValue().

errorMgStashKey()

QString StatusMessage::errorMgStashKey ( ) const

noexcept

Returns the name of the stash key where error messages are loaded when load() is called. Defaults to "error_msg".

Definition at line 90 of file statusmessage.cpp.

Referenced by setErrorMgStashKey().

errorQuery()

ParamsMultiMap StatusMessage::errorQuery ( Context *  c, const QString &  msg, ParamsMultiMap  query = {}  )

static

Saves an error message msg returning query parameters with the generated message id (mid) and it's token combined with query.

Definition at line 154 of file statusmessage.cpp.

References Cutelyst::Session::setValue().

load()

void StatusMessage::load ( Context *  c )

static

Load both messages that match the token param (mid=###) into the stash for display by the view.

Definition at line 102 of file statusmessage.cpp.

References Cutelyst::Session::deleteValues(), Cutelyst::Request::queryParam(), Cutelyst::Context::request, Cutelyst::Context::setStash(), and Cutelyst::Session::value().

sessionPrefix()

QString StatusMessage::sessionPrefix ( ) const

noexcept

Returns the key prefix inside Session where messages will be stored. Defaults to "status_mg".

Definition at line 54 of file statusmessage.cpp.

Referenced by setSessionPrefix().

setErrorMgStashKey()

void StatusMessage::setErrorMgStashKey

(

const QString &

errorMgStashKey

)

Sets the name of the stash key where error messages are loaded when load() is called. Defaults to "error_msg".

Definition at line 96 of file statusmessage.cpp.

References errorMgStashKey().

setSessionPrefix()

void StatusMessage::setSessionPrefix

(

const QString &

sessionPrefix

)

Sets the key prefix inside Session where messages will be stored. Defaults to "status_msg".

Definition at line 60 of file statusmessage.cpp.

References sessionPrefix().

setStatusMsgStashKey()

void StatusMessage::setStatusMsgStashKey

(

const QString &

statusMsgStashKey

)

Sets the name of the stash key where "success" status messages are loaded when load() is called. Defaults to "status_msg".

Definition at line 84 of file statusmessage.cpp.

References statusMsgStashKey().

setTokenParam()

void StatusMessage::setTokenParam

(

const QString &

tokenParam

)

Sets the name of the URL query parameter that holds the token on the page where you want to retrieve/display the status message. Defaults to "mid".

Definition at line 72 of file statusmessage.cpp.

References tokenParam().

setup()

bool StatusMessage::setup ( Application *  app )

overrideprotectedvirtual

Reimplemented from Plugin::setup().

Reimplemented from Cutelyst::Plugin.

Definition at line 197 of file statusmessage.cpp.

References Cutelyst::Application::postForked().

status()

QString StatusMessage::status ( Context *  c, const QString &  msg  )

static

Saves a status message msg and returns the generated message id (mid).

Definition at line 169 of file statusmessage.cpp.

References Cutelyst::Session::setValue().

statusMsgStashKey()

QString StatusMessage::statusMsgStashKey ( ) const

noexcept

Returns the name of the stash key where "success" status messages are loaded when load() is called. Defaults to "status_msg".

Definition at line 78 of file statusmessage.cpp.

Referenced by setStatusMsgStashKey().

statusQuery()

ParamsMultiMap StatusMessage::statusQuery ( Context *  c, const QString &  msg, ParamsMultiMap  query = {}  )

static

Saves an status message msg returning query parameters with the generated message id (mid) and it's token combined with query.

Definition at line 182 of file statusmessage.cpp.

References Cutelyst::Session::setValue().

tokenParam()

QString StatusMessage::tokenParam ( ) const

noexcept

Returns the name of the URL query parameter that holds the token on the page where you want to retrieve/display the status message. Defaults to "mid".

Definition at line 66 of file statusmessage.cpp.

Referenced by setTokenParam().