26#include <config_obj.h>
28const int CONFIG_ACCESS_GROUP = 99;
189} __attribute__((packed));
204} __attribute__((packed));
209 eTCP_CONN_OPEN_NO_DATA,
210 eTCP_CONN_OPEN_TO_LONG,
344 http_matchhandlerfunc *m_mhf;
365 bool beforeFiles =
false)
366 :
HtmlPageHandler(pUrl, reqType, accessGroup, beforeFiles), m_pf(pFunction)
385 http_matchhandlerfunc *pMatchFunction,
388 bool beforeFiles =
false)
389 :
HtmlPageHandler(pUrl, reqType, accessGroup, beforeFiles), m_pf(pFunction)
391 m_mhf = pMatchFunction;
411 inline HtmlConfigExposer(
const char *pUrl, config_leaf & leaf,
414 bool beforeFiles =
false
416 :
HtmlPageHandler(pUrl, reqType, accessGroup, beforeFiles), pLeaf(&leaf)
420virtual int ProcessRaw(
int sock, HTTP_Request &pd);
424typedef void (ws_createhandlerfunc)(
int web_socket_fd);
428 ws_createhandlerfunc *m_pf;
430 int ProcessRaw(
int sock, HTTP_Request &pdt);
431 inline CallBackWSEndPoint(
const char *pUrl,
432 ws_createhandlerfunc *pFunction,
434 bool beforeFiles =
false)
443extern const char *pHttpRealm;
473typedef int(http_errorhandler)(
IPADDR ip,
enum eWEB_ERROR Err,
void *prm);
476http_errorhandler *SetNewErrorHandler(http_errorhandler *newhandler);
609void writesafestring(
int fd, PCSTR str);
638int writesafestring(
int fd, PCSTR str,
size_t strLength);
641int decodeURI(
char *str);
667void append(
char *&cpto,
const char *cpfrm);
670extern const char * pExtraHeaders;
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:361
virtual bool Match(HTTP_Request &req)
Determines if this handler matches the incoming request.
Definition http.h:394
virtual int ProcessRaw(int sock, HTTP_Request &pdt)
Pure virtual method that must be implemented to process HTTP requests.
Definition http.h:347
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:383
Base class for HTTP request handlers that process requests for specific URLs and HTTP methods.
Definition http.h:235
HtmlPageHandler * m_pNextHandler
Pointer to next handler in the linked list for efficient traversal.
Definition http.h:237
HTTP_RequestTypes m_requestTypes
HTTP method types this handler responds to (GET, POST, etc.).
Definition http.h:240
const char * m_pUrlName
URL pattern to match. Empty string or NULL matches all requests.
Definition http.h:238
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:319
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:239
~HtmlPageHandler()
Destructor that automatically unregisters the handler from the global chain.
IPADDR6 IPADDR
IPADDR Object Type (either v4 or v6).
Definition nettypes.h:568
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:331
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
uint32_t read_start_secs
Value of Secs when this request started, internal use only.
Definition http.h:100
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:103
PSTR pAuthorization
Authorization header if present, otherwise null.
Definition http.h:89
uint8_t websocketFlags
Web socket flags.
Definition http.h:102
uint32_t ReadBudgetTicks() const
Ticks a body read may block for without exceeding this request's total read budget.
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:101
bool ExtractAuthentication(char **pPassword, char **pUser)
used to extract user name and password in authentication test