cutelyst  3.7.0
A C++ Web Framework built on top of Qt, using the simple approach of Catalyst (Perl) framework.
response.cpp
1 /*
2  * SPDX-FileCopyrightText: (C) 2013-2022 Daniel Nicoletti <dantti12@gmail.com>
3  * SPDX-License-Identifier: BSD-3-Clause
4  */
5 #include "response_p.h"
6 
7 #include "context_p.h"
8 #include "engine.h"
9 #include "enginerequest.h"
10 #include "common.h"
11 
12 #include <QtCore/QJsonDocument>
13 
14 #include <QCryptographicHash>
15 #include <QEventLoop>
16 
17 using namespace Cutelyst;
18 
19 Response::Response(const Headers &defaultHeaders, EngineRequest *engineRequest)
20  : d_ptr(new ResponsePrivate(defaultHeaders, engineRequest))
21 {
22  open(QIODevice::WriteOnly);
23 }
24 
25 qint64 Response::readData(char *data, qint64 maxlen)
26 {
27  Q_UNUSED(data)
28  Q_UNUSED(maxlen)
29  return -1;
30 }
31 
32 qint64 Response::writeData(const char *data, qint64 len)
33 {
34  Q_D(Response);
35 
36  if (len <= 0) {
37  return len;
38  }
39 
40  // Finalize headers if someone manually writes output
41  if (!(d->engineRequest->status & EngineRequest::FinalizedHeaders)) {
42  if (d->headers.header(QStringLiteral("TRANSFER_ENCODING")).compare(u"chunked") == 0) {
43  d->engineRequest->status |= EngineRequest::IOWrite | EngineRequest::Chunked;
44  } else {
45  // When chunked encoding is not set the client can only know
46  // that data is finished if we close the connection
47  d->headers.setHeader(QStringLiteral("CONNECTION"), QStringLiteral("close"));
48  d->engineRequest->status |= EngineRequest::IOWrite;
49  }
50  delete d->bodyIODevice;
51  d->bodyIODevice = nullptr;
52  d->bodyData = QByteArray();
53 
54  d->engineRequest->finalizeHeaders();
55  }
56 
57  return d->engineRequest->write(data, len);
58 }
59 
60 Response::~Response()
61 {
62  delete d_ptr->bodyIODevice;
63  delete d_ptr;
64 }
65 
66 quint16 Response::status() const noexcept
67 {
68  Q_D(const Response);
69  return d->status;
70 }
71 
72 void Response::setStatus(quint16 status) noexcept
73 {
74  Q_D(Response);
75  d->status = status;
76 }
77 
78 bool Response::hasBody() const noexcept
79 {
80  Q_D(const Response);
81  return !d->bodyData.isEmpty() || d->bodyIODevice || d->engineRequest->status & EngineRequest::IOWrite;
82 }
83 
84 QByteArray &Response::body()
85 {
86  Q_D(Response);
87  if (d->bodyIODevice) {
88  delete d->bodyIODevice;
89  d->bodyIODevice = nullptr;
90  }
91 
92  return d->bodyData;
93 }
94 
95 QIODevice *Response::bodyDevice() const
96 {
97  Q_D(const Response);
98  return d->bodyIODevice;
99 }
100 
101 void Response::setBody(QIODevice *body)
102 {
103  Q_D(Response);
104  Q_ASSERT(body && body->isOpen() && body->isReadable());
105 
106  if (!(d->engineRequest->status & EngineRequest::IOWrite)) {
107  d->bodyData = QByteArray();
108  if (d->bodyIODevice) {
109  delete d->bodyIODevice;
110  }
111  d->bodyIODevice = body;
112  }
113 }
114 
115 void Response::setBody(const QByteArray &body)
116 {
117  Q_D(Response);
118  d->setBodyData(body);
119 }
120 
121 void Response::setJsonBody(const QJsonDocument &documment)
122 {
123  Q_D(Response);
124  const QByteArray body = documment.toJson(QJsonDocument::Compact);
125  d->setBodyData(body);
126  d->headers.setContentType(QStringLiteral("application/json"));
127 }
128 
129 void Response::setJsonBody(const QString &json)
130 {
131  Q_D(Response);
132  d->setBodyData(json.toUtf8());
133  d->headers.setContentType(QStringLiteral("application/json"));
134 }
135 
136 void Response::setJsonBody(const QByteArray &json)
137 {
138  Q_D(Response);
139  d->setBodyData(json);
140  d->headers.setContentType(QStringLiteral("application/json"));
141 }
142 
143 void Response::setJsonObjectBody(const QJsonObject &object)
144 {
145  Q_D(Response);
146  const QByteArray body = QJsonDocument(object).toJson(QJsonDocument::Compact);
147  d->setBodyData(body);
148  d->headers.setContentType(QStringLiteral("application/json"));
149 }
150 
151 void Response::setJsonArrayBody(const QJsonArray &array)
152 {
153  Q_D(Response);
154  const QByteArray body = QJsonDocument(array).toJson(QJsonDocument::Compact);
155  d->setBodyData(body);
156  d->headers.setContentType(QStringLiteral("application/json"));
157 }
158 
160 {
161  Q_D(const Response);
162  return d->headers.contentEncoding();
163 }
164 
165 void Cutelyst::Response::setContentEncoding(const QString &encoding)
166 {
167  Q_D(Response);
168  Q_ASSERT_X(!(d->engineRequest->status & EngineRequest::FinalizedHeaders),
169  "setContentEncoding",
170  "setting a header value after finalize_headers and the response callback has been called. Not what you want.");
171 
172  d->headers.setContentEncoding(encoding);
173 }
174 
176 {
177  Q_D(const Response);
178  return d->headers.contentLength();
179 }
180 
181 void Response::setContentLength(qint64 length)
182 {
183  Q_D(Response);
184  Q_ASSERT_X(!(d->engineRequest->status & EngineRequest::FinalizedHeaders),
185  "setContentLength",
186  "setting a header value after finalize_headers and the response callback has been called. Not what you want.");
187 
188  d->headers.setContentLength(length);
189 }
190 
191 QString Response::contentType() const
192 {
193  Q_D(const Response);
194  return d->headers.contentType();
195 }
196 
198 {
199  Q_D(const Response);
200  return d->headers.contentTypeCharset();
201 }
202 
203 QVariant Response::cookie(const QByteArray &name) const
204 {
205  Q_D(const Response);
206  return QVariant::fromValue(d->cookies.value(name));
207 }
208 
209 QList<QNetworkCookie> Response::cookies() const
210 {
211  Q_D(const Response);
212  return d->cookies.values();
213 }
214 
215 void Response::setCookie(const QNetworkCookie &cookie)
216 {
217  Q_D(Response);
218  d->cookies.insert(cookie.name(), cookie);
219 }
220 
221 void Response::setCookies(const QList<QNetworkCookie> &cookies)
222 {
223  Q_D(Response);
224  for (const QNetworkCookie &cookie : cookies) {
225  d->cookies.insert(cookie.name(), cookie);
226  }
227 }
228 
229 int Response::removeCookies(const QByteArray &name)
230 {
231  Q_D(Response);
232  return d->cookies.remove(name);
233 }
234 
235 void Response::redirect(const QUrl &url, quint16 status)
236 {
237  Q_D(Response);
238  d->location = url;
239  d->status = status;
240 
241  if (url.isValid()) {
242  const auto location = QString::fromLatin1(url.toEncoded(QUrl::FullyEncoded));
243  qCDebug(CUTELYST_RESPONSE) << "Redirecting to" << location << status;
244 
245  d->headers.setHeader(QStringLiteral("LOCATION"), location);
246  d->headers.setContentType(QStringLiteral("text/html; charset=utf-8"));
247 
248  const QString buf = QLatin1String(R"V0G0N(<!DOCTYPE html>
249 <html xmlns="http://www.w3.org/1999/xhtml">
250  <head>
251  <title>Moved</title>
252  </head>
253  <body>
254  <p>This item has moved <a href=")V0G0N") + location + QLatin1String(R"V0G0N(">here</a>.</p>
255  </body>
256 </html>
257 )V0G0N");
258  setBody(buf.toLatin1());
259  } else {
260  d->headers.removeHeader(QStringLiteral("LOCATION"));
261  qCDebug(CUTELYST_ENGINE) << "Invalid redirect removing header" << url << status;
262  }
263 }
264 
265 void Response::redirect(const QString &url, quint16 status)
266 {
267  redirect(QUrl(url), status);
268 }
269 
270 void Response::redirectSafe(const QUrl &url, const QUrl &fallback)
271 {
272  Q_D(const Response);
273  if (url.matches(d->engineRequest->context->req()->uri(), QUrl::RemovePath | QUrl::RemoveQuery)) {
274  redirect(url);
275  } else {
276  redirect(fallback);
277  }
278 }
279 
280 QUrl Response::location() const noexcept
281 {
282  Q_D(const Response);
283  return d->location;
284 }
285 
286 QString Response::header(const QString &field) const
287 {
288  Q_D(const Response);
289  return d->headers.header(field);
290 }
291 
292 void Response::setHeader(const QString &field, const QString &value)
293 {
294  Q_D(Response);
295  Q_ASSERT_X(!(d->engineRequest->status & EngineRequest::FinalizedHeaders),
296  "setHeader",
297  "setting a header value after finalize_headers and the response callback has been called. Not what you want.");
298 
299  d->headers.setHeader(field, value);
300 }
301 
302 Headers &Response::headers() noexcept
303 {
304  Q_D(Response);
305  return d->headers;
306 }
307 
308 bool Response::isFinalizedHeaders() const noexcept
309 {
310  Q_D(const Response);
311  return d->engineRequest->status & EngineRequest::FinalizedHeaders;
312 }
313 
314 bool Response::isSequential() const noexcept
315 {
316  return true;
317 }
318 
319 qint64 Response::size() const noexcept
320 {
321  Q_D(const Response);
322  if (d->engineRequest->status & EngineRequest::IOWrite) {
323  return -1;
324  } else if (d->bodyIODevice) {
325  return d->bodyIODevice->size();
326  } else {
327  return d->bodyData.size();
328  }
329 }
330 
331 bool Response::webSocketHandshake(const QString &key, const QString &origin, const QString &protocol)
332 {
333  Q_D(Response);
334  return d->engineRequest->webSocketHandshake(key, origin, protocol);
335 }
336 
337 bool Response::webSocketTextMessage(const QString &message)
338 {
339  Q_D(Response);
340  return d->engineRequest->webSocketSendTextMessage(message);
341 }
342 
343 bool Response::webSocketBinaryMessage(const QByteArray &message)
344 {
345  Q_D(Response);
346  return d->engineRequest->webSocketSendBinaryMessage(message);
347 }
348 
349 bool Response::webSocketPing(const QByteArray &payload)
350 {
351  Q_D(Response);
352  return d->engineRequest->webSocketSendPing(payload);
353 }
354 
355 bool Response::webSocketClose(quint16 code, const QString &reason)
356 {
357  Q_D(Response);
358  return d->engineRequest->webSocketClose(code, reason);
359 }
360 
361 void ResponsePrivate::setBodyData(const QByteArray &body)
362 {
363  if (!(engineRequest->status & EngineRequest::IOWrite)) {
364  if (bodyIODevice) {
365  delete bodyIODevice;
366  bodyIODevice = nullptr;
367  }
368  bodyData = body;
369  headers.setContentLength(body.size());
370  }
371 }
372 
373 #include "moc_response.cpp"
void redirect(const QUrl &url, quint16 status=Found)
Definition: response.cpp:235
QVariant cookie(const QByteArray &name) const
Definition: response.cpp:203
qint64 contentLength() const
Definition: response.cpp:175
bool hasBody() const noexcept
Definition: response.cpp:78
QString header(const QString &field) const
bool webSocketTextMessage(const QString &message)
Sends a WebSocket text message.
void setStatus(quint16 status) noexcept
Definition: response.cpp:72
bool webSocketPing(const QByteArray &payload={})
Sends a WebSocket ping with an optional payload limited to 125 bytes, which will be truncated if larg...
Response(const Headers &defaultHeaders, EngineRequest *conn=nullptr)
Definition: response.cpp:19
Headers & headers() noexcept
void setBody(QIODevice *body)
Definition: response.cpp:101
QIODevice * bodyDevice() const
Definition: response.cpp:95
QString contentEncoding() const
Definition: response.cpp:159
void setJsonArrayBody(const QJsonArray &array)
Definition: response.cpp:151
void redirectSafe(const QUrl &url, const QUrl &fallback)
void setCookies(const QList< QNetworkCookie > &cookies)
Definition: response.cpp:221
virtual qint64 writeData(const char *data, qint64 len) override
Definition: response.cpp:32
QList< QNetworkCookie > cookies() const
Definition: response.cpp:209
bool webSocketBinaryMessage(const QByteArray &message)
Sends a WebSocket binary message.
bool isFinalizedHeaders() const noexcept
bool webSocketHandshake(const QString &key={}, const QString &origin={}, const QString &protocol={})
Sends the websocket handshake, if no parameters are defined it will use header data.
QString contentType() const
Definition: response.cpp:191
QString contentTypeCharset() const
Definition: response.cpp:197
void setContentLength(qint64 length)
Definition: response.cpp:181
int removeCookies(const QByteArray &name)
Definition: response.cpp:229
void setContentEncoding(const QString &encoding)
Definition: response.cpp:165
void setJsonObjectBody(const QJsonObject &object)
Definition: response.cpp:143
void setHeader(const QString &field, const QString &value)
virtual qint64 readData(char *data, qint64 maxlen) override
Definition: response.cpp:25
virtual qint64 size() const noexcept override
void setJsonBody(const QJsonDocument &documment)
Definition: response.cpp:121
Q_REQUIRED_RESULT QByteArray & body()
Definition: response.cpp:84
bool webSocketClose(quint16 code=Response::CloseCodeNormal, const QString &reason={})
Sends a WebSocket close frame, with both optional close code and a string reason.
quint16 status() const noexcept
Definition: response.cpp:66
void setCookie(const QNetworkCookie &cookie)
Definition: response.cpp:215
QUrl location() const noexcept
virtual bool isSequential() const noexcept override
The Cutelyst namespace holds all public Cutelyst API.
Definition: Mainpage.dox:8