HttpCommon.h

Go to the documentation of this file.

/****
 * Sming Framework Project - Open Source framework for high efficiency native ESP8266 development.
 * Created 2015 by Skurydin Alexey
 * http://github.com/SmingHub/Sming
 * All files of the Sming Core are provided under the LGPL v3 license.
 *
 * HttpCommon.h
 *
 * @author: 2017 - Slavey Karadzhov <slav@attachix.com>
 *
 ****/
 
#pragma once
 
#define ENABLE_HTTP_REQUEST_AUTH 1
 
#include "WString.h"
#include <Data/WebConstants.h>
#include "../Url.h"
#include "Data/Stream/ReadWriteStream.h"
#include "Data/ObjectMap.h"
 
#ifndef HTTP_MAX_HEADER_SIZE
#define HTTP_MAX_HEADER_SIZE (8 * 1024)
#endif
 
/* Number of maximum tcp connections to be kept in the pool */
#ifndef HTTP_REQUEST_POOL_SIZE
#define HTTP_REQUEST_POOL_SIZE 20
#endif
 
#ifdef USE_LEGACY_HTTP_PARSER
 
#include <http-parser/http_parser.h>
 
enum class HttpError {
#define XX(n, s) n,
    HTTP_ERRNO_MAP(XX)
#undef XX
};
 
#define XX(n, s) constexpr HttpError HPE_##n = HttpError::n;
HTTP_ERRNO_MAP(XX)
#undef XX
 
/* Macro defined using C++ type. Internal http_parser code has own definition */
#define HTTP_PARSER_ERRNO(p) HttpError((p)->http_errno)
 
#else
 
#include <llhttp.h>
 
using http_parser_type = llhttp_type;
using http_parser = llhttp_t;
using http_parser_settings = llhttp_settings_t;
using http_method = llhttp_method;
 
inline const char* http_method_str(llhttp_method method)
{
    return llhttp_method_name(method);
}
 
enum class HttpError {
#define XX(num, name, ...) name,
    HTTP_ERRNO_MAP(XX)
#undef XX
};
 
#define XX(num, name, ...) constexpr HttpError HPE_##name = HttpError::name;
HTTP_ERRNO_MAP(XX)
#undef XX
 
/* Macro defined using C++ type. Internal http_parser code has own definition */
#define HTTP_PARSER_ERRNO(p) HttpError((p)->error)
 
#endif
 
enum class HttpMethod {
#define XX(num, name, string) name = num,
    HTTP_METHOD_MAP(XX)
#undef XX
};
 
#define XX(num, name, string) constexpr HttpMethod HTTP_##name = HttpMethod::name;
HTTP_METHOD_MAP(XX)
#undef XX
 
enum class HttpStatus {
#define XX(num, name, string) name = num,
    HTTP_STATUS_MAP(XX)
#undef XX
};
 
#define XX(num, name, string) constexpr HttpStatus HTTP_STATUS_##name = HttpStatus::name;
HTTP_STATUS_MAP(XX)
#undef XX
 
enum HttpConnectionState {
    eHCS_Ready = 0,
    eHCS_StartSending,
    eHCS_SendingHeaders,
    eHCS_StartBody,
    eHCS_SendingBody,
    eHCS_Sent,
    eHCS_WaitResponse
};
 
using HttpFiles = ObjectMap<String, ReadWriteStream>;
 
String toString(HttpError err);
 
String httpGetErrorDescription(HttpError err) SMING_DEPRECATED;
 
String toString(HttpStatus code);
 
inline String httpGetStatusText(unsigned code)
{
    return toString(HttpStatus(code));
}
 
inline String toString(HttpMethod method)
{
    auto fstr = reinterpret_cast<flash_string_t>(http_method_str(http_method(method)));
    return String(fstr);
}