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()
    {
    }

    virtual void shutdown(HttpServerConnection& connection)
    {
    }

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);
};