Cutelyst::Context Class Reference

The Cutelyst Context. More...

#include <Cutelyst/Context>

Inheritance diagram for Cutelyst::Context:

Public Slots
void	finalize ()

Public Member Functions
	Context (Application *app)
virtual	~Context ()
Action *	action () const noexcept
QString	actionName () const noexcept
Application *	app () const noexcept
void	appendError (const QString &error)
void	attachAsync ()
QVariantMap	config () const noexcept
QVariant	config (const QString &key, const QVariant &defaultValue={}) const
Controller *	controller () const noexcept
Controller *	controller (QStringView name) const
QString	controllerName () const noexcept
View *	customView () const noexcept
void	detach (Action *action=nullptr)
void	detachAsync () noexcept
bool	detached () const noexcept
Dispatcher *	dispatcher () const noexcept
Engine *	engine () const noexcept
bool	error () const noexcept
QStringList	errors () const noexcept
bool	execute (Component *code)
bool	forward (Component *component)
bool	forward (QStringView action)
Action *	getAction (QStringView action, QStringView ns={}) const
QVector< Action * >	getActions (QStringView action, QStringView ns={}) const
QLocale	locale () const noexcept
QString	ns () const noexcept
template<typename T >
T	plugin ()
QVector< Plugin * >	plugins () const
QString	qtTrId (const char *id, int n=-1) const
Request *	req () const noexcept
Request *	request () const noexcept
Response *	res () const noexcept
Response *	response () const noexcept
bool	setCustomView (QStringView name)
void	setLocale (const QLocale &locale)
void	setStash (const QString &key, const ParamsMultiMap &map)
void	setStash (const QString &key, const QVariant &value)
void	setState (bool state) noexcept
QStack< Component * >	stack () const noexcept
QVariantHash &	stash ()
QVariant	stash (const QString &key) const
QVariant	stash (const QString &key, const QVariant &defaultValue) const
void	stash (const QVariantHash &unite)
bool	stashRemove (const QString &key)
QVariant	stashTake (const QString &key)
bool	state () const noexcept
QString	translate (const char *context, const char *sourceText, const char *disambiguation=nullptr, int n=-1) const
QUrl	uriFor (Action *action, const ParamsMultiMap &queryValues) const
QUrl	uriFor (Action *action, const QStringList &captures={}, const QStringList &args={}, const ParamsMultiMap &queryValues={}) const
QUrl	uriFor (const QString &path, const ParamsMultiMap &queryValues) const
QUrl	uriFor (const QString &path={}, const QStringList &args={}, const ParamsMultiMap &queryValues={}) const
QUrl	uriForAction (QStringView path, const ParamsMultiMap &queryValues) const
QUrl	uriForAction (QStringView path, const QStringList &captures={}, const QStringList &args={}, const ParamsMultiMap &queryValues={}) const
View *	view (QStringView name={}) const

Protected Member Functions
	Context (ContextPrivate *priv)

Properties
Action *	action
QString	actionName
QVariantMap	config
Controller *	controller
QString	controllerName
QString	namespace
QString	ns
Request *	req
Request *	request
bool	state

Friends
class	Action
class	ActionChain
class	Application
class	Async
class	Controller
class	DispatchType
class	Engine
class	Plugin

Detailed Description

This is the context class that glues Request and Response plus some helper methods.

Logging category

cutelyst.core
Logging with Cutelyst

Definition at line 41 of file context.h.

Constructor & Destructor Documentation

Context() [1/2]

Context::Context

(

Application *

app

)

Constructs a new DUMMY Context object that is child of Application.

Warning

This currently is experimental to allow non network events (such as database notification) to be able to use our infrastructure.

Definition at line 30 of file context.cpp.

References app(), Cutelyst::Request::body(), Cutelyst::Application::defaultHeaders(), Cutelyst::Application::defaultLocale(), and req.

~Context()

Context::~Context ( )

virtual

Destroys the Context object. This will also delete the associated Request and Response.

Definition at line 44 of file context.cpp.

Context() [2/2]

Context::Context ( ContextPrivate *  priv )

protected

Constructs a new Context object using private implementation.

Definition at line 25 of file context.cpp.

Member Function Documentation

action()

Action * Context::action ( ) const

noexcept

Returns a pointer to the current action.

Definition at line 110 of file context.cpp.

actionName()

QString Context::actionName ( ) const

noexcept

Returns the private name of the current action.

Definition at line 116 of file context.cpp.

app()

Application * Context::app ( ) const

noexcept

Returns the application instance. See Cutelyst::Application.

Definition at line 92 of file context.cpp.

Referenced by Context().

appendError()

void Context::appendError

(

const QString &

error

)

Sets an error string and tries to stop.

See also

error() errors()

Definition at line 57 of file context.cpp.

References error().

Referenced by Cutelyst::Dispatcher::dispatch(), execute(), Cutelyst::ViewEmail::render(), and Cutelyst::CuteleeView::render().

attachAsync()

void Context::attachAsync

(

)

Reattaches to the processing chain in order to process the remaining of the action chaing. Call this after you called detachAsync().

The scoped ASync class can make handlying async requests easier.

Definition at line 356 of file context.cpp.

References action, execute(), and finalize().

config() [1/2]

QVariantMap Context::config ( ) const

noexcept

Returns a configuration mapping for all configuration entries read from the Cutelyst configuration section.

See also

Configure your application

Definition at line 479 of file context.cpp.

config() [2/2]

QVariant Context::config	(	const QString &	key,
		const QVariant &	defaultValue = {}
	)		const

Returns a configuration value for key. If key is not found, defaultValue will be returned.

This calls Application::config(), so it will only return entries from the Cutelyst configuration section.

See also

Configure your application

Definition at line 473 of file context.cpp.

controller() [1/2]

Controller * Context::controller ( ) const

noexcept

Returns the current controller.

Definition at line 152 of file context.cpp.

controller() [2/2]

Controller * Context::controller

(

QStringView

name

)

const

Returns the controller by name or nullptr if the controller is not found.

Definition at line 158 of file context.cpp.

controllerName()

QString Cutelyst::Context::controllerName ( ) const

noexcept

Returns the current controller name.

Definition at line 146 of file context.cpp.

customView()

View * Context::customView ( ) const

noexcept

Returns the View set to be used for rendering this request, if one is set by setCustomView() or nullptr if none was set.

Definition at line 164 of file context.cpp.

Referenced by Cutelyst::RenderView::doExecute().

detach()

void Context::detach

(

Action *

action = nullptr

)

The same as forward().

When called with no arguments it escapes the processing chain entirely.

See also

finalize()

Definition at line 340 of file context.cpp.

References action.

Referenced by Cutelyst::RoleACL::aroundExecute(), Cutelyst::Action::doExecute(), Cutelyst::LangSelect::fromPath(), and Cutelyst::LangSelect::fromUrlQuery().

detachAsync()

void Context::detachAsync ( )

noexcept

Detaches the processing chain telling the Engine that the request is not finished yet.

The scoped ASync class can make handling async requests easier.

It’s often useful to call async API’s. While convenient, the use of QEventLoop will only work for the first request or lead to a crash due stacking of calls.

This method, tells the Engine that this request is not finished yet, making it return to the event loop to process other requests or the task that was created prior to calling this.

Once done, call attachAsync() in order to process the remaining of the action chain.

Definition at line 350 of file context.cpp.

detached()

bool Context::detached ( ) const

noexcept

Returns true if the last executed Action requested that the processing be escaped.

Definition at line 334 of file context.cpp.

Referenced by Cutelyst::Action::doExecute().

dispatcher()

Dispatcher * Context::dispatcher ( ) const

noexcept

Returns the dispatcher instance. See Cutelyst::Dispatcher.

Definition at line 140 of file context.cpp.

engine()

Engine * Context::engine ( ) const

noexcept

Returns the engine instance. See Cutelyst::Engine.

Definition at line 86 of file context.cpp.

error()

bool Context::error ( ) const

noexcept

Returns true if an error was set.

See also

appendError() errors()

Definition at line 51 of file context.cpp.

Referenced by appendError(), and Cutelyst::EngineRequest::finalize().

errors()

QStringList Context::errors ( ) const

noexcept

Returns a list of errors that were defined.

See also

error() appendError()

Definition at line 68 of file context.cpp.

Referenced by Cutelyst::EngineRequest::finalizeError().

execute()

bool Context::execute

(

Component *

code

)

Execute an action. Errors are available via errors().

Definition at line 424 of file context.cpp.

References appendError(), Cutelyst::Component::execute(), Cutelyst::Component::name(), Cutelyst::Component::reverse(), and setState().

Referenced by attachAsync(), and Cutelyst::Dispatcher::forward().

finalize

void Context::finalize ( )

slot

Finalize the request right away. This is automatically called at the end of the actions chain.

Definition at line 494 of file context.cpp.

Referenced by attachAsync().

forward() [1/2]

bool Context::forward

(

Component *

component

)

This is one way of calling another action (method) in the same or a different controller. You can also use directly call another method to the same or a different controller.

The main difference is that 'forward' uses some of the Cutelyst request cycle overhead, including debugging, which may be useful to you. On the other hand, there are some complications to using 'forward', restrictions on values returned from 'forward', and it may not handle errors as you prefer. Whether you use 'forward' or not is up to you; it is not considered superior to the other ways to call a method.

This calls Component::execute().

Keep in mind that the End() method used is that of the caller action. So a c->detach() inside a forwarded action would run the End() method from the original action requested.

Definition at line 394 of file context.cpp.

References action.

Referenced by Cutelyst::RenderView::doExecute().

forward() [2/2]

bool Context::forward

(

QStringView

action

)

This is one way of calling another action (method) in the same or a different controller. You can also use directly call another method to the same or a different controller.

The main difference is that 'forward' uses some of the Cutelyst request cycle overhead, including debugging, which may be useful to you. On the other hand, there are some complications to using 'forward', restrictions on values returned from 'forward', and it may not handle errors as you prefer. Whether you use 'forward' or not is up to you; it is not considered superior to the other ways to call a method.

This calls another action, by its private name.

Keep in mind that the End() method used is that of the caller action. So a c->detach() inside a forwarded action would run the End() method from the original action requested.

Definition at line 400 of file context.cpp.

References action.

getAction()

Action * Context::getAction	(	QStringView	action,
		QStringView	ns = {}
	)		const

Gets an action in a given namespace ns.

Definition at line 406 of file context.cpp.

References action, and ns.

getActions()

QVector< Action * > Context::getActions	(	QStringView	action,
		QStringView	ns = {}
	)		const

Gets all actions of a given action name in a namespace ns and all parent namespaces.

Definition at line 412 of file context.cpp.

References action, and ns.

locale()

QLocale Context::locale ( ) const

noexcept

Returns the current locale to be used when processing a View or translating user messages.

If not explicity set by setLocale() it will use the default locale set via Application::setDefaultLocale().

See also

Translate your application

Definition at line 461 of file context.cpp.

Referenced by Cutelyst::ValidatorEmail::diagnoseString(), Cutelyst::LangSelect::fromPath(), Cutelyst::ValidatorAfter::genericValidationError(), Cutelyst::ValidatorBefore::genericValidationError(), Cutelyst::ValidatorBetween::genericValidationError(), Cutelyst::ValidatorIn::genericValidationError(), Cutelyst::ValidatorInteger::genericValidationError(), Cutelyst::ValidatorMax::genericValidationError(), Cutelyst::ValidatorMin::genericValidationError(), Cutelyst::ValidatorSize::genericValidationError(), Cutelyst::ValidatorFileSize::inputPattern(), Cutelyst::CuteleeView::render(), setLocale(), Cutelyst::ValidatorBetween::validate(), Cutelyst::ValidatorFileSize::validate(), Cutelyst::ValidatorMax::validate(), Cutelyst::ValidatorMin::validate(), and Cutelyst::ValidatorSize::validate().

ns()

QString Context::ns ( ) const

noexcept

Returns the namespace of the current action. I.e. the URI prefix corresponding to the controller of the current action.

For example: on a class named FooBar which inherits Controller this will return 'foo/bar'.

Definition at line 122 of file context.cpp.

plugin()

template<typename T >

T Cutelyst::Context::plugin ( )

inline

Returns the registered plugin that casts to the template type T.

Definition at line 490 of file context.h.

plugins()

QVector< Cutelyst::Plugin * > Context::plugins

(

)

const

Returns all registered plugins.

Definition at line 418 of file context.cpp.

qtTrId()

QString Cutelyst::Context::qtTrId ( const char *  id, int  n = -1  ) const

inline

Finds and returns a translated string.

Returns a translated string identified by id. If no matching string is found, the id itself is returned. This can be used similar to Qt’s global qtTrId() function.

If n >= 0, all occurences of %n in the resulting string are replaced with a decimal representation of n. In addition, appending n’s value, the translation may vary.

Meta data and comments can be passed as documented for QObject::tr(). In addition, it is possible to supply a source string template like that:

//% <C string>

or

\begincomment% <C string> \endcomment

Example:

void MyController::index(Context *c)
{
     //% "%n fooish bar(s) found.\n"
     //% "Do you want to continue?"
     c->res()->setBody(c->qtTrId("my-app-translation-id", n));
}

Creating QM files suitable for use with this function requires passing the -idbased option to the lrelease tool.

See also

Translate your application

Since

Cutelyst 3.9.0

Definition at line 656 of file context.h.

Referenced by Cutelyst::ValidatorEmail::categoryString(), Cutelyst::ValidatorDomain::diagnoseString(), Cutelyst::ValidatorEmail::diagnoseString(), Cutelyst::Dispatcher::dispatch(), Cutelyst::ValidatorPwQuality::errorString(), Cutelyst::Memcached::errorString(), Cutelyst::ValidatorBetween::genericParsingError(), Cutelyst::ValidatorMax::genericParsingError(), Cutelyst::ValidatorMin::genericParsingError(), Cutelyst::ValidatorSize::genericParsingError(), Cutelyst::ValidatorAfter::genericParsingError(), Cutelyst::ValidatorBefore::genericParsingError(), Cutelyst::ValidatorRule::genericParsingError(), Cutelyst::ValidatorBetween::genericValidationDataError(), Cutelyst::ValidatorFileSize::genericValidationDataError(), Cutelyst::ValidatorIn::genericValidationDataError(), Cutelyst::ValidatorMax::genericValidationDataError(), Cutelyst::ValidatorMin::genericValidationDataError(), Cutelyst::ValidatorNotIn::genericValidationDataError(), Cutelyst::ValidatorSize::genericValidationDataError(), Cutelyst::ValidatorAfter::genericValidationDataError(), Cutelyst::ValidatorBefore::genericValidationDataError(), Cutelyst::ValidatorCharNotAllowed::genericValidationDataError(), Cutelyst::ValidatorRule::genericValidationDataError(), Cutelyst::ValidatorAccepted::genericValidationError(), Cutelyst::ValidatorAfter::genericValidationError(), Cutelyst::ValidatorAlpha::genericValidationError(), Cutelyst::ValidatorAlphaDash::genericValidationError(), Cutelyst::ValidatorAlphaNum::genericValidationError(), Cutelyst::ValidatorBefore::genericValidationError(), Cutelyst::ValidatorBetween::genericValidationError(), Cutelyst::ValidatorBoolean::genericValidationError(), Cutelyst::ValidatorCharNotAllowed::genericValidationError(), Cutelyst::ValidatorConfirmed::genericValidationError(), Cutelyst::ValidatorDate::genericValidationError(), Cutelyst::ValidatorDateTime::genericValidationError(), Cutelyst::ValidatorDifferent::genericValidationError(), Cutelyst::ValidatorDigits::genericValidationError(), Cutelyst::ValidatorDigitsBetween::genericValidationError(), Cutelyst::ValidatorFileSize::genericValidationError(), Cutelyst::ValidatorFilled::genericValidationError(), Cutelyst::ValidatorIn::genericValidationError(), Cutelyst::ValidatorInteger::genericValidationError(), Cutelyst::ValidatorIp::genericValidationError(), Cutelyst::ValidatorJson::genericValidationError(), Cutelyst::ValidatorMax::genericValidationError(), Cutelyst::ValidatorMin::genericValidationError(), Cutelyst::ValidatorNotIn::genericValidationError(), Cutelyst::ValidatorNumeric::genericValidationError(), Cutelyst::ValidatorPresent::genericValidationError(), Cutelyst::ValidatorRegularExpression::genericValidationError(), Cutelyst::ValidatorRequired::genericValidationError(), Cutelyst::ValidatorRequiredIf::genericValidationError(), Cutelyst::ValidatorRequiredIfStash::genericValidationError(), Cutelyst::ValidatorRequiredUnless::genericValidationError(), Cutelyst::ValidatorRequiredUnlessStash::genericValidationError(), Cutelyst::ValidatorRequiredWith::genericValidationError(), Cutelyst::ValidatorRequiredWithAll::genericValidationError(), Cutelyst::ValidatorRequiredWithout::genericValidationError(), Cutelyst::ValidatorRequiredWithoutAll::genericValidationError(), Cutelyst::ValidatorSame::genericValidationError(), Cutelyst::ValidatorSize::genericValidationError(), Cutelyst::ValidatorTime::genericValidationError(), Cutelyst::ValidatorUrl::genericValidationError(), Cutelyst::ValidatorRule::genericValidationError(), Cutelyst::ValidatorRule::label(), Cutelyst::ValidatorRule::parsingError(), Cutelyst::CuteleeView::render(), Cutelyst::ValidatorRule::validationDataError(), and Cutelyst::ValidatorRule::validationError().

req()

Request * Context::req ( ) const

noexcept

Short for request().

Definition at line 134 of file context.cpp.

request()

Request * Context::request ( ) const

noexcept

Returns the current Request object containing information about the client request.

Definition at line 128 of file context.cpp.

res()

Response * Context::res ( ) const

noexcept

Returns the current Cutelyst::Response object, see there for details.

Definition at line 104 of file context.cpp.

Referenced by Cutelyst::RenderView::doExecute(), Cutelyst::LangSelect::fromPath(), and Cutelyst::CuteleeView::render().

response()

Response * Context::response ( ) const

noexcept

Returns the current Cutelyst::Response object, see there for details.

Definition at line 98 of file context.cpp.

Referenced by Cutelyst::EngineRequest::finalizeBody(), Cutelyst::EngineRequest::finalizeCookies(), Cutelyst::EngineRequest::finalizeError(), Cutelyst::EngineRequest::finalizeHeaders(), Cutelyst::UA::forwardAsync(), Cutelyst::UA::forwardRequestResponse(), and Cutelyst::ViewJson::render().

setCustomView()

bool Context::setCustomView

(

QStringView

name

)

Defines the View to be used to render the request, it must be previously be registered by Cutelyst::Application.

Action classes like RenderView will use this value to overwrite their settings.

Returns true if a view with the given name was found.

Definition at line 176 of file context.cpp.

setLocale()

void Context::setLocale

(

const QLocale &

locale

)

Defines the current locale to be used when processing a View or translating user messages.

Setting a locale on a web application can be done in many ways, so it’s up to the developer to decide which one to use.

For example it’s possible to try to guess the user locale with the request header Accept-Language, or use the chained dispatcher to first match the locale as in "example.com/pt-br/some_action", or store the locale into a cookie or session.

Be sure to set it as soon as possible so that all content can be properly localized.

See also

LangSelect

Translate your application

Definition at line 467 of file context.cpp.

References locale().

Referenced by Cutelyst::LangSelect::fromPath().

setStash() [1/2]

void Context::setStash	(	const QString &	key,
		const ParamsMultiMap &	map
	)

A convenient method to set a single ParamsMultiMap map to the stash on key.

Definition at line 219 of file context.cpp.

setStash() [2/2]

void Context::setStash	(	const QString &	key,
		const QVariant &	value
	)

A convenient method to set a single value to the stash on key.

Definition at line 213 of file context.cpp.

Referenced by Cutelyst::SessionStoreFile::deleteSessionData(), Cutelyst::MemcachedSessionStore::deleteSessionData(), Cutelyst::Session::deleteValue(), Cutelyst::Session::deleteValues(), Cutelyst::CSRFProtection::getToken(), Cutelyst::ValidatorFileSize::inputPattern(), Cutelyst::StatusMessage::load(), Cutelyst::ViewEmailTemplate::render(), Cutelyst::CuteleeView::render(), Cutelyst::Session::setValue(), Cutelyst::SessionStoreFile::storeSessionData(), Cutelyst::MemcachedSessionStore::storeSessionData(), and Cutelyst::Validator::validate().

setState()

void Context::setState ( bool  state )

noexcept

Sets the state of the current executed action. Setting to false will make the dispatcher skip non processed actions.

Definition at line 80 of file context.cpp.

Referenced by Cutelyst::Action::doExecute(), and execute().

stack()

QStack< Component * > Context::stack ( ) const

noexcept

Returns the internal execution stack (actions that are currently executing).

Definition at line 225 of file context.cpp.

stash() [1/4]

QVariantHash & Context::stash

(

)

Returns a QVariantHash reference to the stash, which may be used to store data and pass it between components during a request.

The stash is automatically sent to the view. The stash is cleared at the end of a request; it cannot be used for persistent storage (for this you must use a session; see Session for a complete system integrated with Cutelyst).

Definition at line 183 of file context.cpp.

stash() [2/4]

QVariant Context::stash

(

const QString &

key

)

const

A convenient method to retrieve a single value from the stash by key.

Definition at line 189 of file context.cpp.

stash() [3/4]

QVariant Context::stash	(	const QString &	key,
		const QVariant &	defaultValue
	)		const

A convenient method to retrieve a single value with the stash by key. If key is not found, defaultValue will be returned.

Definition at line 195 of file context.cpp.

stash() [4/4]

void Context::stash

(

const QVariantHash &

unite

)

You can set hash keys by passing arguments, that will be united with the stash, which may be used to store data and pass it between components during a request.

The stash is automatically sent to the View. The stash is cleared at the end of a request; it cannot be used for persistent storage (for this you must use a session; see Session for a complete system integrated with Cutelyst).

If a given key is present it will be replaced.

c->stash({
             {"foo", 10},
             {"bar", QStringLiteral("my stash value")}
           });

Definition at line 563 of file context.cpp.

Referenced by Cutelyst::CSRFProtection::checkPassed(), Cutelyst::ValidatorRule::defaultValue(), Cutelyst::Session::deleteReason(), Cutelyst::Session::deleteValue(), Cutelyst::Session::deleteValues(), Cutelyst::Session::expires(), Cutelyst::CSRFProtection::getToken(), Cutelyst::Session::id(), Cutelyst::ViewJson::render(), Cutelyst::ViewEmail::render(), Cutelyst::ViewEmailTemplate::render(), Cutelyst::CuteleeView::render(), Cutelyst::Session::setValue(), Cutelyst::Authentication::user(), Cutelyst::Authentication::userExists(), Cutelyst::Authentication::userInRealm(), Cutelyst::ValidatorIn::validate(), Cutelyst::ValidatorNotIn::validate(), Cutelyst::ValidatorPwQuality::validate(), Cutelyst::ValidatorRequiredIfStash::validate(), Cutelyst::ValidatorRequiredUnlessStash::validate(), and Cutelyst::Session::value().

stashRemove()

bool Context::stashRemove

(

const QString &

key

)

Removes the item that has the key from the stash. Returns true if any item was removed.

Definition at line 207 of file context.cpp.

stashTake()

QVariant Context::stashTake

(

const QString &

key

)

Removes the item with the key from the stash and returns the value associated with it. If the item does not exist in the stash, the function simply returns a default-constructed value. If you don’t use the return value, stashRemove() is more efficient.

Definition at line 201 of file context.cpp.

state()

bool Context::state ( ) const

noexcept

Contains the return value of the last executed action.

Definition at line 74 of file context.cpp.

translate()

QString Context::translate	(	const char *	context,
		const char *	sourceText,
		const char *	disambiguation = nullptr,
		int	n = -1
	)		const

Translates the sourceText for the given context into the language defined by locale().

See Application::addTranslator() for information about installation of translators. Internally this function will use QTranslator::translate().

void MyController::index(Context *c)
{
     c->res()->setBody(c->translate("MyController", "You are on the index page."));
}

See also

Translate your application

Definition at line 485 of file context.cpp.

Referenced by Cutelyst::ValidatorAfter::genericParsingError(), Cutelyst::ValidatorBefore::genericParsingError(), Cutelyst::ValidatorDate::genericValidationError(), Cutelyst::ValidatorDateTime::genericValidationError(), Cutelyst::ValidatorDifferent::genericValidationError(), Cutelyst::ValidatorSame::genericValidationError(), Cutelyst::ValidatorTime::genericValidationError(), Cutelyst::ValidatorRule::label(), Cutelyst::ValidatorRule::parsingError(), Cutelyst::ValidatorRule::validationDataError(), and Cutelyst::ValidatorRule::validationError().

uriFor() [1/4]

QUrl Cutelyst::Context::uriFor ( Action *  action, const ParamsMultiMap &  queryValues  ) const

inline

Constructs an absolute QUrl object based on the application root, the provided action and the query parameters queryValues provided. When used as a string, provides a textual URI.

Definition at line 646 of file context.h.

uriFor() [2/4]

QUrl Context::uriFor	(	Action *	action,
		const QStringList &	captures = {},
		const QStringList &	args = {},
		const ParamsMultiMap &	queryValues = {}
	)		const

Constructs an absolute QUrl object based on the application root, the provided action, captures, arguments args and query parameters queryValues. When used as a string, provides a textual URI.

If action is a nullptr, the URI for the current action is returned. To return the current action and also provide args, use c->uriFor(c->action(), args).

Definition at line 279 of file context.cpp.

References action, Cutelyst::Action::numberOfCaptures(), and uriFor().

uriFor() [3/4]

QUrl Cutelyst::Context::uriFor ( const QString &  path, const ParamsMultiMap &  queryValues  ) const

inline

Constructs an absolute QUrl object based on the application root, the provided path and the query parameters queryValues provided. When used as a string, provides a textual URI.

The first argument is taken as a public URI path relative c->ns() (if it doesn’t begin with a forward slash) or relative to the application root (if it does). It is then merged with c->request()->base() and any queryValues are appended as "?foo=bar" parameters.

Definition at line 641 of file context.h.

uriFor() [4/4]

QUrl Context::uriFor	(	const QString &	path = {},
		const QStringList &	args = {},
		const ParamsMultiMap &	queryValues = {}
	)		const

Constructs an absolute QUrl object based on the application root, the provided path, and the additional arguments args and query parameters queryValues provided. When used as a string, provides a textual URI.

The first argument is taken as a public URI path relative c->ns() (if it doesn’t begin with a forward slash) or relative to the application root (if it does). It is then merged with c->request()->base() any args are appended as additional path components; and any queryValues are appended as "?foo=bar" parameters.

Definition at line 231 of file context.cpp.

Referenced by uriFor(), and uriForAction().

uriForAction() [1/2]

QUrl Cutelyst::Context::uriForAction ( QStringView  path, const ParamsMultiMap &  queryValues  ) const

inline

A convenience method for the uriForAction() without the arguments parameter.

Definition at line 651 of file context.h.

uriForAction() [2/2]

QUrl Context::uriForAction	(	QStringView	path,
		const QStringList &	captures = {},
		const QStringList &	args = {},
		const ParamsMultiMap &	queryValues = {}
	)		const

A private path to the Cutelyst action you want to create a URI for.

This is a shortcut for calling c->dispatcher()->getActionByPath(path) and passing the resulting action and the remaining arguments to c->uriFor().

Note that although the path looks like a URI that dispatches to the wanted action, it is not a URI, but an internal path to that action.

For example, if the action looks like:

class Users : public Cutelyst::Controller
{
public:
  C_ATTR(lst, :Path(the-list))
  void lst(Context *c);
};

You can use: c->uriForAction('/users/lst'); and it will create the URI /users/the-list.

Definition at line 316 of file context.cpp.

References action, and uriFor().

view()

View * Context::view

(

QStringView

name = {}

)

const

Returns the View with name or nullptr if not found.

Definition at line 170 of file context.cpp.

Friends And Related Symbol Documentation

Action

friend class Action

friend

Definition at line 628 of file context.h.

ActionChain

friend class ActionChain

friend

Definition at line 629 of file context.h.

Application

friend class Application

friend

Definition at line 627 of file context.h.

Async

friend class Async

friend

Definition at line 634 of file context.h.

Controller

friend class Controller

friend

Definition at line 633 of file context.h.

DispatchType

friend class DispatchType

friend

Definition at line 630 of file context.h.

Engine

friend class Engine

friend

Definition at line 632 of file context.h.

Plugin

friend class Plugin

friend

Definition at line 631 of file context.h.

Property Documentation

action

Action * Cutelyst::Context::action

read

Pointer to the current action.

Definition at line 656 of file context.h.

Referenced by Cutelyst::Controller::_DISPATCH(), attachAsync(), detach(), Cutelyst::Dispatcher::dispatch(), forward(), forward(), getAction(), getActions(), Cutelyst::DispatchTypePath::match(), Cutelyst::CuteleeView::render(), Cutelyst::DispatchType::setupMatchedAction(), uriFor(), and uriForAction().

actionName

QString Cutelyst::Context::actionName

read

Private name of the current action

Definition at line 656 of file context.h.

Referenced by Cutelyst::ValidatorRule::debugString(), and Cutelyst::ValidatorRule::defaultValue().

config

QVariantMap Cutelyst::Context::config

read

Mapping for all configuration entries read from the Cutelyst configuration section.

See also

Configure your application

Definition at line 656 of file context.h.

controller

Controller * Cutelyst::Context::controller

read

The current controller.

Definition at line 656 of file context.h.

controllerName

QString Cutelyst::Context::controllerName

read

The current controller name.

Definition at line 656 of file context.h.

Referenced by Cutelyst::ValidatorRule::debugString(), and Cutelyst::ValidatorRule::defaultValue().

namespace

QString Cutelyst::Context::namespace

read

The namespace of the current action.

See also

ns()

Definition at line 656 of file context.h.

ns

QString Cutelyst::Context::ns

read

The namespace of the current action.

See also

ns()

Definition at line 656 of file context.h.

Referenced by getAction(), and getActions().

req

Request * Cutelyst::Context::req

read

The current Request object containing information about the client request.

Definition at line 656 of file context.h.

Referenced by Context(), Cutelyst::Component::aroundExecute(), Cutelyst::CSRFProtection::checkPassed(), Cutelyst::Dispatcher::dispatch(), Cutelyst::RenderView::doExecute(), Cutelyst::LangSelect::fromPath(), and Cutelyst::Validator::validate().

request

Request * Cutelyst::Context::request

read

The current Request object containing information about the client request.

Definition at line 656 of file context.h.

Referenced by Cutelyst::CredentialHttp::authenticate(), Cutelyst::Action::doExecute(), Cutelyst::ActionChain::doExecute(), Cutelyst::ActionREST::doExecute(), Cutelyst::Dispatcher::forward(), Cutelyst::UA::forwardAsync(), Cutelyst::UA::forwardRequestResponse(), Cutelyst::StatusMessage::load(), Cutelyst::DispatchTypeChained::match(), Cutelyst::DispatchTypePath::match(), Cutelyst::Dispatcher::prepareAction(), and Cutelyst::ViewJson::render().

state

bool Cutelyst::Context::state

read

Holds the return value of the last executed action.

Definition at line 656 of file context.h.