HttpServer.h

Go to the documentation of this file.

#pragma once
 
#include <WiFi.h>
#include <stdlib.h>
 
#include "Client.h"
#include "HardwareSerial.h"
#include "HttpChunkWriter.h"
#include "HttpHeader.h"
#include "HttpRequestHandlerLine.h"
#include "HttpRequestRewrite.h"
#include "HttpTunnel.h"
#include "Server.h"
#include "basic/List.h"
 
namespace tiny_dlna {
 
class HttpServer {
 public:
  HttpServer(WiFiServer& server, int bufferSize = 1024) {
    DlnaLogger.log(DlnaInfo, "HttpServer");
    this->server_ptr = &server;
    this->buffer.resize(bufferSize);
  }
 
  ~HttpServer() {
    DlnaLogger.log(DlnaInfo, "~HttpServer");
    handler_collection.clear();
    request_header.clear(false);
    reply_header.clear(false);
    rewrite_collection.clear();
  }
 
  IPAddress& localIP() {
    static IPAddress address;
    address = WiFi.localIP();
    return address;
  }
 
  bool begin(int port, const char* ssid, const char* password) {
    if (WiFi.status() != WL_CONNECTED && ssid != nullptr &&
        password != nullptr) {
      WiFi.begin(ssid, password);
      while (WiFi.status() != WL_CONNECTED) {
        delay(500);
        Serial.print(".");
      }
 
      Serial.println();
      Serial.print("Started Server at ");
      Serial.print(WiFi.localIP());
      Serial.print(":");
      Serial.println(port);
    }
    return begin(port);
  }
 
  bool begin(int port) {
    DlnaLogger.log(DlnaInfo, "HttpServer begin at port %d", port);
    is_active = true;
    server_ptr->begin(port);
    return true;
  }
 
  void end() {
    DlnaLogger.log(DlnaInfo, "HttpServer %s", "stop");
    is_active = false;
  }
 
  void rewrite(const char* from, const char* to) {
    DlnaLogger.log(DlnaInfo, "Rewriting %s to %s", from, to);
    HttpRequestRewrite* line = new HttpRequestRewrite(from, to);
    rewrite_collection.push_back(line);
  }
 
  void on(const char* url, TinyMethodID method, web_callback_fn fn,
          void* ctx[] = nullptr, int ctxCount = 0) {
    DlnaLogger.log(DlnaInfo, "Serving at %s", url);
    HttpRequestHandlerLine* hl = new HttpRequestHandlerLine(ctxCount);
    hl->path = url;
    hl->fn = fn;
    hl->method = method;
    // hl->context = ctx;
    memmove(hl->context, ctx, ctxCount * sizeof(void*));
    hl->contextCount = ctxCount;
    addHandler(hl);
  }
 
  void on(const char* url, TinyMethodID method, const char* mime,
          web_callback_fn fn) {
    DlnaLogger.log(DlnaInfo, "Serving at %s", url);
    HttpRequestHandlerLine* hl = new HttpRequestHandlerLine();
    hl->path = url;
    hl->fn = fn;
    hl->method = method;
    hl->mime = mime;
    addHandler(hl);
  }
 
  void on(const char* url, TinyMethodID method, const char* mime,
          const char* result) {
    DlnaLogger.log(DlnaInfo, "Serving at %s", url);
 
    auto lambda = [](HttpServer* server_ptr, const char* requestPath,
                     HttpRequestHandlerLine* hl) {
      DlnaLogger.log(DlnaInfo, "on-strings %s", "lambda");
      if (hl->contextCount < 2) {
        DlnaLogger.log(DlnaError, "The context is not available");
        return;
      }
      const char* mime = (const char*)hl->context[0];
      const char* msg = (const char*)hl->context[1];
      server_ptr->reply(mime, msg, 200);
    };
    HttpRequestHandlerLine* hl = new HttpRequestHandlerLine(2);
    hl->context[0] = (void*)mime;
    hl->context[1] = (void*)result;
    hl->path = url;
    hl->fn = lambda;
    hl->method = method;
    addHandler(hl);
  }
 
  void on(const char* url, TinyMethodID method, const char* mime,
          const uint8_t* data, int len) {
    DlnaLogger.log(DlnaInfo, "Serving at %s", url);
 
    auto lambda = [](HttpServer* server_ptr, const char* requestPath,
                     HttpRequestHandlerLine* hl) {
      DlnaLogger.log(DlnaInfo, "on-strings %s", "lambda");
      if (hl->contextCount < 3) {
        DlnaLogger.log(DlnaError, "The context is not available");
        return;
      }
      const char* mime = static_cast<char*>(hl->context[0]);
      const uint8_t* data = static_cast<uint8_t*>(hl->context[1]);
      int* p_len = (int*)hl->context[2];
      int len = *p_len;
      DlnaLogger.log(DlnaDebug, "Mime %d - Len: %d", mime, len);
      server_ptr->reply(mime, data, len, 200);
    };
    HttpRequestHandlerLine* hl = new HttpRequestHandlerLine(3);
    hl->context[0] = (void*)mime;
    hl->context[1] = (void*)data;
    hl->context[2] = new int(len);
    hl->path = url;
    hl->fn = lambda;
    hl->method = method;
    addHandler(hl);
  }
 
  void on(const char* url, TinyMethodID method, Url& redirect) {
    DlnaLogger.log(DlnaInfo, "Serving at %s", url);
    auto lambda = [](HttpServer* server_ptr, const char* requestPath,
                     HttpRequestHandlerLine* hl) {
      if (hl->contextCount < 1) {
        DlnaLogger.log(DlnaError, "The context is not available");
        return;
      }
      DlnaLogger.log(DlnaInfo, "on-redirect %s", "lambda");
      HttpReplyHeader reply_header;
      Url* url = static_cast<Url*>(hl->context[0]);
      reply_header.setValues(301, "Moved");
      reply_header.put(LOCATION, url->url());
      reply_header.put("X-Forwarded-Host", (const char*)hl->context[1]);
      reply_header.write(server_ptr->client());
      server_ptr->endClient();
    };
 
    HttpRequestHandlerLine* hl = new HttpRequestHandlerLine(2);
    const char* lh = localHost();
    hl->context[0] = new Url(redirect);
    hl->context[1] = (void*)lh;
    hl->path = url;
    hl->fn = lambda;
    hl->method = method;
    addHandler(hl);
  }
 
  void on(const char* url, TinyMethodID method, HttpTunnel& tunnel) {
    DlnaLogger.log(DlnaInfo, "Serving at %s", url);
 
    auto lambda = [](HttpServer* server_ptr, const char* requestPath,
                     HttpRequestHandlerLine* hl) {
      DlnaLogger.log(DlnaInfo, "on-HttpTunnel %s", "lambda");
      HttpTunnel* p_tunnel = static_cast<HttpTunnel*>(hl->context[0]);
      if (p_tunnel == nullptr) {
        DlnaLogger.log(DlnaError, "p_tunnel is null");
        server_ptr->replyNotFound();
        return;
      }
      const char* mime = hl->mime;
      // execute T_GET request
      Stream* p_in = p_tunnel->get();
      if (p_in == nullptr) {
        DlnaLogger.log(DlnaError, "p_in is null");
        server_ptr->replyNotFound();
        return;
      }
      const char* content_len = p_tunnel->request().reply().get(CONTENT_LENGTH);
      StrView content_len_str{content_len};
      // provide result
      server_ptr->reply(mime, *p_in, content_len_str.toInt());
    };
 
    HttpRequestHandlerLine* hl = new HttpRequestHandlerLine(1);
    hl->path = url;
    hl->method = method;
    hl->mime = tunnel.mime();
    hl->context[0] = &tunnel;
    hl->fn = lambda;
    addHandler(hl);
  }
 
  bool onRequest(const char* path) {
    DlnaLogger.log(DlnaInfo, "Serving at %s", path);
 
    bool result = false;
    // check in registered handlers
    StrView pathStr = StrView(path);
    for (auto handler_line_ptr : handler_collection) {
      DlnaLogger.log(DlnaInfo, "onRequest: %s vs: %s %s %s",
                     path,
                     nullstr(handler_line_ptr->path.c_str()),
                     methods[handler_line_ptr->method],
                     nullstr(handler_line_ptr->mime));
 
      if (pathStr.matches(handler_line_ptr->path.c_str()) &&
          request_header.method() == handler_line_ptr->method &&
          matchesMime(handler_line_ptr->mime, request_header.accept())) {
        // call registed handler function
        DlnaLogger.log(DlnaInfo, "onRequest %s", "->found",
                       nullstr(handler_line_ptr->path.c_str()));
        handler_line_ptr->fn(this, path, handler_line_ptr);
        result = true;
        break;
      }
    }
 
    if (!result) {
      DlnaLogger.log(DlnaError, "Request %s not available", path);
    }
 
    return result;
  }
 
  void replyChunked(const char* contentType, Stream& inputStream,
                    int status = 200, const char* msg = SUCCESS) {
    replyChunked(contentType, status, msg);
    HttpChunkWriter chunk_writer;
    while (inputStream.available()) {
      int len = inputStream.readBytes(buffer.data(), buffer.size());
      chunk_writer.writeChunk(*client_ptr, (const char*)buffer.data(), len);
    }
    // final chunk
    chunk_writer.writeEnd(*client_ptr);
    endClient();
  }
 
  void replyChunked(const char* contentType, int status = 200,
                    const char* msg = SUCCESS) {
    DlnaLogger.log(DlnaInfo, "reply %s", "replyChunked");
    reply_header.setValues(status, msg);
    reply_header.put(TRANSFER_ENCODING, CHUNKED);
    reply_header.put(CONTENT_TYPE, contentType);
    reply_header.put(CONNECTION, CON_KEEP_ALIVE);
    reply_header.write(this->client());
  }
 
  void reply(const char* contentType, Stream& inputStream, int size,
             int status = 200, const char* msg = SUCCESS) {
    DlnaLogger.log(DlnaInfo, "reply %s", "stream");
    reply_header.setValues(status, msg);
    reply_header.put(CONTENT_LENGTH, size);
    reply_header.put(CONTENT_TYPE, contentType);
    reply_header.put(CONNECTION, CON_KEEP_ALIVE);
    reply_header.write(this->client());
 
    while (inputStream.available()) {
      int len = inputStream.readBytes(buffer.data(), buffer.size());
      int written = client_ptr->write((const uint8_t*)buffer.data(), len);
    }
    // inputStream.close();
    endClient();
  }
 
  void reply(const char* contentType, void (*callback)(Stream& out),
             int status = 200, const char* msg = SUCCESS) {
    DlnaLogger.log(DlnaInfo, "reply %s", "callback");
    reply_header.setValues(status, msg);
    reply_header.put(CONTENT_TYPE, contentType);
    reply_header.put(CONNECTION, CON_KEEP_ALIVE);
    reply_header.write(this->client());
    callback(*client_ptr);
    // inputStream.close();
    endClient();
  }
 
  void reply(const char* contentType, void (*callback)(Print& out),
             int status = 200, const char* msg = SUCCESS) {
    DlnaLogger.log(DlnaInfo, "reply %s", "callback");
    reply_header.setValues(status, msg);
    reply_header.put(CONTENT_TYPE, contentType);
    reply_header.put(CONNECTION, CON_KEEP_ALIVE);
    reply_header.write(this->client());
    callback(*client_ptr);
    // inputStream.close();
    endClient();
  }
 
  void reply(const char* contentType, const char* str, int status = 200,
             const char* msg = SUCCESS) {
    DlnaLogger.log(DlnaInfo, "reply %s", "str");
    int len = strlen(str);
    reply_header.setValues(status, msg);
    reply_header.put(CONTENT_LENGTH, len);
    reply_header.put(CONTENT_TYPE, contentType);
    reply_header.put(CONNECTION, CON_KEEP_ALIVE);
    reply_header.write(this->client());
    client_ptr->write((const uint8_t*)str, len);
    endClient();
  }
 
  void reply(const char* contentType, const uint8_t* str, int len,
             int status = 200, const char* msg = SUCCESS) {
    DlnaLogger.log(DlnaInfo, "reply %s", "str");
    reply_header.setValues(status, msg);
    reply_header.put(CONTENT_LENGTH, len);
    reply_header.put(CONTENT_TYPE, contentType);
    reply_header.put(CONNECTION, CON_KEEP_ALIVE);
    reply_header.write(this->client());
    client_ptr->write((const uint8_t*)str, len);
    endClient();
  }
 
  void replyOK() { reply(200, SUCCESS); }
 
  void replyNotFound() {
    DlnaLogger.log(DlnaInfo, "reply %s", "404");
    reply(404, "Page Not Found");
  }
 
  void reply(int status, const char* msg) {
    DlnaLogger.log(DlnaInfo, "reply %d", status);
    reply_header.setValues(status, msg);
    reply_header.write(this->client());
    endClient();
  }
 
  HttpRequestHeader& requestHeader() { return request_header; }
 
  HttpReplyHeader& replyHeader() { return reply_header; }
 
  void endClient() {
    DlnaLogger.log(DlnaInfo, "HttpServer %s", "endClient");
    client_ptr->flush();
    client_ptr->stop();
  }
 
  void crlf() {
    client_ptr->print("\r\n");
    client_ptr->flush();
  }
 
  void addHandler(HttpRequestHandlerLine* handlerLinePtr) {
    handler_collection.push_back(handlerLinePtr);
  }
 
  bool doLoop() { return copy(); }
 
  bool copy() {
    bool result = false;
    // get the actual client_ptr
    if (is_active) {
      WiFiClient client = server_ptr->accept();
      if (client) {
        DlnaLogger.log(DlnaInfo, "doLoop->hasClient");
        client_ptr = &client;
 
        // process the new client with standard functionality
        if (client.available() > 5) {
          processRequest();
        }
 
        // process doLoop of all registed (and opened) extension_collection
        // processExtensions();
        result = true;
      } else {
        // give other tasks a chance
        delay(no_connect_delay);
        // DlnaLogger.log(DlnaDebug, "HttpServer no client available");
      }
    } else {
      DlnaLogger.log(DlnaWarning, "HttpServer inactive");
    }
    return result;
  }
 
  Client& client() { return *client_ptr; }
 
  operator bool() { return is_active; }
 
  const char* localHost() {
    if (local_host == nullptr) {
      local_host = toStr(WiFi.localIP());
    }
    return local_host;
  }
 
  void setNoConnectDelay(int delay) { no_connect_delay = delay; }
 
 protected:
  // data
  HttpRequestHeader request_header;
  HttpReplyHeader reply_header;
  List<HttpRequestHandlerLine*> handler_collection;
  // List<Extension*> extension_collection;
  List<HttpRequestRewrite*> rewrite_collection;
  Client* client_ptr;
  WiFiServer* server_ptr;
  bool is_active;
  Vector<char> buffer{0};
  const char* local_host = nullptr;
  int no_connect_delay = 5;
 
  const char* nullstr(const char* in) { return in == nullptr ? "" : in; }
 
  // process a full request and send the reply
  void processRequest() {
    DlnaLogger.log(DlnaInfo, "processRequest");
    request_header.read(this->client());
    // provide reply with empty header
    reply_header.clear();
    // determine the path
    const char* path = request_header.urlPath();
    path = resolveRewrite(path);
    bool processed = onRequest(path);
    if (!processed) {
        replyNotFound();
    }
  }
 
  const char* resolveRewrite(const char* from) {
    for (auto i = rewrite_collection.begin(); i != rewrite_collection.end();
         ++i) {
      HttpRequestRewrite* rewrite = (*i);
      if (rewrite->from.matches(from)) {
        return rewrite->to.c_str();
      }
    }
    return from;
  }
 
  bool matchesMime(const char* handler_mime, const char* request_mime) {
    if (handler_mime == nullptr || request_mime == nullptr) {
      return true;
    }
    bool result = StrView(request_mime).contains(handler_mime);
    return result;
  }
};
 
}  // namespace tiny_dlna