feedc0de/ESPAsyncWebServer
1
0
Fork 0
forked from me-no-dev/ESPAsyncWebServer
Code Pull Requests Activity

readme add more Json stuff

Browse Source
This commit is contained in:
Me No Dev
2016-02-01 03:30:11 +02:00
parent f8deeee5bc
commit 09a3b9d3e8
1 changed files with 27 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
README.md
View File

@@ -153,7 +153,7 @@ void handleBody(AsyncWebServerRequest *request, uint8_t *data, size_t len, size_
} }
``` ```
## Basic Responses ## Responses
### Basic response with HTTP Code ### Basic response with HTTP Code
```cpp ```cpp
@@ -246,8 +246,6 @@ response->addHeader("Server","ESP Async Web Server");
request->send(response); request->send(response);
``` ```
## Advanced Responses
### Chunked Response ### Chunked Response
Used when content length is unknown. Works best if the client supports HTTP/1.1 Used when content length is unknown. Works best if the client supports HTTP/1.1
```cpp ```cpp
@@ -257,12 +255,14 @@ AsyncWebServerResponse *response = request->beginChunkedResponse("text/plain", [
//Keep in mind that you can not delay or yield waiting for more data! //Keep in mind that you can not delay or yield waiting for more data!
return mySource.read(buffer, maxLen); return mySource.read(buffer, maxLen);
}); });
response->addHeader("Server","ESP Async Web Server");
request->send(response); request->send(response);
``` ```
### Print to response ### Print to response
```cpp ```cpp
AsyncResponseStream *response = request->beginResponseStream("text/html"); AsyncResponseStream *response = request->beginResponseStream("text/html");
response->addHeader("Server","ESP Async Web Server");
response->printf("<!DOCTYPE html><html><head><title>Webpage at %s</title></head><body>", request->url().c_str()); response->printf("<!DOCTYPE html><html><head><title>Webpage at %s</title></head><body>", request->url().c_str());
response->print("<h2>Hello "); response->print("<h2>Hello ");
@@ -271,7 +271,7 @@ response->print("</h2>");
response->print("<h3>General</h3>"); response->print("<h3>General</h3>");
response->print("<ul>"); response->print("<ul>");
response->printf("<li>Version: %s</li>", request->version()?"HTTP/1.0":"HTTP/1.1"); response->printf("<li>Version: HTTP/1.%u</li>", request->version());
response->printf("<li>Method: %s</li>", request->methodToString()); response->printf("<li>Method: %s</li>", request->methodToString());
response->printf("<li>URL: %s</li>", request->url().c_str()); response->printf("<li>URL: %s</li>", request->url().c_str());
response->printf("<li>Host: %s</li>", request->host().c_str()); response->printf("<li>Host: %s</li>", request->host().c_str());
@@ -309,17 +309,38 @@ response->print("</body></html>");
request->send(response); request->send(response);
``` ```
### ArduinoJson Response ### ArduinoJson Basic Response
This way of sending Json is great for when the result is below 4KB
```cpp
#include "AsyncJson.h"
#include "ArduinoJson.h"
AsyncResponseStream *response = request->beginResponseStream("text/json");
DynamicJsonBuffer jsonBuffer;
JsonObject &root = jsonBuffer.createObject();
root["heap"] = ESP.getFreeHeap();
root["ssid"] = WiFi.SSID();
root.printTo(*response);
request->send(response);
```
### ArduinoJson Advanced Response
This response can handle really large Json objects (tested to 40KB)
There isn't any noticeable speed decrease for small results with the method above
Since ArduinoJson does not allow reading parts of the string, the whole Json has to
be passed every time a chunks needs to be sent, which shows speed decrease proportional
to the resulting json packets
```cpp ```cpp
#include "AsyncJson.h" #include "AsyncJson.h"
#include "ArduinoJson.h" #include "ArduinoJson.h"
AsyncJsonResponse * response = new AsyncJsonResponse(); AsyncJsonResponse * response = new AsyncJsonResponse();
response->addHeader("Server","ESP Async Web Server");
JsonObject& root = response->getRoot(); JsonObject& root = response->getRoot();
root["heap"] = ESP.getFreeHeap(); root["heap"] = ESP.getFreeHeap();
root["ssid"] = WiFi.SSID(); root["ssid"] = WiFi.SSID();
response->setLength(); response->setLength();
request->send(response); request->send(response);
``` ```