You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
139 lines
3.3 KiB
139 lines
3.3 KiB
/*
|
|
|
|
Part of the API MODULE
|
|
|
|
Copyright (C) 2020 by Maxim Prokhorov <prokhorov dot max at outlook dot com>
|
|
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <Arduino.h>
|
|
|
|
#include <ESPAsyncWebServer.h>
|
|
|
|
#include <algorithm>
|
|
#include <memory>
|
|
#include <vector>
|
|
|
|
#include "api_path.h"
|
|
|
|
// this is a purely temporary object, which we can only create while doing the API dispatch
|
|
|
|
struct ApiRequest {
|
|
ApiRequest() = delete;
|
|
|
|
ApiRequest(const ApiRequest&) = default;
|
|
ApiRequest(ApiRequest&&) noexcept = default;
|
|
|
|
explicit ApiRequest(AsyncWebServerRequest& request, const PathParts& pattern, const PathParts& parts) :
|
|
_request(request),
|
|
_pattern(pattern),
|
|
_parts(parts)
|
|
{}
|
|
|
|
template <typename T>
|
|
void handle(T&& handler) {
|
|
if (_done) return;
|
|
_done = true;
|
|
handler(&_request);
|
|
}
|
|
|
|
template <typename T>
|
|
void param_foreach(T&& handler) {
|
|
const size_t params { _request.params() };
|
|
for (size_t current = 0; current < params; ++current) {
|
|
auto* param = _request.getParam(current);
|
|
handler(param->name(), param->value());
|
|
}
|
|
}
|
|
|
|
template <typename T>
|
|
void param_foreach(const String& name, T&& handler) {
|
|
param_foreach([&](const String& param_name, const String& param_value) {
|
|
if (param_name == name) {
|
|
handler(param_value);
|
|
}
|
|
});
|
|
}
|
|
|
|
const String& param(const String& name) {
|
|
auto* result = _request.getParam(name, HTTP_PUT == _request.method());
|
|
if (result) {
|
|
return result->value();
|
|
}
|
|
|
|
return _empty_string();
|
|
}
|
|
|
|
void send(const String& payload) {
|
|
if (_done) return;
|
|
_done = true;
|
|
|
|
if (payload.length()) {
|
|
_request.send(200, "text/plain", payload);
|
|
} else {
|
|
_request.send(204);
|
|
}
|
|
}
|
|
|
|
bool done() const {
|
|
return _done;
|
|
}
|
|
|
|
const PathParts& parts() const {
|
|
return _parts;
|
|
}
|
|
|
|
String part(size_t index) const {
|
|
return _parts[index];
|
|
}
|
|
|
|
// Only works when pattern cointains '+', retrieving the part at the same index from the real path
|
|
// e.g. for the pair of `some/+/path` and `some/data/path`, calling `wildcard(0)` will return `data`
|
|
String wildcard(int index) const;
|
|
size_t wildcards() const;
|
|
|
|
private:
|
|
const String& _empty_string() const {
|
|
static const String string;
|
|
return string;
|
|
}
|
|
|
|
bool _done { false };
|
|
|
|
AsyncWebServerRequest& _request;
|
|
const PathParts& _pattern;
|
|
const PathParts& _parts;
|
|
};
|
|
|
|
struct ApiRequestHelper {
|
|
ApiRequestHelper(const ApiRequestHelper&) = delete;
|
|
ApiRequestHelper(ApiRequestHelper&&) noexcept = default;
|
|
|
|
// &path is expected to be request->url(), which is valid throughout the request's lifetime
|
|
explicit ApiRequestHelper(AsyncWebServerRequest& request, const PathParts& pattern) :
|
|
_request(request),
|
|
_pattern(pattern),
|
|
_path(request.url()),
|
|
_match(_pattern.match(_path))
|
|
{}
|
|
|
|
ApiRequest request() const {
|
|
return ApiRequest(_request, _pattern, _path);
|
|
}
|
|
|
|
const PathParts& parts() const {
|
|
return _path;
|
|
}
|
|
|
|
bool match() const {
|
|
return _match;
|
|
}
|
|
|
|
private:
|
|
AsyncWebServerRequest& _request;
|
|
const PathParts& _pattern;
|
|
PathParts _path;
|
|
bool _match;
|
|
};
|