blob: ddbab433ccd0db45a5896f928617b2a78d693462 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
/****************************************************************************
**
** Copyright (C) 2017 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the QtWebEngine module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:GPL-EXCEPT$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3 as published by the Free Software
** Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT
** included in the packaging of this file. Please review the following
** information to ensure the GNU General Public License requirements will
** be met: https://www.gnu.org/licenses/gpl-3.0.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/
#ifndef HTTPSERVER_H
#define HTTPSERVER_H
#include "httpreqrep.h"
#include <QTcpServer>
#include <QUrl>
// Listens on a TCP socket and creates HttpReqReps for each connection.
//
// Usage:
//
// HttpServer server;
// connect(&server, &HttpServer::newRequest, [](HttpReqRep *rr) {
// if (rr->requestPath() == "/myPage.html") {
// rr->setResponseBody("<html><body>Hello, World!</body></html>");
// rr->sendResponse();
// }
// });
// QVERIFY(server.start());
// /* do stuff */
// QVERIFY(server.stop());
//
// HttpServer owns the HttpReqRep objects. The signal handler should not store
// references to HttpReqRep objects.
//
// Only if a handler calls sendResponse() will a response be actually sent. This
// means that multiple handlers can be connected to the signal, with different
// handlers responsible for different paths.
class HttpServer : public QObject
{
Q_OBJECT
public:
explicit HttpServer(QObject *parent = nullptr);
// Must be called to start listening.
//
// Returns true if a TCP port has been successfully bound.
Q_REQUIRED_RESULT bool start();
// Stops listening and performs final error checks.
Q_REQUIRED_RESULT bool stop();
// Full URL for given relative path
QUrl url(const QString &path = QStringLiteral("/")) const;
Q_SIGNALS:
// Emitted after a HTTP request has been successfully parsed.
void newRequest(HttpReqRep *reqRep);
private Q_SLOTS:
void handleNewConnection();
private:
QTcpServer m_tcpServer;
QUrl m_url;
bool m_error = false;
};
#endif // !HTTPSERVER_H
|
