/usr/include/QHttpEngine/qhttpparser.h is in libqhttpengine-dev 0.1.0+dfsg1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 88 89 90 91 92 93 | /*
* Copyright (c) 2015 Nathan Osman
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to
* deal in the Software without restriction, including without limitation the
* rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
* sell copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
* IN THE SOFTWARE.
*/
#ifndef QHTTPENGINE_QHTTPPARSER_H
#define QHTTPENGINE_QHTTPPARSER_H
#include <QList>
#include <QMap>
#include "qhttpengine.h"
#include "qibytearray.h"
/**
* @brief Map consisting of HTTP headers
*
* The key used for the map is the QIByteArray class, which allows for
* case-insensitive comparison.
*/
typedef QMap<QIByteArray, QByteArray> QHttpHeaderMap;
/**
* @brief Utility methods for parsing HTTP requests and responses
* @headerfile qhttpparser.h QHttpEngine/QHttpParser
*
* This class provides a set of static methods for parsing HTTP request and
* response headers. Functionality is broken up into smaller methods in order
* to make the unit tests simpler.
*/
class QHTTPENGINE_EXPORT QHttpParser
{
public:
/**
* @brief Split a QByteArray by the provided delimiter
*
* If the delimiter is not present in the QByteArray, the resulting list
* will contain the original QByteArray as its only element. The delimiter
* must not be empty.
*
* If maxSplit is nonzero, the list will contain no more than maxSplit + 1
* items. If maxSplit is equal to zero, there will be no limit on the
* number of splits performed.
*/
static void split(const QByteArray &data, const QByteArray &delim, int maxSplit, QList<QByteArray> &parts);
/**
* @brief Parse a list of lines containing HTTP headers
*
* Each line is expected to be in the format "name: value". Parsing is
* immediately aborted if an invalid line is encountered.
*/
static bool parseHeaderList(const QList<QByteArray> &lines, QHttpHeaderMap &headers);
/**
* @brief Parse HTTP headers
*
* The specified header data (everything up to the double CRLF) is parsed
* into a status line and HTTP headers. The parts list will contain the
* parts from the status line.
*/
static bool parseHeaders(const QByteArray &data, QList<QByteArray> &parts, QHttpHeaderMap &headers);
/**
* @brief Parse HTTP request headers
*/
static bool parseRequestHeaders(const QByteArray &data, QByteArray &method, QByteArray &path, QHttpHeaderMap &headers);
/**
* @brief Parse HTTP response headers
*/
static bool parseResponseHeaders(const QByteArray &data, int &statusCode, QByteArray &statusReason, QHttpHeaderMap &headers);
};
#endif // QHTTPENGINE_QHTTPPARSER_H
|