mirror of
https://github.com/esp8266/Arduino.git
synced 2025-04-19 23:22:16 +03:00
a924ba1336
GET params are always added plain POST is added to the GET arguments Uploads are handled by separate handler
107 lines
3.4 KiB
C++
107 lines
3.4 KiB
C++
/*
|
|
ESP8266WebServer.h - Dead simple web-server.
|
|
Supports only one simultaneous client, knows how to handle GET and POST.
|
|
|
|
Copyright (c) 2014 Ivan Grokhotkov. All rights reserved.
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Lesser General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2.1 of the License, or (at your option) any later version.
|
|
|
|
This library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with this library; if not, write to the Free Software
|
|
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
Modified 8 May 2015 by Hristo Gochkov (proper post and file upload handling)
|
|
*/
|
|
|
|
|
|
#ifndef ESP8266WEBSERVER_H
|
|
#define ESP8266WEBSERVER_H
|
|
|
|
#include <functional>
|
|
|
|
enum HTTPMethod { HTTP_ANY, HTTP_GET, HTTP_POST, HTTP_PUT, HTTP_PATCH, HTTP_DELETE };
|
|
enum HTTPUploadStatus { UPLOAD_FILE_START, UPLOAD_FILE_WRITE, UPLOAD_FILE_END };
|
|
|
|
typedef struct {
|
|
HTTPUploadStatus status;
|
|
String filename;
|
|
String name;
|
|
String type;
|
|
size_t size;
|
|
size_t buflen;
|
|
uint8_t buf[1460];
|
|
} HTTPUpload;
|
|
|
|
class ESP8266WebServer
|
|
{
|
|
public:
|
|
|
|
ESP8266WebServer(int port = 80);
|
|
~ESP8266WebServer();
|
|
|
|
void begin();
|
|
void handleClient();
|
|
|
|
typedef std::function<void(void)> THandlerFunction;
|
|
void on(const char* uri, THandlerFunction handler);
|
|
void on(const char* uri, HTTPMethod method, THandlerFunction fn);
|
|
void onNotFound(THandlerFunction fn); //called when handler is not assigned
|
|
void onFileUpload(THandlerFunction fn); //handle file uploads
|
|
|
|
String uri() { return _currentUri; }
|
|
HTTPMethod method() { return _currentMethod; }
|
|
WiFiClient client() { return _currentClient; }
|
|
HTTPUpload upload() { return _currentUpload; }
|
|
|
|
String arg(const char* name); // get request argument value by name
|
|
String arg(int i); // get request argument value by number
|
|
String argName(int i); // get request argument name by number
|
|
int args(); // get arguments count
|
|
bool hasArg(const char* name); // check if argument exists
|
|
|
|
// send response to the client
|
|
// code - HTTP response code, can be 200 or 404
|
|
// content_type - HTTP content type, like "text/plain" or "image/png"
|
|
// content - actual content body
|
|
void send(int code, const char* content_type = NULL, String content = String(""));
|
|
|
|
protected:
|
|
void _handleRequest(WiFiClient& client, String uri, HTTPMethod method);
|
|
void _parseArguments(String data);
|
|
static const char* _responseCodeToString(int code);
|
|
static void _appendHeader(String& response, const char* name, const char* value);
|
|
void _parseForm(WiFiClient& client, String boundary, uint32_t len);
|
|
|
|
struct RequestHandler;
|
|
struct RequestArgument {
|
|
String key;
|
|
String value;
|
|
};
|
|
|
|
WiFiServer _server;
|
|
|
|
WiFiClient _currentClient;
|
|
HTTPMethod _currentMethod;
|
|
String _currentUri;
|
|
|
|
size_t _currentArgCount;
|
|
RequestArgument* _currentArgs;
|
|
HTTPUpload _currentUpload;
|
|
|
|
RequestHandler* _firstHandler;
|
|
RequestHandler* _lastHandler;
|
|
THandlerFunction _notFoundHandler;
|
|
THandlerFunction _fileUploadHandler;
|
|
|
|
};
|
|
|
|
|
|
#endif //ESP8266WEBSERVER_H
|