Cutelyst  3.1.0
context.cpp
1 /*
2  * Copyright (C) 2013-2017 Daniel Nicoletti <dantti12@gmail.com>
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with this library; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17  */
18 #include "context_p.h"
19 
20 #include "common.h"
21 #include "request.h"
22 #include "response.h"
23 #include "action.h"
24 #include "dispatcher.h"
25 #include "controller.h"
26 #include "application.h"
27 #include "stats.h"
28 #include "enginerequest.h"
29 
30 #include "config.h"
31 
32 #include <QUrl>
33 #include <QUrlQuery>
34 #include <QCoreApplication>
35 #include <QBuffer>
36 
37 using namespace Cutelyst;
38 
39 Context::Context(ContextPrivate *priv) : d_ptr(priv)
40 {
41 }
42 
44  d_ptr(new ContextPrivate(app, app->engine(), app->dispatcher(), app->plugins()))
45 {
46  auto req = new DummyRequest(this);
47  req->body = new QBuffer(this);
49  req->context = this;
50 
51  d_ptr->response = new Response(app->defaultHeaders(), req);
52  d_ptr->request = new Request(req);
53  d_ptr->request->d_ptr->engine = d_ptr->engine;
54 }
55 
56 Context::~Context()
57 {
58  delete d_ptr->request;
59  delete d_ptr->response;
60  delete d_ptr;
61 }
62 
63 bool Context::error() const
64 {
65  Q_D(const Context);
66  return !d->error.isEmpty();
67 }
68 
69 void Context::error(const QString &error)
70 {
71  Q_D(Context);
72  if (error.isEmpty()) {
73  d->error.clear();
74  } else {
75  d->error << error;
76  qCCritical(CUTELYST_CORE) << error;
77  }
78 }
79 
81 {
82  Q_D(const Context);
83  return d->error;
84 }
85 
86 bool Context::state() const
87 {
88  Q_D(const Context);
89  return d->state;
90 }
91 
92 void Context::setState(bool state)
93 {
94  Q_D(Context);
95  d->state = state;
96 }
97 
99 {
100  Q_D(const Context);
101  return d->engine;
102 }
103 
105 {
106  Q_D(const Context);
107  return d->app;
108 }
109 
111 {
112  Q_D(const Context);
113  return d->response;
114 }
115 
117 {
118  Q_D(const Context);
119  return d->response;
120 }
121 
122 Action *Context::action() const
123 {
124  Q_D(const Context);
125  return d->action;
126 }
127 
128 QString Context::actionName() const
129 {
130  Q_D(const Context);
131  return d->action->name();
132 }
133 
134 QString Context::ns() const
135 {
136  Q_D(const Context);
137  return d->action->ns();
138 }
139 
140 Request *Context::request() const
141 {
142  Q_D(const Context);
143  return d->request;
144 }
145 
146 Request *Context::req() const
147 {
148  Q_D(const Context);
149  return d->request;
150 }
151 
153 {
154  Q_D(const Context);
155  return d->dispatcher;
156 }
157 
158 QString Cutelyst::Context::controllerName() const
159 {
160  Q_D(const Context);
161  return QString::fromLatin1(d->action->controller()->metaObject()->className());
162 }
163 
164 Controller *Context::controller() const
165 {
166  Q_D(const Context);
167  return d->action->controller();
168 }
169 
170 Controller *Context::controller(const QString &name) const
171 {
172  Q_D(const Context);
173  return d->dispatcher->controllers().value(name);
174 }
175 
177 {
178  Q_D(const Context);
179  return d->view;
180 }
181 
182 View *Context::view(const QString &name) const
183 {
184  Q_D(const Context);
185  return d->app->view(name);
186 }
187 
189 {
190  Q_D(Context);
191  d->view = d->app->view(name);
192  return d->view;
193 }
194 
195 QVariantHash &Context::stash()
196 {
197  Q_D(Context);
198  return d->stash;
199 }
200 
201 QVariant Context::stash(const QString &key) const
202 {
203  Q_D(const Context);
204  return d->stash.value(key);
205 }
206 
207 QVariant Context::stash(const QString &key, const QVariant &defaultValue) const
208 {
209  Q_D(const Context);
210  return d->stash.value(key, defaultValue);
211 }
212 
214 {
215  Q_D(Context);
216  return d->stash.take(key);
217 }
218 
220 {
221  Q_D(Context);
222  return d->stash.remove(key);
223 }
224 
225 void Context::setStash(const QString &key, const QVariant &value)
226 {
227  Q_D(Context);
228  d->stash.insert(key, value);
229 }
230 
231 void Context::setStash(const QString &key, const ParamsMultiMap &map)
232 {
233  Q_D(Context);
234  d->stash.insert(key, QVariant::fromValue(map));
235 }
236 
238 {
239  Q_D(const Context);
240  return d->stack;
241 }
242 
243 QUrl Context::uriFor(const QString &path, const QStringList &args, const ParamsMultiMap &queryValues) const
244 {
245  Q_D(const Context);
246 
247  QUrl uri = d->request->uri();
248 
249  QString _path;
250  if (path.isEmpty()) {
251  // ns must NOT return a leading slash
252  const QString controllerNS = d->action->controller()->ns();
253  if (!controllerNS.isEmpty()) {
254  _path.prepend(controllerNS);
255  }
256  } else {
257  _path = path;
258  }
259 
260  if (!args.isEmpty()) {
261  if (_path == QLatin1String("/")) {
262  _path += args.join(QLatin1Char('/'));
263  } else {
264  _path = _path + QLatin1Char('/') + args.join(QLatin1Char('/'));
265  }
266  }
267 
268  if (!_path.startsWith(QLatin1Char('/'))) {
269  _path.prepend(QLatin1Char('/'));
270  }
271  uri.setPath(_path, QUrl::DecodedMode);
272 
273  QUrlQuery query;
274  if (!queryValues.isEmpty()) {
275  // Avoid a trailing '?'
276  if (queryValues.size()) {
277  auto it = queryValues.constEnd();
278  while (it != queryValues.constBegin()) {
279  --it;
280  query.addQueryItem(it.key(), it.value());
281  }
282  }
283  }
284  uri.setQuery(query);
285 
286  return uri;
287 }
288 
289 QUrl Context::uriFor(Action *action, const QStringList &captures, const QStringList &args, const ParamsMultiMap &queryValues) const
290 {
291  Q_D(const Context);
292 
293  QUrl uri;
294  Action *localAction = action;
295  if (!localAction) {
296  localAction = d->action;
297  }
298 
299  QStringList localArgs = args;
300  QStringList localCaptures = captures;
301 
302  Action *expandedAction = d->dispatcher->expandAction(this, action);
303  if (expandedAction->numberOfCaptures() > 0) {
304  while (localCaptures.size() < expandedAction->numberOfCaptures()
305  && localArgs.size()) {
306  localCaptures.append(localArgs.takeFirst());
307  }
308  } else {
309  QStringList localCapturesAux = localCaptures;
310  localCapturesAux.append(localArgs);
311  localArgs = localCapturesAux;
312  localCaptures = QStringList();
313  }
314 
315  const QString path = d->dispatcher->uriForAction(localAction, localCaptures);
316  if (path.isEmpty()) {
317  qCWarning(CUTELYST_CORE) << "Can not find action for" << localAction << localCaptures;
318  return uri;
319  }
320 
321  uri = uriFor(path, localArgs, queryValues);
322  return uri;
323 }
324 
325 QUrl Context::uriForAction(const QString &path, const QStringList &captures, const QStringList &args, const ParamsMultiMap &queryValues) const
326 {
327  Q_D(const Context);
328 
329  QUrl uri;
330  Action *action = d->dispatcher->getActionByPath(path);
331  if (!action) {
332  qCWarning(CUTELYST_CORE) << "Can not find action for" << path;
333  return uri;
334  }
335 
336  uri = uriFor(action, captures, args, queryValues);
337  return uri;
338 }
339 
340 bool Context::detached() const
341 {
342  Q_D(const Context);
343  return d->detached;
344 }
345 
346 void Context::detach(Action *action)
347 {
348  Q_D(Context);
349  if (action) {
350  d->dispatcher->forward(this, action);
351  } else {
352  d->detached = true;
353  }
354 }
355 
357 {
358  Q_D(Context);
359  ++d->asyncDetached;
360 }
361 
363 {
364  Q_D(Context);
365  if (--d->asyncDetached) {
366  return;
367  }
368 
369  if (Q_UNLIKELY(d->engineRequest->status & EngineRequest::Finalized)) {
370  qCWarning(CUTELYST_ASYNC) << "Trying to async attach to a finalized request! Skipping...";
371  return;
372  }
373 
374  if (d->engineRequest->status & EngineRequest::Async) {
375  while (d->asyncAction < d->pendingAsync.size()) {
376  Action *action = d->pendingAsync[d->asyncAction++];
377  if (!execute(action)) {
378  break; // we are finished
379  } else if (d->asyncDetached) {
380  return;
381  }
382  }
383 
384  Q_EMIT d->app->afterDispatch(this);
385 
386  finalize();
387  }
388 }
389 
391 {
392  Q_D(Context);
393  return d->dispatcher->forward(this, action);
394 }
395 
396 bool Context::forward(const QString &action)
397 {
398  Q_D(Context);
399  return d->dispatcher->forward(this, action);
400 }
401 
402 Action *Context::getAction(const QString &action, const QString &ns) const
403 {
404  Q_D(const Context);
405  return d->dispatcher->getAction(action, ns);
406 }
407 
408 QVector<Action *> Context::getActions(const QString &action, const QString &ns) const
409 {
410  Q_D(const Context);
411  return d->dispatcher->getActions(action, ns);
412 }
413 
415 {
416  Q_D(const Context);
417  return d->plugins;
418 }
419 
421 {
422  Q_D(Context);
423  Q_ASSERT_X(code, "Context::execute", "trying to execute a null Cutelyst::Component");
424 
425  static int recursion = qEnvironmentVariableIsSet("RECURSION") ? qEnvironmentVariableIntValue("RECURSION") : 1000;
426  if (d->stack.size() >= recursion) {
427  QString msg = QStringLiteral("Deep recursion detected (stack size %1) calling %2, %3")
428  .arg(QString::number(d->stack.size()), code->reverse(), code->name());
429  error(msg);
430  setState(false);
431  return false;
432  }
433 
434  bool ret;
435  d->stack.push(code);
436 
437  if (d->stats) {
438  const QString statsInfo = d->statsStartExecute(code);
439 
440  ret = code->execute(this);
441 
442  // The request might finalize execution before returning
443  // so it's wise to check for d->stats again
444  if (d->stats && !statsInfo.isEmpty()) {
445  d->statsFinishExecute(statsInfo);
446  }
447  } else {
448  ret = code->execute(this);
449  }
450 
451  d->stack.pop();
452 
453  return ret;
454 }
455 
457 {
458  Q_D(const Context);
459  return d->locale;
460 }
461 
462 void Context::setLocale(const QLocale &locale)
463 {
464  Q_D(Context);
465  d->locale = locale;
466 }
467 
468 QVariant Context::config(const QString &key, const QVariant &defaultValue) const
469 {
470  Q_D(const Context);
471  return d->app->config(key, defaultValue);
472 }
473 
474 QVariantMap Context::config() const
475 {
476  Q_D(const Context);
477  return d->app->config();
478 }
479 
480 QString Context::translate(const char *context, const char *sourceText, const char *disambiguation, int n) const
481 {
482  Q_D(const Context);
483  return d->app->translate(d->locale, context, sourceText, disambiguation, n);
484 }
485 
487 {
488  Q_D(Context);
489 
490  if (Q_UNLIKELY(d->engineRequest->status & EngineRequest::Finalized)) {
491  qCWarning(CUTELYST_CORE) << "Trying to finalize a finalized request! Skipping...";
492  return;
493  }
494 
495  if (d->stats) {
496  qCDebug(CUTELYST_STATS, "Response Code: %d; Content-Type: %s; Content-Length: %s",
497  d->response->status(),
498  qPrintable(d->response->headers().header(QStringLiteral("CONTENT_TYPE"), QStringLiteral("unknown"))),
499  qPrintable(d->response->headers().header(QStringLiteral("CONTENT_LENGTH"), QStringLiteral("unknown"))));
500 
501  const double enlapsed = d->engineRequest->elapsed.nsecsElapsed() / 1000000000.0;
502  QString average;
503  if (enlapsed == 0.0) {
504  average = QStringLiteral("??");
505  } else {
506  average = QString::number(1.0 / enlapsed, 'f');
507  average.truncate(average.size() - 3);
508  }
509  qCInfo(CUTELYST_STATS) << qPrintable(QStringLiteral("Request took: %1s (%2/s)\n%3")
510  .arg(QString::number(enlapsed, 'f'),
511  average,
512  QString::fromLatin1(d->stats->report())));
513  delete d->stats;
514  d->stats = nullptr;
515  }
516 
517  d->engineRequest->finalize();
518 }
519 
520 QString ContextPrivate::statsStartExecute(Component *code)
521 {
522  QString actionName;
523  // Skip internal actions
524  if (code->name().startsWith(QLatin1Char('_'))) {
525  return actionName;
526  }
527 
528  actionName = code->reverse();
529 
530  if (qobject_cast<Action *>(code)) {
531  actionName.prepend(QLatin1Char('/'));
532  }
533 
534  if (stack.size() > 2) {
535  actionName = QLatin1String("-> ") + actionName;
536  actionName = actionName.rightJustified(actionName.size() + stack.size() - 2, QLatin1Char(' '));
537  }
538 
539  stats->profileStart(actionName);
540 
541  return actionName;
542 }
543 
544 void ContextPrivate::statsFinishExecute(const QString &statsInfo)
545 {
546  stats->profileEnd(statsInfo);
547 }
548 
549 void Context::stash(const QVariantHash &unite)
550 {
551  Q_D(Context);
552  auto it = unite.constBegin();
553  while (it != unite.constEnd()) {
554  d->stash.insert(it.key(), it.value());
555  ++it;
556  }
557 }
558 
559 #include "moc_context.cpp"
560 #include "moc_context_p.cpp"
This class represents a Cutelyst Action.
Definition: action.h:48
virtual qint8 numberOfCaptures() const
Definition: action.cpp:141
The Cutelyst Application.
Definition: application.h:56
Headers & defaultHeaders()
Definition: application.cpp:95
The Cutelyst Component base class.
Definition: component.h:39
bool execute(Context *c)
Definition: component.cpp:75
QString name() const
Definition: component.cpp:44
QString reverse() const
Definition: component.cpp:56
The Cutelyst Context.
Definition: context.h:52
void setState(bool state)
Sets the state of the current executed action, setting to false will make the dispatcher skip non pro...
Definition: context.cpp:92
Response * res() const
Definition: context.cpp:116
bool forward(Component *component)
Definition: context.cpp:390
QUrl uriFor(const QString &path=QString(), const QStringList &args=QStringList(), const ParamsMultiMap &queryValues=ParamsMultiMap()) const
Definition: context.cpp:243
Dispatcher * dispatcher() const
Definition: context.cpp:152
QVector< Plugin * > plugins() const
Definition: context.cpp:414
Context(Application *app)
Constructs a new DUMMY Context object that is child of Application This currently is experimental to ...
Definition: context.cpp:43
bool error() const
Returns true if an error was set.
Definition: context.cpp:63
Application * app() const
Definition: context.cpp:104
void detach(Action *action=nullptr)
Definition: context.cpp:346
QStringList errors() const
Returns a list of errors that were defined.
Definition: context.cpp:80
QVector< Action * > getActions(const QString &action, const QString &ns=QString()) const
Definition: context.cpp:408
QVariantHash & stash()
Definition: context.cpp:195
QStack< Component * > stack() const
Definition: context.cpp:237
QString translate(const char *context, const char *sourceText, const char *disambiguation=nullptr, int n=-1) const
Definition: context.cpp:480
void setStash(const QString &key, const QVariant &value)
Definition: context.cpp:225
View * customView() const
Definition: context.cpp:176
void finalize()
finalize the request right away this is automatically called at the end of the actions chain
Definition: context.cpp:486
bool stashRemove(const QString &key)
Definition: context.cpp:219
QVariant stashTake(const QString &key)
Definition: context.cpp:213
bool detached() const
Definition: context.cpp:340
Engine * engine() const
Definition: context.cpp:98
void attachAsync()
attachAsync
Definition: context.cpp:362
void setLocale(const QLocale &locale)
Definition: context.cpp:462
Response * response() const
Definition: context.cpp:110
QUrl uriForAction(const QString &path, const QStringList &captures=QStringList(), const QStringList &args=QStringList(), const ParamsMultiMap &queryValues=ParamsMultiMap()) const
Definition: context.cpp:325
bool execute(Component *code)
Definition: context.cpp:420
QLocale locale() const
Definition: context.cpp:456
bool setCustomView(const QString &name)
Definition: context.cpp:188
void detachAsync()
Definition: context.cpp:356
View * view(const QString &name=QString()) const
Definition: context.cpp:182
Action * getAction(const QString &action, const QString &ns=QString()) const
Definition: context.cpp:402
Cutelyst Controller base class
Definition: controller.h:103
The Cutelyst Dispatcher.
Definition: dispatcher.h:41
The Cutelyst Engine.
Definition: engine.h:34
QIODevice * body() const
Definition: request.cpp:192
Cutelyst View abstract view component
Definition: view.h:35
The Cutelyst namespace holds all public Cutelyst API.
Definition: Mainpage.dox:8
virtual bool open(QIODevice::OpenMode mode)
void append(const T &value)
bool isEmpty() const const
int size() const const
T takeFirst()
QMap::const_iterator constBegin() const const
QMap::const_iterator constEnd() const const
bool isEmpty() const const
int size() const const
Q_EMITQ_EMIT
QString arg(qlonglong a, int fieldWidth, int base, QChar fillChar) const const
QString fromLatin1(const char *str, int size)
bool isEmpty() const const
QString number(int n, int base)
QString & prepend(QChar ch)
QString rightJustified(int width, QChar fill, bool truncate) const const
int size() const const
bool startsWith(const QString &s, Qt::CaseSensitivity cs) const const
void truncate(int position)
QString join(const QString &separator) const const
void setPath(const QString &path, QUrl::ParsingMode mode)
void setQuery(const QString &query, QUrl::ParsingMode mode)
void addQueryItem(const QString &key, const QString &value)
QVariant fromValue(const T &value)