HttpResource.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.
 *
 * HttpResource.h
 *
 * @author: 2017 - Slavey Karadzhov <slav@attachix.com>
 *
 ****/
 
#pragma once
 
#include <WString.h>
#include <Data/ObjectMap.h>
 
#include "Resource/HttpResourcePlugin.h"
 
class HttpServerConnection;
 
using HttpServerConnectionBodyDelegate =
    Delegate<int(HttpServerConnection& connection, HttpRequest&, const char* at, int length)>;
using HttpServerConnectionUpgradeDelegate =
    Delegate<int(HttpServerConnection& connection, HttpRequest&, char* at, int length)>;
using HttpResourceDelegate =
    Delegate<int(HttpServerConnection& connection, HttpRequest& request, HttpResponse& response)>;
 
class HttpResource
{
public:
    virtual ~HttpResource() = default;
 
    virtual void shutdown(HttpServerConnection&)
    {
    }
 
public:
    class PluginRef : public LinkedObjectTemplate<PluginRef>
    {
    public:
        using OwnedList = OwnedLinkedObjectListTemplate<PluginRef>;
 
        PluginRef(HttpResourcePlugin* plugin) : plugin(plugin)
        {
        }
 
        HttpResourcePlugin* operator->() const
        {
            return plugin;
        }
 
    private:
        HttpResourcePlugin* plugin;
    };
 
    HttpResourceDelegate onUrlComplete = nullptr;            
    HttpServerConnectionBodyDelegate onBody = nullptr;       
    HttpResourceDelegate onHeadersComplete = nullptr;        
    HttpResourceDelegate onRequestComplete = nullptr;        
    HttpServerConnectionUpgradeDelegate onUpgrade = nullptr; 
 
    void addPlugin(HttpResourcePlugin* plugin);
 
    template <class... Tail> void addPlugin(HttpResourcePlugin* plugin, Tail... plugins)
    {
        addPlugin(plugin);
        addPlugin(plugins...);
    }
 
private:
    friend class HttpServerConnection;
 
    PluginRef::OwnedList plugins;
 
    int handleUrl(HttpServerConnection& connection, HttpRequest& request, HttpResponse& response);
    int handleHeaders(HttpServerConnection& connection, HttpRequest& request, HttpResponse& response);
    int handleUpgrade(HttpServerConnection& connection, HttpRequest& request, char* data, size_t length);
    int handleBody(HttpServerConnection& connection, HttpRequest& request, char*& data, size_t& length);
    int handleRequest(HttpServerConnection& connection, HttpRequest& request, HttpResponse& response);
};