NetBurner 3.5.6
PDF Version
http.h
1/*NB_REVISION*/
2
3/*NB_COPYRIGHT*/
4
21#ifndef _NB_HTTP_H
22#define _NB_HTTP_H
23
24#include <nettypes.h>
25#include <stddef.h>
26#include <config_obj.h>
27
28const int CONFIG_ACCESS_GROUP = 99;
29
43
58
71
72enum WebsocketFlags
73{
74 WS_UPGRADE = 0x1,
75 WS_CONNECT = 0x2,
76 WS_VER_13 = 0x4,
77 WS_KEY_CONFIRM = 0x8
78};
79
87{
88 PSTR pURL;
91 PSTR pData;
92 PSTR pSep;
93 PSTR pHost;
95 PSTR wsKey;
97 uint16_t sep_len;
98 uint32_t content_length;
99 uint32_t rx_length;
103
104 void ProcessLine(PSTR startofline);
105 int Respond(int socket);
106 bool ExtractAuthentication(char **pPassword, char **pUser);
107
108
109
110
134 const char * GetBoundaryMarker();
135
136
171 int ReadSimpleBody(int socket, const char *boundary = NULL);
172
173
174} __attribute__((packed));
175
176
182
183
184struct HTTP_Socket
185{
186 int FileDescriptor;
187 uint32_t StartTime;
188 IPADDR client_IPaddr;
189} __attribute__((packed));
190
191
192enum eWEB_ERROR
193{
194 eTCP_CONN_OPEN_NO_DATA, // WEB client open TCP port#80 conn, but no data request was sent
195 eTCP_CONN_OPEN_TO_LONG, // WEB client open TCP connect and send endless data ( for example - never ending POST).
196};
197
198
220{
221 protected:
223 const char *m_pUrlName;
226
229 void Remove();
230 virtual bool Match(HTTP_Request &req);
231
232 public:
250 HtmlPageHandler(const char *url, HTTP_RequestTypes rt = tGet, int accessGroup = 0, bool Before_Files = false);
251
256
270 static HtmlPageHandler *FindHandler(HTTP_Request &req, bool bBeforeFiles);
271
280
295 virtual int ProcessRaw(int sock, HTTP_Request &pd) = 0;
296
304 inline int GetGroup() { return m_access_group; };
305};
306
316typedef int(http_gethandlerfunc)(int sock, HTTP_Request &pd);
317
318
319typedef bool(http_matchhandlerfunc)(HTTP_Request &pd);
320
326{
327 protected:
329 http_matchhandlerfunc *m_mhf;
330
331 public:
332 inline virtual int ProcessRaw(int sock, HTTP_Request &pdt) { return m_pf(sock, pdt); };
333
346 inline CallBackFunctionPageHandler(const char *pUrl,
347 http_gethandlerfunc *pFunction,
348 HTTP_RequestTypes reqType = tGet,
349 int accessGroup = 0,
350 bool beforeFiles = false)
351 : HtmlPageHandler(pUrl, reqType, accessGroup, beforeFiles), m_pf(pFunction)
352 {
353 m_mhf = 0;
354 };
355
368 inline CallBackFunctionPageHandler(const char *pUrl,
369 http_gethandlerfunc *pFunction,
370 http_matchhandlerfunc *pMatchFunction,
371 HTTP_RequestTypes reqType = tGet,
372 int accessGroup = 0,
373 bool beforeFiles = false)
374 : HtmlPageHandler(pUrl, reqType, accessGroup, beforeFiles), m_pf(pFunction)
375 {
376 m_mhf = pMatchFunction;
377 };
378
379 virtual bool Match(HTTP_Request &req)
380 {
381 if (m_mhf)
382 return m_mhf(req);
383 else
384 return HtmlPageHandler::Match(req);
385 }
386};
387
388
389
390
391class HtmlConfigExposer : public HtmlPageHandler
392{
393protected:
394 config_leaf * pLeaf;
395public:
396 inline HtmlConfigExposer(const char *pUrl, config_leaf & leaf,
397 HTTP_RequestTypes reqType = tGet,
398 int accessGroup = 0,
399 bool beforeFiles = false
400 )
401 : HtmlPageHandler(pUrl, reqType, accessGroup, beforeFiles), pLeaf(&leaf)
402 {
403 }
404
405virtual int ProcessRaw(int sock, HTTP_Request &pd);
406};
407
408
409typedef void (ws_createhandlerfunc)(int web_socket_fd);
410
411class CallBackWSEndPoint : public HtmlPageHandler
412{
413 ws_createhandlerfunc *m_pf;
414public:
415 int ProcessRaw(int sock, HTTP_Request &pdt);
416 inline CallBackWSEndPoint(const char *pUrl,
417 ws_createhandlerfunc *pFunction,
418 int accessGroup = 0,
419 bool beforeFiles = false)
420 : HtmlPageHandler(pUrl, tGet, accessGroup, beforeFiles), m_pf(pFunction){};
421
422
423};
424
425
426
427
428extern const char *pHttpRealm; // The realm used for password requests
429
443HTTP_ACCESS CheckHttpAccess(int sock, int access_level, HTTP_Request &Req);
444
456void StartHttp(uint16_t port /* = 80 */, bool RunConfigMirror /* = true */);
457
458typedef int(http_errorhandler)(IPADDR ip, enum eWEB_ERROR Err, void *prm);
459
460/*Setup a custom WEB Error Report Handler */
461http_errorhandler *SetNewErrorHandler(http_errorhandler *newhandler);
462
468void StopHttp();
469
479void SendHTMLHeader(int sock);
480
491void SendHTMLHeaderWCookie(int sock, char *cookie);
492
502void SendTextHeader(int sock);
503
514void SendGifHeader(int sock);
515
524void EmptyResponse(int sock);
525
534void NoContentResponse(int sock);
535
545void RedirectResponse(int sock, PCSTR new_page);
546
556void NotFoundResponse(int sock, PCSTR new_page);
557
567void ForbiddenResponse(int sock, PCSTR new_page);
568
579void NotAvailableResponse(int sock, PCSTR new_page);
580
592void BadRequestResponse(int sock, PCSTR url, PCSTR data);
593
594void writesafestring(int fd, PCSTR str);
595
608int writeallsafestring(int fd, PCSTR str);
609
623int writesafestring(int fd, PCSTR str, size_t strLength);
624
625// Encode a uri component
626int decodeURI(char *str);
627
650int httpstricmp(PCSTR str1, PCSTR strIsUpper2);
651
652void append(char *&cpto, const char *cpfrm);
653
654//Add extra headers to html responses.
655extern const char * pExtraHeaders;
656
657
658
659#endif
660
Implements the HtmlPageHandler class as a function pointer callback for GET requests.
Definition http.h:326
CallBackFunctionPageHandler(const char *pUrl, http_gethandlerfunc *pFunction, HTTP_RequestTypes reqType=tGet, int accessGroup=0, bool beforeFiles=false)
Constructor for HTTP GET callback function.
Definition http.h:346
virtual bool Match(HTTP_Request &req)
Determines if this handler matches the incoming request.
Definition http.h:379
virtual int ProcessRaw(int sock, HTTP_Request &pdt)
Pure virtual method that must be implemented to process HTTP requests.
Definition http.h:332
CallBackFunctionPageHandler(const char *pUrl, http_gethandlerfunc *pFunction, http_matchhandlerfunc *pMatchFunction, HTTP_RequestTypes reqType=tGet, int accessGroup=0, bool beforeFiles=false)
Constructor for HTTP GET callback function, includes option for function to match the requested name.
Definition http.h:368
Base class for HTTP request handlers that process requests for specific URLs and HTTP methods.
Definition http.h:220
HtmlPageHandler * m_pNextHandler
Pointer to next handler in the linked list for efficient traversal.
Definition http.h:222
HTTP_RequestTypes m_requestTypes
HTTP method types this handler responds to (GET, POST, etc.)
Definition http.h:225
const char * m_pUrlName
URL pattern to match. Empty string or NULL matches all requests.
Definition http.h:223
HtmlPageHandler(const char *url, HTTP_RequestTypes rt=tGet, int accessGroup=0, bool Before_Files=false)
Constructs and registers an HTTP request handler for a specific URL pattern and method.
void MoveHandlerToLast()
Moves this handler to the end of the handler chain, making it function as a 404 handler.
virtual int ProcessRaw(int sock, HTTP_Request &pd)=0
Pure virtual method that must be implemented to process HTTP requests.
static HtmlPageHandler * FindHandler(HTTP_Request &req, bool bBeforeFiles)
Locates the appropriate handler for an incoming HTTP request.
int SortValue(HtmlPageHandler *pv)
Compares handler priorities for sorting (-1, 0, 1)
int GetGroup()
Returns the access control group identifier for this handler.
Definition http.h:304
virtual bool Match(HTTP_Request &req)
Determines if this handler matches the incoming request.
void Remove()
Removes handler from the linked list.
void InsertSort(HtmlPageHandler *&ph)
Inserts handler into sorted linked list based on priority.
int m_access_group
Access control group identifier for authorization checks.
Definition http.h:224
~HtmlPageHandler()
Destructor that automatically unregisters the handler from the global chain.
Used to hold and manipulate IPv4 and IPv6 addresses in dual stack mode.
Definition ipv6_addr.h:41
void ForbiddenResponse(int sock, PCSTR new_page)
Send a page is forbidden response.
HTTP_Request * GetActiveHttpRequest()
Get thc curent active running http request. Only valid fromwithing http get or post handeling....
void NotFoundResponse(int sock, PCSTR new_page)
Send a page not found response.
void SendHTMLHeader(int sock)
Send a HTML response header.
void BadRequestResponse(int sock, PCSTR url, PCSTR data)
Send a response indicating that the client request itself is faulty in some manner.
int writeallsafestring(int fd, PCSTR str)
Send a string and escape all special characters.
void SendHTMLHeaderWCookie(int sock, char *cookie)
Send a HTML response header and cookie.
HTTP_RequestTypes
HTTP request types for HTTP page handler callback functions.
Definition http.h:35
void EmptyResponse(int sock)
Send an empty response back.
void SendTextHeader(int sock)
Send a HTML plain text header.
void RedirectResponse(int sock, PCSTR new_page)
Redirect a HTTP request to a different page.
void NoContentResponse(int sock)
Send a no content response back.
int httpstricmp(PCSTR str1, PCSTR strIsUpper2)
Special string compare. Returns 1 if the strings match until one string ends with a null (0).
Definition WebSockets/Console/src/main.cpp:60
HTTP_ACCESS CheckHttpAccess(int sock, int access_level, HTTP_Request &Req)
All HTTP requests go though this function.
Definition JSON/DemoNetBurner/src/main.cpp:142
void NotAvailableResponse(int sock, PCSTR new_page)
Send a response indicating that the requested resource is not available at this time.
HTTP_REQ_RD_RESULT
HTTP Request Read Result.
Definition http.h:64
void StopHttp()
Stop the HTTP web server.
void SendGifHeader(int sock)
Send a HTML GIF header.
void StartHttp(uint16_t port, bool RunConfigMirror)
Start the HTTP web server. Further documentation in the Initialization section Initialization - Syste...
int http_gethandlerfunc(int sock, HTTP_Request &pd)
Implements the HtmlPageHandler class as a function pointer callback for GET requests.
Definition http.h:316
HTTP_ACCESS
HTTP page access return values.
Definition http.h:51
@ tGet
GET request.
Definition http.h:37
@ tPost
POST request.
Definition http.h:38
@ tPut
Put request.
Definition http.h:40
@ tUnknown
The type of request is not yet known.
Definition http.h:36
@ tDelete
Delete Request.
Definition http.h:39
@ tHead
Header request, does not include content.
Definition http.h:41
@ HTTP_RRR_BUF_FULL
Buffer full, more data remains to be read.
Definition http.h:65
@ HTTP_RRR_FINISHED
Read read all content as indicated by headers.
Definition http.h:66
@ HTTP_RRR_SOCK_ERR
Socket returned error while having no data, probably closed.
Definition http.h:69
@ HTTP_RRR_END_FOUND
Read found the trailing \r\n and terminated.
Definition http.h:67
@ HTTP_FORBIDEN
Report the page forbiden.
Definition http.h:55
@ HTTP_OK_TO_SERVE
Ok to serve the page.
Definition http.h:52
@ HTTP_NOTFOUND
Report the page is not found.
Definition http.h:54
@ HTTP_NEED_PASSWORD
Either the password in the HTTP request is wrong or missing.
Definition http.h:53
@ HTTP_RESPONSE_HANDLED
This means this function handled the full response, including closing the socket.
Definition http.h:56
HTTP Request Structure.
Definition http.h:87
void ProcessLine(PSTR startofline)
internal function
uint32_t content_length
Content length field from HTML header.
Definition http.h:98
uint16_t sep_len
Length of separator for multipart forms.
Definition http.h:97
int Respond(int socket)
internal function
PSTR pSep
Separator for multipart forms, null if not present.
Definition http.h:92
PSTR last_datarx
Pointer to last data read, internal use only.
Definition http.h:94
PSTR pHost
Pointer to host record null if not present.
Definition http.h:93
PSTR wsKey
Web socket ket, internal use only.
Definition http.h:95
PSTR wsProtocol
Web socket prototocl, internal use only.
Definition http.h:96
PSTR pFirstCookie
First cookie if present, otherwise null. More may follow.
Definition http.h:90
PSTR pData
Pointer to entire data set. Note: not null terminated.
Definition http.h:91
HTTP_RequestTypes req
Type of request HTTP_RequestTypes.
Definition http.h:102
PSTR pAuthorization
Authorization header if present, otherwise null.
Definition http.h:89
uint8_t websocketFlags
Web socket flags.
Definition http.h:101
PSTR pURL
Request URL.
Definition http.h:88
const char * GetBoundaryMarker()
Extracts the boundary marker string from multipart Content-Type headers.
int ReadSimpleBody(int socket, const char *boundary=NULL)
Reads the HTTP request body from a socket into the internal buffer and processes termination conditio...
uint32_t rx_length
Total bytes receive from request, internal use only.
Definition http.h:99
IPADDR client_IPaddr
IP address of client.
Definition http.h:100
bool ExtractAuthentication(char **pPassword, char **pUser)
used to extract user name and password in authentication test