HttpServer.h

Go to the documentation of this file.

/*
 *     ____             _________                __                _
 *    / __ \___  ____ _/ /_  __(_)___ ___  ___  / /   ____  ____ _(_)____
 *   / /_/ / _ \/ __ `/ / / / / / __ `__ \/ _ \/ /   / __ \/ __ `/ / ___/
 *  / _, _/  __/ /_/ / / / / / / / / / / /  __/ /___/ /_/ / /_/ / / /__
 * /_/ |_|\___/\__,_/_/ /_/ /_/_/ /_/ /_/\___/_____/\____/\__, /_/\___/
 *                                                       /____/
 *
 *                  Barracuda Embedded Web-Server
 *
 ****************************************************************************
 *                            HEADER
 *
 *   $Id: HttpServer.h 6770 2026-11-06 15:33:36Z wini $
 *
 *   COPYRIGHT:  Real Time Logic LLC, 2003 - 2026
 *
 *   This software is copyrighted by and is the sole property of Real
 *   Time Logic LLC.  All rights, title, ownership, or other interests in
 *   the software remain the property of Real Time Logic LLC.  This
 *   software may only be used in accordance with the terms and
 *   conditions stipulated in the corresponding license agreement under
 *   which the software has been supplied.  Any unauthorized use,
 *   duplication, transmission, distribution, or disclosure of this
 *   software is expressly forbidden.
 *                                                                        
 *   This Copyright notice may not be removed or modified without prior
 *   written consent of Real Time Logic LLC.
 *                                                                         
 *   Real Time Logic LLC. reserves the right to modify this software
 *   without notice.
 *
 *               http://www.realtimelogic.com
 ****************************************************************************
 *
 *
 */
 
#define BASLIB_VER "6826"
#define BASLIB_VER_NO 6826
 
#ifndef __HttpServer_h
#define __HttpServer_h
#include "TargConfig.h"
#include "HttpConnection.h"
#include "DoubleList.h"
#include "SingleList.h"
#include "SoDisp.h"
#include "SplayTree.h"
#include "BaErrorCodes.h"
#include "SplayTree.h"
#include "BufPrint.h"
#include "IoIntf.h"
#include <string.h>
#include <stddef.h>
 
/* Used by examples */
 
 
/* This ID must match the ID in LoginKey.java */
#define BA_COOKIE_ID "z9ZAqJtI"
 
#ifndef __DOXYGEN__
struct HttpRequest;
struct HttpResponse;
struct HttpPage;
struct HttpServer;
struct HttpSession;
struct HttpLinkCon;
struct HttpDir;
struct AuthenticatedUser;
struct UserIntf;
struct CspReader;
struct HttpCmdThreadPoolIntf;
struct AuthUserList;
struct AuthorizerIntf;
struct AuthenticatorIntf;
struct LHttpCommand;
#endif
 
 
/*  NonBlockingSendBuf is used when sending asynchronous, non-blocking
    data. A pointer to this buffer is stored in SoDispCon.sslData for
    HTTP connections; this pointer is not used for anything else for a
    non-secure socket connection. */
typedef struct
{
      int cursor;
      int bufLen;
      int maxBufLen;
      char buf[1];
} NonBlockingSendBuf;
 
 
#ifdef __cplusplus
extern "C" {
#endif
BA_API struct AuthenticatedUser* AuthenticatedUser_get2(
   struct HttpSession* session);
BA_API void httpFmtDate(char* buf, U16 bufLen, BaTime t);
 
#define httpUnescape(s) httpUnescapeInternal(s,FALSE)
 
#define httpFormUnescape(s) httpUnescapeInternal(s,TRUE)
 
BA_API char* httpUnescapeInternal(char* from, BaBool isForm);
 
BA_API char* httpEscape(char* out, const char* in);
#ifdef __cplusplus
}
#endif
 
 
typedef void (*UserDefinedErrHandler)(BaFatalErrorCodes ecode1,
                                      unsigned int ecode2,
                                      const char* file,
                                      int line);
 
 
typedef void (*CspInit)(
   struct HttpDir* cspRoot,struct CspReader* reader);
 /* end of CSP */
 
/* no longer used. included for compatibility.
 */
struct z_stream_s;
typedef int (*ZlibInflateInit2)(struct z_stream_s* s, int  windowBits,
                     const char *version, int stream_size);
 
typedef int (*ZlibInflate)(struct z_stream_s* s, int flush);
typedef int (*ZlibInflateEnd)(struct z_stream_s* s);
 
 
#ifndef __DOXYGEN__
 
typedef struct
{
      char* buf;
      U16 size;
      U16 index;
} HttpAllocator;
 
 
typedef struct HttpHeader
{
#ifdef __cplusplus
      const char* name(HttpRequest* req);
      const char* value(HttpRequest* req);
#endif
      U16 nameI;
      U16 valueI;
}HttpHeader;
 
#ifdef __cplusplus
extern "C" {
#endif
BA_API const char* HttpHeader_name(HttpHeader* o, struct HttpRequest* req);
BA_API const char* HttpHeader_value(HttpHeader* o, struct HttpRequest* req);
#ifdef __cplusplus
}
inline const char* HttpHeader::name(HttpRequest* req) {
   return HttpHeader_name(this, req); }
inline const char* HttpHeader::value(HttpRequest* req) {
   return HttpHeader_value(this, req); }
#endif
 
#endif
 
 
 
 
 
/*===========================================================================
 *
 *       HttpInData
 *---------------------------------------------------------------------------
 *  Description:
 */
 
#ifndef __DOXYGEN__
 
typedef enum {
   HttpInData_ParseHeader,
   HttpInData_ReadBody,
   HttpInData_ReadBodyAndParseUrlEncData
} HttpInData_ParseState;
#endif
 
 
typedef struct HttpInData
{
#ifdef __cplusplus
      const char* getBuf();
 
      S32 getBufSize();
#endif
      HttpAllocator allocator;
      struct HttpRequest* request;
      U16 lineStartI;
      U16 lineEndI;
      S16 maxRequest;
      U8 parseState; /* HttpInData_ParseState */
      U8 overflow; /* Used for pipelined requests */
} HttpInData;
 
#define HttpAllocator_2Ptr(o, index) ((&(o)->buf[index]))
#define HttpInData_lineStartPtr(o) \
  HttpAllocator_2Ptr(&(o)->allocator,(o)->lineStartI)
 
#define HttpInData_getBufSize(o) \
  ((o)->lineStartI < (o)->allocator.index ? \
  (o)->allocator.index-(o)->lineStartI : 0)
 
#define HttpInData_getBuf(o) HttpInData_lineStartPtr(o)
BaBool HttpInData_hasMoreData(HttpInData* o);
 
#ifdef __cplusplus
inline const char* HttpInData::getBuf() {
   return HttpInData_getBuf(this); }
inline S32 HttpInData::getBufSize() {
   return HttpInData_getBufSize(this); }
#endif
 
 
 
typedef struct HttpParameter
{
#ifdef __cplusplus
      static U32 calculateSize(struct HttpRequest* req);
 
      static HttpParameter* clone(void* buf, struct HttpRequest* req);
 
      const char* getParameter(const char* paramName);
 
   private:
      HttpParameter() {}
#endif
      U16 formLen;
} HttpParameter;
 
 
#ifdef __cplusplus
extern "C" {
#endif
BA_API U32 HttpParameter_calculateSize(struct HttpRequest* req);
BA_API HttpParameter* HttpParameter_clone(void* buf, struct HttpRequest* req);
BA_API const char* HttpParameter_getParameter(
   HttpParameter* o,const char* paramName);
 
#ifdef __cplusplus
}
inline U32 HttpParameter::calculateSize(struct HttpRequest* req) {
   return HttpParameter_calculateSize(req); }
inline HttpParameter* HttpParameter::clone(void* buf, struct HttpRequest* req){
   return HttpParameter_clone(buf, req); }
inline const char* HttpParameter::getParameter(const char* paramName) {
   return HttpParameter_getParameter(this, paramName); }
#endif
 
 
typedef struct HttpParameterIterator
{
#ifdef __cplusplus
      HttpParameterIterator(){}
      HttpParameterIterator(HttpRequest* req);
 
      HttpParameterIterator(HttpParameter* param);
 
      void nextElement();
      bool hasMoreElements();
      const char* getName() const { return name; }
      const char* getValue() const { return value; }
   private:
#endif
      void* formElemBase;
      U8* dataEntry;
      U16 pos;
      U16 formLen;
      const char* name;
      const char* value;
 
} HttpParameterIterator;
 
#ifdef __cplusplus
extern "C" {
#endif
 
BA_API int HttpParameterIterator_constructor(
   HttpParameterIterator* o, struct HttpRequest* req);
BA_API int HttpParameterIterator_constructor2(HttpParameterIterator* o,
                                              HttpParameter* param);
BA_API void HttpParameterIterator_nextElement(HttpParameterIterator* o);
#define HttpParameterIterator_hasMoreElements(o) ((o)->name != 0)
#define HttpParameterIterator_getName(o) (o)->name
#define HttpParameterIterator_getValue(o) (o)->value
 
 
#ifdef __cplusplus
}
inline HttpParameterIterator::HttpParameterIterator(HttpRequest* req) {
   HttpParameterIterator_constructor(this, req); }
inline HttpParameterIterator::HttpParameterIterator(HttpParameter* param) {
   HttpParameterIterator_constructor2(this, param); }
inline void HttpParameterIterator::nextElement() {
   HttpParameterIterator_nextElement(this); }
#endif
 
 
typedef struct HttpCookie
{
#ifdef __cplusplus
      ~HttpCookie();
 
      const char* getComment() const { return comment; }
 
      const char* getDomain()  const { return domain; }
 
      BaTime      getMaxAge()  const { return maxAge; }
 
      const char* getName()    const { return name; }
 
      const char* getPath()    const { return path; }
 
      bool        getSecure()  const { return secure ? true : false; }
 
      bool        getHttpOnly()  const { return httpOnly ? true : false; }
 
      const char* getValue()   const { return value; }
 
      int setComment(const char* purpose);
 
      int setDomain(const char* pattern);
 
      void setMaxAge(BaTime expiry);
      void deleteCookie();
 
      int setPath(const char* uri);
 
      void setSecure(bool flag);
 
      void setHttpOnly(bool flag);
 
      int setValue(const char* newValue);
 
#if 0
      int getVersion() const { return version; }
      /* Sets the version of the cookie protocol this cookie complies with. */
      void setVersion(int v);
#endif
 
      void activate();
   private:
      HttpCookie();
#endif
      struct HttpCookie* next;
      char* comment;
      char* domain;
      char* name;
      char* path;
      char* value;
      BaTime maxAge;
      int   version;
      BaBool  secure;
      BaBool  httpOnly;
      BaBool  deleteCookieFlag;
      BaBool  activateFlag; /* The cookie will be sent to the client
                                * if this flag is true */
} HttpCookie;
 
#ifdef __cplusplus
extern "C" {
#endif
BA_API void HttpCookie_destructor(HttpCookie* o);
BA_API const char* HttpCookie_getComment(HttpCookie* o);
BA_API const char* HttpCookie_getDomain(HttpCookie* o);
BA_API BaTime HttpCookie_getMaxAge(HttpCookie* o);
BA_API const char* HttpCookie_getName(HttpCookie* o);
BA_API const char* HttpCookie_getPath(HttpCookie* o);
BA_API BaBool HttpCookie_getSecure(HttpCookie* o);
BA_API BaBool HttpCookie_getHttpOnly(HttpCookie* o);
BA_API const char* HttpCookie_getValue(HttpCookie* o);
BA_API int HttpCookie_setComment(HttpCookie* o, const char* purpose);
BA_API int HttpCookie_setDomain(HttpCookie* o, const char* pattern);
BA_API void HttpCookie_setMaxAge(HttpCookie* o, BaTime expiry);
#define HttpCookie_deleteCookie(o) (o)->deleteCookieFlag = TRUE;
BA_API int HttpCookie_setPath(HttpCookie* o, const char* uri);
BA_API void HttpCookie_setSecure(HttpCookie* o, BaBool flag);
BA_API void HttpCookie_setHttpOnly(HttpCookie* o, BaBool flag);
BA_API int HttpCookie_setValue(HttpCookie* o, const char* newValue);
 
#if 0
int HttpCookie_getVersion(HttpCookie* o);
void HttpCookie_setVersion(HttpCookie* o, int v);
#endif
 
BA_API void HttpCookie_activate(HttpCookie* o);
#ifdef __cplusplus
}
inline HttpCookie::HttpCookie() { baAssert(0); }
inline HttpCookie::~HttpCookie() { HttpCookie_destructor(this); }
inline int HttpCookie::setComment(const char* purpose) {
   return HttpCookie_setComment(this, purpose); }
inline int HttpCookie::setDomain(const char* pattern) {
   return HttpCookie_setDomain(this, pattern); }
inline void HttpCookie::setMaxAge(BaTime expiry) {
   HttpCookie_setMaxAge(this, expiry); }
inline void HttpCookie::deleteCookie() {
   HttpCookie_deleteCookie(this); }
inline int HttpCookie::setPath(const char* uri) {
   return HttpCookie_setPath(this, uri); }
inline void HttpCookie::setSecure(bool flag) {
   HttpCookie_setSecure(this, flag ? TRUE : FALSE); }
inline void HttpCookie::setHttpOnly(bool flag) {
   HttpCookie_setHttpOnly(this, flag ? TRUE : FALSE); }
inline int HttpCookie::setValue(const char* newValue) {
   return HttpCookie_setValue(this, newValue); }
#if 0
inline void HttpCookie::setVersion(int v) {
   HttpCookie_setVersion(this, v); }
#endif
inline void HttpCookie::activate() {
   HttpCookie_activate(this); }
#endif
 
 
typedef struct HttpStdHeaders
{
#ifdef __cplusplus
      const char* getConnection();
 
      const char* getHost();
 
      const char* getDomain();
 
      const char* getContentType();
 
      SBaFileSize getContentLength();
#endif
      HttpInData* inData;
      char* domain;
      BaFileSize contentLength;
      U16 connectionHOffs;
      U16 hostHOffs;
      U16 contentTypeHOffs;
} HttpStdHeaders;
 
#ifdef __cplusplus
extern "C" {
#endif
BA_API const char* HttpStdHeaders_zzGetValFromOffs(
   HttpStdHeaders* o, U16 offset);
BA_API const char* HttpStdHeaders_getDomain(HttpStdHeaders* o);
#define HttpStdHeaders_getConnection(o) \
  HttpStdHeaders_zzGetValFromOffs(o,(o)->connectionHOffs)
#define HttpStdHeaders_getHost(o) \
  HttpStdHeaders_zzGetValFromOffs(o,(o)->hostHOffs)
#define HttpStdHeaders_getContentType(o) \
  HttpStdHeaders_zzGetValFromOffs(o,(o)->contentTypeHOffs)
#define HttpStdHeaders_getContentLength(o) (o)->contentLength
 
#ifdef __cplusplus
}
inline const char* HttpStdHeaders::getConnection() {
   return  HttpStdHeaders_getConnection(this); }
inline const char* HttpStdHeaders::getHost() {
   return  HttpStdHeaders_getHost(this); }
inline const char* HttpStdHeaders::getDomain() {
   return  HttpStdHeaders_getDomain(this); }
inline const char* HttpStdHeaders::getContentType() {
   return  HttpStdHeaders_getContentType(this); }
inline SBaFileSize HttpStdHeaders::getContentLength() {
   return  HttpStdHeaders_getContentLength(this); }
 
#endif
 
 
 
 /*Do not change the HttpMethod type without checking tables in Httpserver.c*/
 
typedef enum {
   HttpMethod_Connect   =0x00001,
   HttpMethod_Get       =0x00002,
   HttpMethod_Head      =0x00004,
   HttpMethod_Options   =0x00008,
 
   HttpMethod_Patch     =0x00010,
   HttpMethod_Post      =0x00020,
   HttpMethod_Put       =0x00040,
   HttpMethod_Trace     =0x00080,
 
   /* WebDAV */
   HttpMethod_Copy      =0x00100,
   HttpMethod_Delete    =0x00200,
   HttpMethod_Lock      =0x00400,
   HttpMethod_Move      =0x00800,
 
   HttpMethod_Mkcol     =0x01000,
   HttpMethod_Propfind  =0x02000,
   HttpMethod_Proppatch =0x04000,
   HttpMethod_Unlock    =0x08000,
 
   HttpMethod_Unknown   =0x10000 /* Must be last */
} HttpMethod;
 
 
/* Convert an HTTP method from string value to the type HttpMethod */
BA_API HttpMethod HttpMethod_a2m(const char* str);
 
 
 
typedef struct HttpRequest
{
#ifdef __cplusplus
 
      int checkMethods(HttpResponse* resp, U32 methods, bool addDefault=TRUE);
 
      BaBool checkTime(struct HttpResponse* resp, BaTime time);
 
      AuthenticatedUser* getAuthenticatedUser();
 
      const char* getRequestURI();
 
      const char* getRequestURL(bool forceHttps=false);
 
      HttpStdHeaders* getStdHeaders();
 
      const char* getVersion();
 
      const char* getHeaderValue(const char* name);
 
      HttpCookie* getCookie(const char* name);
 
      HttpMethod getMethodType();
 
      const char* getMethod();
 
      static const char* getMethod(HttpMethod method);
 
      const char* getParameter(const char* paramName);
 
      int wsUpgrade();
 
      HttpHeader* getHeaders(int* len);
 
 
 
      HttpSession* getSession(BaBool create=true);
      HttpConnection* getConnection();
 
      HttpServer* getServer();
 
      HttpResponse* getResponse();
 
      HttpCommand* getCommand();
 
      HttpInData* getBuffer();
 
 
      int setUserObj(void* userObj, bool overwrite=false);
      void* getUserObj();
 
#endif
      HttpStdHeaders stdH;
      HttpAllocator headerAlloc;
      HttpAllocator formAlloc;
      HttpInData inData;
      struct HttpServer* server;
      void* userObj;
      struct HttpSession* session;
      HttpMethod methodType;
      U16 pathI;
      U16 versionI;
      U16 headersI;
      U16 headerLen;
      U16 formsI;
      U16 formLen;
      BaBool postDataConsumed; /* Set by MultipartUpload and HttpRecData */
      BaBool expect100Continue; /* Validated expectation; cleared when handled. */
      BaBool chunkedBody; /* Set only after successful framing validation. */
}HttpRequest;
 
#ifdef __cplusplus
extern "C" {
#endif
BA_API int HttpRequest_checkMethods(HttpRequest* o, struct HttpResponse* resp,
                                    U32 methods, BaBool addDefault);
BA_API int HttpRequest_checkOptions(
   HttpRequest* o, struct HttpResponse* resp, int optLen, ...);
#define HttpRequest_getAuthenticatedUser(o) \
  AuthenticatedUser_get2(HttpRequest_getSession(o,FALSE))
#define HttpRequest_getConnection(o) HttpRequest_getCommand(o)->con
#define HttpRequest_getMethodType(o) (o)->methodType
#define HttpRequest_getMethod(o) HttpRequest_getMethod2((o)->methodType)
BA_API const char* HttpRequest_getMethod2(HttpMethod method);
#define HttpRequest_getServer(o) (o)->server
#define HttpRequest_getResponse(o) (&HttpRequest_getCommand(o)->response)
BA_API struct HttpCommand* HttpRequest_getCommand(HttpRequest*);
BA_API BaBool HttpRequest_checkTime(
   HttpRequest* o, struct HttpResponse* resp, BaTime time);
BA_API const char* HttpRequest_getRequestURI(HttpRequest* o);
BA_API const char* HttpRequest_getRequestURL(HttpRequest* o,BaBool forceHttps);
#define HttpRequest_getStdHeaders(o) (&(o)->stdH)
BA_API const char* HttpRequest_getVersion(HttpRequest* o);
BA_API const char* HttpRequest_getHeaderValue(HttpRequest* o,const char* name);
#define HttpRequest_getNoOfParameters(o) (o)->formLen
BA_API HttpCookie* HttpRequest_getCookie(HttpRequest* o, const char* name);
#define HttpRequest_getUserObj(o) (o)->userObj
BA_API int HttpRequest_setUserObj(
   HttpRequest* o, void* userObj, BaBool overwrite);
#define HttpRequest_getBuffer(o) (&(o)->inData)
BA_API const char* HttpRequest_getParameter(
   HttpRequest* o, const char* paramName);
BA_API HttpHeader* HttpRequest_getHeaders(HttpRequest* o, int* len);
BA_API int HttpRequest_wsUpgrade(HttpRequest* o);
BA_API BaBool HttpRequest_enableKeepAlive(HttpRequest* o);
BA_API int HttpRequest_pushBackData(HttpRequest* o);
BA_API struct HttpSession* HttpRequest_getSession(
   HttpRequest* o, BaBool create);
BA_API struct HttpSession* HttpRequest_session(
   HttpRequest* o, const char* val, size_t len, int set);
#ifdef __cplusplus
}
 
inline int HttpRequest::checkMethods(HttpResponse* resp,
                        U32 methods, bool addDefault){
   return HttpRequest_checkMethods(this,resp,
      methods, addDefault ? TRUE : FALSE);}
 
inline BaBool HttpRequest::checkTime(struct HttpResponse* resp, BaTime time) {
   return HttpRequest_checkTime(this, resp, time); }
inline AuthenticatedUser* HttpRequest::getAuthenticatedUser() {
   return HttpRequest_getAuthenticatedUser(this); }
inline HttpMethod HttpRequest::getMethodType() {
   return HttpRequest_getMethodType(this); }
inline const char* HttpRequest::getMethod() {
   return HttpRequest_getMethod(this); }
inline const char* HttpRequest::getMethod(HttpMethod method) {
   return HttpRequest_getMethod2(method); }
inline HttpServer* HttpRequest::getServer() {
   return HttpRequest_getServer(this); }
inline const char* HttpRequest::getRequestURI() {
   return HttpRequest_getRequestURI(this); }
inline const char* HttpRequest::getRequestURL(bool forceHttps) {
   return HttpRequest_getRequestURL(this, forceHttps); }
inline HttpStdHeaders* HttpRequest::getStdHeaders() {
   return HttpRequest_getStdHeaders(this); }
inline const char* HttpRequest::getVersion() {
   return HttpRequest_getVersion(this); }
inline const char* HttpRequest::getHeaderValue(const char* name) {
   return HttpRequest_getHeaderValue(this, name); }
inline HttpCookie* HttpRequest::getCookie(const char* name) {
   return HttpRequest_getCookie(this, name); }
inline const char* HttpRequest::getParameter(const char* paramName) {
   return HttpRequest_getParameter(this, paramName); }
inline int HttpRequest::wsUpgrade() {
   return HttpRequest_wsUpgrade(this);
}
inline HttpHeader* HttpRequest::getHeaders(int* len) {
   return HttpRequest_getHeaders(this, len); }
inline int HttpRequest::setUserObj(void* userObj, bool overwrite) {
   return HttpRequest_setUserObj(this, userObj, overwrite); }
inline void* HttpRequest::getUserObj() {
   return HttpRequest_getUserObj(this); }
inline HttpSession* HttpRequest::getSession(BaBool create) {
   return HttpRequest_getSession(this, create); }
inline bool HttpParameterIterator::hasMoreElements() {
   return HttpParameterIterator_hasMoreElements(this); }
inline HttpInData* HttpRequest::getBuffer() {
   return HttpRequest_getBuffer(this); }
#endif
 
 
#ifndef __DOXYGEN__
 
typedef struct
{
      HttpAllocator data;
      U16 maxResponseHeader;
} NameValMM;
 
 
typedef struct
{
      U8 major;
      U8 minor;
} HttpProtocol;
 
#endif
 
typedef struct HttpResponse
{
#ifdef __cplusplus
 
      U32 byteCount();
 
 
      HttpCookie* createCookie(const char* name);
 
      const char* containsHeader(const char* name);
 
      const char* encodeRedirectURL(const char* pathName);
 
      const char* encodeRedirectURLWithParam(const char* pathName);
 
      const char* encodeUrl(const char* path);
 
      int flush();
 
      int forward(const char* path);
 
      int redirect(const char* path);
 
 
      HttpRequest* getRequest();
 
      HttpCommand* getCommand();
 
 
      int include(const char* path);
 
      bool committed() const;
 
      bool isForward() const;
 
      bool isInclude() const;
 
      bool initial() const;
 
      int resetHeaders();
 
      int resetBuffer();
 
      int sendError(int eCode);
 
      int sendError(int eCode, const char* msg);
 
      int sendBufAsError(int eCode);
 
      int sendBufAsTxtError(int eCode);
 
 
      int fmtError(int eCode, const char* fmt, ...);
 
      int sendRedirect(const char* url);
 
      int redirect2TLS();
 
      int setContentLength(BaFileSize len);
 
      int setContentType(const char* type);
 
      int setDateHeader(const char* name, BaTime time);
 
      int setHeader(const char* name, const char* value, bool replace=true);
 
      int setMaxAge(BaTime seconds);
 
 
      char* fmtHeader(const char* name, int valueLen, bool replace=true);
 
 
      void setStatus(int statusCode);
 
      int printf(const char* fmt, ...);
 
      BufPrint* getWriter();
 
      int write(const void* data, int len, int useBuffering=TRUE);
 
      int write(const char* data, int useBuffering=TRUE);
 
      int send(const void* data, int len);
 
      int setDefaultHeaders();
 
      int setResponseBuf(BufPrint* buf, bool useDefBuffer=true);
 
      int removeResponseBuf();
 
 
      int setUserObj(void* userObj, bool overwrite=false);
#endif
      NameValMM nameValMM;
      BufPrint headerPrint;
      BufPrint defaultBodyPrint;
      BufPrint* bodyPrint;
      struct HttpDir* currentDir;
      char* encodedURL;
      char* encodedRedirectURL;
      HttpCookie* cookieList;
      void* userObj;
      int statusCode;
      U32 msgLen; /* Used if request is of type HEAD, count total msg len */
      HttpProtocol protocol;
      U16 includeCounter;
      U16 forwardCounter;
      char headerSent;
      char printAndWriteInitialized;
      char useChunkTransfer;
} HttpResponse;
 
#ifdef __cplusplus
extern "C" {
#endif
BA_API HttpCookie* HttpResponse_createCookie(
   struct HttpResponse* o,const char* name);
BA_API const char* HttpResponse_containsHeader(
   HttpResponse* o, const char* name);
BA_API int HttpResponse_dataAdded(HttpResponse* o, U32 size);
#define HttpResponse_byteCount(o) ((o)->msgLen + (o)->bodyPrint->cursor)
BA_API const char* HttpResponse_encodeRedirectURL(
   HttpResponse* o, const char* pathName);
BA_API const char* HttpResponse_encodeRedirectURLWithParamOrSessionURL(
   HttpResponse* o,const char* path,BaBool setUrlCookie);
#define HttpResponse_encodeRedirectURLWithParam(o, path) \
   HttpResponse_encodeRedirectURLWithParamOrSessionURL(o, path, FALSE)
#define HttpResponse_encodeSessionURL(o, path) \
   HttpResponse_encodeRedirectURLWithParamOrSessionURL(o, path, TRUE)
BA_API const char* HttpResponse_encodeUrl(HttpResponse* o, const char* path);
BA_API int HttpResponse_flush(HttpResponse* o);
#define HttpResponse_forward(o,path) HttpResponse_incOrForward(o,path,FALSE)
#define HttpResponse_getConnection(o) HttpResponse_getCommand(o)->con
#define HttpResponse_getRequest(o) (&HttpResponse_getCommand(o)->request)
BA_API struct HttpCommand* HttpResponse_getCommand(HttpResponse*);
#define HttpResponse_getBuf(o) (o)->bodyPrint->buf
#define HttpResponse_getBufSize(o) (o)->bodyPrint->bufSize
#define HttpResponse_getBufOffs(o) \
   ((o)->bodyPrint->buf + (o)->bodyPrint->cursor)
#define HttpResponse_getRemBufSize(o) \
   ((o)->bodyPrint->bufSize - (o)->bodyPrint->cursor)
#define HttpResponse_getUserObj(o) (o)->userObj
BA_API int HttpResponse_incOrForward(
   HttpResponse* o, const char* path, BaBool isInc);
BA_API int HttpResponse_redirect(HttpResponse* o, const char* path);
#define HttpResponse_include(o,path) HttpResponse_incOrForward(o,path,TRUE)
#define HttpResponse_isChunkTransfer(o) (o)->useChunkTransfer
#define HttpResponse_committed(o) (o)->headerSent
#define HttpResponse_isForward(o) ((o)->forwardCounter != 0)
#define HttpResponse_isInclude(o) ((o)->includeCounter != 0)
#define HttpResponse_initial(o) (!HttpResponse_isForward(o) && \
                                 !HttpResponse_isInclude(o))
BA_API int HttpResponse_setResponseBuf(
   HttpResponse* o,BufPrint* buf,BaBool useDefBuffer);
BA_API int HttpResponse_removeResponseBuf(HttpResponse* o);
 
BA_API int HttpResponse_resetHeaders(HttpResponse* o);
BA_API int HttpResponse_resetBuffer(HttpResponse* o);
BA_API int HttpResponse_sendError1(HttpResponse* o, int eCode);
BA_API int HttpResponse_sendError2(HttpResponse* o,int eCode,const char* msg);
BA_API int HttpResponse_sendBufAsError(HttpResponse* o,int eCode);
BA_API int HttpResponse_sendBufAsTxtError(HttpResponse* o,int eCode);
BA_API int HttpResponse_fmtVError(
   HttpResponse* response,
   int eCode,
   const char* fmt,
   va_list varg);
BA_API int HttpResponse_fmtError(
   HttpResponse* response,
   int eCode,
   const char* fmt, ...);
BA_API int HttpResponse_sendRedirect(HttpResponse* o, const char* url);
BA_API int HttpResponse_sendRedirectI(
   HttpResponse* o, const char* url, int status);
BA_API int HttpResponse_redirect2TLS(HttpResponse* o);
#define HttpResponse_forceHttps HttpResponse_redirect2TLS /* Backw. comp. */
 
#define HttpResponse_setBufPos(o, pos) (o)->bodyPrint->cursor = pos
BA_API int HttpResponse_setContentLength(HttpResponse* o, BaFileSize len);
BA_API int HttpResponse_setContentType(HttpResponse* o, const char* type);
BA_API int HttpResponse_checkContentType(HttpResponse* o, const char* type);
BA_API int HttpResponse_setDateHeader(
   HttpResponse* o, const char* name, BaTime t);
BA_API int HttpResponse_setHeader(
   HttpResponse* o,const char* name,const char* value, BaBool replace);
BA_API int HttpResponse_setMaxAge(HttpResponse* response, BaTime seconds);
BA_API char* HttpResponse_fmtHeader(
   HttpResponse* o, const char* name, int valueLen, BaBool replace);
BA_API int HttpResponse_setStatus(HttpResponse* o, int eCode);
BA_API int HttpResponse_vprintf(
   HttpResponse* o, const char* fmt, va_list argList);
BA_API int HttpResponse_printf(HttpResponse* o, const char* fmt, ...);
BA_API int HttpResponse_write(HttpResponse* o, const void* data, int len,
                              int useBuffering);
BA_API BufPrint* HttpResponse_getWriter(HttpResponse* o);
BA_API int HttpResponse_send(HttpResponse* o, const void* data, int len);
BA_API int HttpResponse_setDefaultHeaders(HttpResponse* o);
BA_API int HttpResponse_downgrade(HttpResponse* o);
BA_API int HttpResponse_setUserObj(
   HttpResponse* o,void* userObj,BaBool overwrite);
BA_API int HttpResponse_printAndWriteInit(HttpResponse* o);
BA_API int HttpResponse_send100Continue(HttpResponse* o);
BA_API int HttpResponse_setChunkEncoding(HttpResponse* o);
BA_API const char* HttpResponse_getRespData(HttpResponse* o, int* len);
#define HttpResponse_getStatus(o) (o)->statusCode
#ifdef __cplusplus
}
inline HttpCookie* HttpResponse::createCookie(const char* name) {
   return HttpResponse_createCookie(this, name); }
inline const char* HttpResponse::containsHeader(const char* name) {
   return HttpResponse_containsHeader(this, name); }
inline U32 HttpResponse::byteCount() {
   return HttpResponse_byteCount(this); }
inline const char* HttpResponse::encodeRedirectURL(const char* pathName) {
   return HttpResponse_encodeRedirectURL(this, pathName); }
inline const char* HttpResponse::encodeRedirectURLWithParam(const char* p) {
   return HttpResponse_encodeRedirectURLWithParam(this, p); }
inline const char* HttpResponse::encodeUrl(const char* path) {
   return HttpResponse_encodeUrl(this, path); }
inline int HttpResponse::flush() {
   return HttpResponse_flush(this); }
inline int HttpResponse::forward(const char* path) {
   return HttpResponse_forward(this, path); }
inline int HttpResponse::redirect(const char* path) {
   return HttpResponse_redirect(this, path); }
inline int HttpResponse::include(const char* path) {
   return HttpResponse_include(this, path); }
inline bool HttpResponse::committed() const {
   return HttpResponse_committed(this) ? true : false; }
inline bool HttpResponse::isForward() const {
   return HttpResponse_isForward(this) ? true : false; }
inline bool HttpResponse::isInclude() const {
   return HttpResponse_isInclude(this) ? true : false; }
inline bool HttpResponse::initial() const {
   return HttpResponse_initial(this) ? true : false; }
inline int HttpResponse::setResponseBuf(BufPrint* buf, bool useDefBuffer) {
   return HttpResponse_setResponseBuf(this, buf, useDefBuffer?TRUE:FALSE); }
inline int HttpResponse::removeResponseBuf() {
   return HttpResponse_removeResponseBuf(this); }
inline int HttpResponse::resetHeaders() {
   return HttpResponse_resetHeaders(this); }
inline int HttpResponse::resetBuffer() {
   return HttpResponse_resetBuffer(this); }
inline int HttpResponse::sendError(int eCode) {
   return HttpResponse_sendError1(this, eCode); }
inline int HttpResponse::sendError(int eCode, const char* msg) {
   return HttpResponse_sendError2(this, eCode, msg); }
inline int HttpResponse::sendBufAsError(int eCode) {
   return HttpResponse_sendBufAsError(this, eCode); }
inline int HttpResponse::sendBufAsTxtError(int eCode) {
   return HttpResponse_sendBufAsTxtError(this,eCode);}
inline int HttpResponse::fmtError(int eCode,const char* fmt,...) {
   int retv; va_list varg;
   va_start(varg, fmt);
   retv = HttpResponse_fmtVError(this, eCode, fmt, varg);
   va_end(varg);
   return retv; }
inline int HttpResponse::sendRedirect(const char* url) {
   return HttpResponse_sendRedirect(this, url); }
inline int HttpResponse::redirect2TLS() {
   return HttpResponse_redirect2TLS(this); }
inline int HttpResponse::setContentLength(BaFileSize len) {
   return HttpResponse_setContentLength(this, len); }
inline int HttpResponse::setContentType(const char* type) {
   return HttpResponse_setContentType(this, type); }
inline int HttpResponse::setDateHeader(const char* name, BaTime t) {
   return HttpResponse_setDateHeader(this, name, t); }
inline int HttpResponse::setHeader(
   const char* name, const char* value, bool replace) {
   return HttpResponse_setHeader(this,name, value, replace?TRUE:FALSE); }
inline int HttpResponse::setMaxAge(BaTime seconds) {
   return HttpResponse_setMaxAge(this, seconds); }
inline char* HttpResponse::fmtHeader(
   const char* name, int valueLen, bool replace) {
   return HttpResponse_fmtHeader(this, name, valueLen, replace?TRUE:FALSE); }
inline void HttpResponse::setStatus(int eCode) {
   HttpResponse_setStatus(this, eCode);}
 
inline int HttpResponse::printf(const char* fmt, ...) {
   int retv; va_list varg; va_start(varg, fmt);
   retv = HttpResponse_vprintf(this, fmt, varg); va_end(varg); return retv;}
inline int HttpResponse::write(const char* data, int useBuffering) {
   return HttpResponse_write(this, data, iStrlen(data), useBuffering); }
inline BufPrint* HttpResponse::getWriter() {
   return HttpResponse_getWriter(this); }
inline int HttpResponse::write(const void* data, int len, int useBuffering){
   return HttpResponse_write(this, data, len, useBuffering); }
inline int HttpResponse::send(const void* data, int len) {
   return HttpResponse_send(this, data, len); }
inline int HttpResponse::setDefaultHeaders() {
   return HttpResponse_setDefaultHeaders(this); }
inline int HttpResponse::setUserObj(void* userObj, bool overwrite) {
   return HttpResponse_setUserObj(this, userObj, overwrite); }
 
#endif
 
typedef struct HttpCommand
{
#ifdef __cplusplus
 
      HttpRequest* getRequest();
 
      HttpResponse* getResponse();
 
      struct HttpConnection* getConnection();
 
      struct HttpServer* getServer();
 
      HttpCommand() {}
#endif
      DoubleLink super;
#ifdef __cplusplus
   public:
#endif
      HttpRequest request;
      HttpResponse response;
      struct HttpConnection* con;
      struct LHttpCommand* lcmd; /* Used by LSP plugin */
          BaTime requestTime;
      BaBool runningInThread;
}HttpCommand;
 
#define HttpCommand_getRequest(o) (&(o)->request)
#define HttpCommand_getResponse(o) (&(o)->response)
#define HttpCommand_getConnection(o) (o)->con
#define HttpCommand_getServer(o) HttpConnection_getServer((o)->con)
#ifdef __cplusplus
inline HttpRequest* HttpCommand::getRequest() {
   return HttpCommand_getRequest(this); }
inline HttpResponse* HttpCommand::getResponse() {
   return HttpCommand_getResponse(this); }
inline struct HttpConnection* HttpCommand::getConnection() {
   return HttpCommand_getConnection(this); }
inline struct HttpServer* HttpCommand::getServer() {
   return HttpCommand_getServer(this);
}
#endif
 
 
 
#ifndef __DOXYGEN__
struct HttpSessionAttribute;
struct HttpSessionContainer;
#endif
 
typedef void (*HttpSessionAttribute_Destructor)(
   struct HttpSessionAttribute* o);
 
typedef struct HttpSessionAttribute
{
#ifdef __cplusplus
      HttpSessionAttribute(const char* name,
                           HttpSessionAttribute_Destructor terminate);
 
      HttpSession* getSession();
#endif
      struct HttpSessionAttribute* next;
      struct HttpSession* session;
      HttpSessionAttribute_Destructor destructor;
      char* name;
} HttpSessionAttribute;
 
#ifdef __cplusplus
extern "C" {
#endif
 
BA_API void HttpSessionAttribute_constructor(
   HttpSessionAttribute* o,
   const char* name,
   HttpSessionAttribute_Destructor d);
BA_API void HttpSessionAttribute_destructor(HttpSessionAttribute* o);
#define HttpSessionAttribute_getSession(o) (o)->session
#ifdef __cplusplus
}
inline HttpSessionAttribute::HttpSessionAttribute(
   const char* name,
   HttpSessionAttribute_Destructor d) {
   HttpSessionAttribute_constructor(this, name, d); }
inline HttpSession* HttpSessionAttribute::getSession() {
   return HttpSessionAttribute_getSession(this); }
 
#endif
 
typedef struct HttpSession
{
#ifdef __cplusplus
 
      void *operator new(size_t s) { return ::baMalloc(s); }
      void operator delete(void* d) { if(d) ::baFree(d); }
      void *operator new(size_t, void *place) { return place; }
      void operator delete(void*, void *) { }
 
      void terminate();
 
      HttpSessionAttribute* getAttribute(const char* name);
 
      BaTime getCreationTime();
 
      BaTime getLastAccessedTime();
 
      BaTime getMaxInactiveInterval();
 
      HttpServer* getServer();
 
      int removeAttribute(const char* name);
 
      int setAttribute(HttpSessionAttribute* value);
 
      void setMaxInactiveInterval(BaTime interval);
 
      void incrRefCntr();
 
      void decrRefCntr();
 
      U32 getId();
 
      AuthenticatedUser* getAuthenticatedUser();
 
      U32 getUseCounter();
 
 
      void incrementLock();
      void decrementLock();
 
      HttpSession() {}
   private:
#endif
      SplayTreeNode super; /* inherits from SplayTreeNode */
      DoubleLink dlink;
      HttpSockaddr peer;
      HttpSessionAttribute* attrList;
      struct HttpSessionContainer* container;
      BaTime creationTime;
      BaTime lastAccessedTime;
      BaTime maxInactiveInterval;
      U32 sesrnd1; /* Session random number 1 & 2 */
      U32 sesrnd2; /* entropy id+sesrnd1+sesrnd2=96 bits */
      U32 useCounter;
      int refCounter;
      U16 lockCounter;
      U8 termPending; /* TRUE if in termination list */
} HttpSession;
 
 
#ifdef __cplusplus
extern "C" {
#endif
BA_API HttpSessionAttribute* HttpSession_getAttribute(HttpSession* o,
                                                      const char* name);
BA_API BaTime HttpSession_getCreationTime(HttpSession* o);
BA_API BaTime HttpSession_getLastAccessedTime(HttpSession* o);
BA_API BaTime HttpSession_getMaxInactiveInterval(HttpSession* o);
BA_API struct HttpServer* HttpSession_getServer(HttpSession* o);
BA_API void HttpSession_terminate(HttpSession* o);
BA_API BaBool HttpSession_isNew(HttpSession* o);
BA_API int HttpSession_removeAttribute(HttpSession* o, const char* name);
BA_API int HttpSession_setAttribute(HttpSession* o,
                                    HttpSessionAttribute* value);
BA_API void HttpSession_setMaxInactiveInterval(HttpSession* o,BaTime interval);
#define HttpSession_incrRefCntr(o) (o)->refCounter++
BA_API void HttpSession_decrRefCntr(HttpSession* o);
#define HttpSession_incrementLock(o) (o)->lockCounter++
#define HttpSession_decrementLock(o) do {\
      baAssert((o)->lockCounter > 0);\
      (o)->lockCounter--; } while(0)
BA_API int HttpSession_fmtSessionId(HttpSession* o, U8* buf, size_t bufSize);
#define HttpSession_getId(o) \
   ((U32)((ptrdiff_t)SplayTreeNode_getKey((SplayTreeNode*)(o))))
#define HttpSession_getAuthenticatedUser(o) AuthenticatedUser_get2((o))
#define HttpSession_getUseCounter(o) (o)->useCounter
#define HttpSession_getPeerName(o) (&(o)->peer)
#ifdef __cplusplus
}
inline HttpSessionAttribute* HttpSession::getAttribute(const char* name) {
   return HttpSession_getAttribute(this, name); }
inline BaTime HttpSession::getCreationTime() {
   return HttpSession_getCreationTime(this); }
inline BaTime HttpSession::getLastAccessedTime() {
   return HttpSession_getLastAccessedTime(this); }
inline BaTime HttpSession::getMaxInactiveInterval() {
   return HttpSession_getMaxInactiveInterval(this); }
inline HttpServer* HttpSession::getServer() {
   return HttpSession_getServer(this); }
inline void HttpSession::terminate() {
   HttpSession_terminate(this); }
inline int HttpSession::removeAttribute(const char* name) {
   return HttpSession_removeAttribute(this, name); }
inline int HttpSession::setAttribute(HttpSessionAttribute* value) {
   return HttpSession_setAttribute(this, value); }
inline void HttpSession::setMaxInactiveInterval(BaTime interval) {
   HttpSession_setMaxInactiveInterval(this, interval); }
inline void HttpSession::incrRefCntr() {
   HttpSession_incrRefCntr(this); }
inline void HttpSession::decrRefCntr() {
   HttpSession_decrRefCntr(this); }
inline U32 HttpSession::getId() { return HttpSession_getId(this); }
inline U32 HttpSession::getUseCounter() {
   return HttpSession_getUseCounter(this); }
inline AuthenticatedUser* HttpSession::getAuthenticatedUser() {
   return HttpSession_getAuthenticatedUser(this); }
inline void HttpSession::incrementLock() {HttpSession_incrementLock(this);}
inline void HttpSession::decrementLock() {HttpSession_decrementLock(this);}
 
#endif /* __cplusplus */
 
typedef enum {
   HttpSessionContainer_OK = 0,
   HttpSessionContainer_NoMemory,
   HttpSessionContainer_TooManySessions,
   HttpSessionContainer_NoPeerAddress,
   HttpSessionContainer_RandomFailure 
} HttpSessionContainer_ECode;
 
 
typedef struct HttpSessionContainer
{
#ifdef __cplusplus
      HttpSessionContainer() {}
      void setMaxSessions(int max);
   private:
#endif
      SplayTree sessionTree;
      DoubleList sessionList;
      DoubleList sessionTermList;
      DoubleLink* sessionLinkIter;
      struct HttpServer* server;
      int noOfSessions; /* Current number of active sessions */
      int maxSessions;
      HttpSessionContainer_ECode eCode;
} HttpSessionContainer;
 
#ifdef __cplusplus
extern "C" {
#endif
void HttpSessionContainer_constructor(struct HttpSessionContainer* o,
                                      struct HttpServer* server,
                                      U16 maxSessions);
void HttpSessionContainer_destructor(struct HttpSessionContainer* o);
void HttpSessionContainer_sessionTimer(struct HttpSessionContainer* o);
#define HttpSessionContainer_setMaxSessions(o,max) (o)->maxSessions = max
#ifdef __cplusplus
}
inline void HttpSessionContainer::setMaxSessions(int max) {
   HttpSessionContainer_setMaxSessions(this, max); }
#endif
 
 
 
typedef void (*HttpPage_Service)(struct HttpPage* page,
                                 HttpRequest* request,
                                 HttpResponse* response);
 
 
#define HttpPageType_HttpPageSE                0x00020
 
#ifndef __DOXYGEN__
typedef struct HttpPageNode
{
      struct HttpPageNode* next;
} HttpPageNode;
#endif
 
typedef struct HttpPage
{
#ifdef __cplusplus
      void *operator new(size_t s) { return ::baMalloc(s); }
      void operator delete(void* d) { if(d) ::baFree(d); }
      void *operator new(size_t, void *place) { return place; }
      void operator delete(void*, void *) { }
      HttpPage() {}
      HttpPage(HttpPage_Service service, const char* name);
 
      ~HttpPage();
 
      const char* getName() const { return name; }
 
      void service(HttpRequest* request, HttpResponse* response);
 
      bool isLinked();
 
      int unlink();
#endif
      HttpPageNode super; /* As if inherited */
      HttpPage_Service serviceCB;
      const char* name;
} HttpPage;
 
#ifdef __cplusplus
extern "C" {
#endif
void
BA_API HttpPage_constructor(
   HttpPage* o, HttpPage_Service service, const char* name);
BA_API void HttpPage_destructor(HttpPage* o);
#define HttpPage_getName(o) (o)->name
#define HttpPage_isLinked(o) ((HttpPageNode*)(o))->next
BA_API int HttpPage_unlink(HttpPage* o);
#define HttpPage_service(o, request, response) \
  (o)->serviceCB(o, request, response)
#ifdef __cplusplus
}
inline HttpPage::HttpPage(HttpPage_Service service, const char* name) {
   HttpPage_constructor(this, service, name); }
inline HttpPage::~HttpPage() {
   HttpPage_destructor(this); }
inline bool HttpPage::isLinked() {
   return HttpPage_isLinked(this) ? true : false;
}
inline int HttpPage::unlink() {return HttpPage_unlink(this); }
inline void HttpPage::service(HttpRequest* request, HttpResponse* response) {
   HttpPage_service(this, request, response);
}
#endif
 
 
typedef int (*HttpDir_Service)(struct HttpDir* o,
                               const char* relPath,
                               HttpCommand* cmd);
 
#define HttpDirType_EhDir                    0x00001
#define HttpDirType_HttpResRdr               0x00002
#define HttpDirType_AuthenticateDir          0x00008
#define HttpDirType_AuthenticateDirWrapper   0x00010
 
 
typedef struct HttpDir
{
#ifdef __cplusplus
      void *operator new(size_t s) { return ::baMalloc(s); }
      void operator delete(void* d) { if(d) ::baFree(d); }
      void *operator new(size_t, void *place) { return place; }
      void operator delete(void*, void *) { }
      HttpDir();
 
      HttpDir(const char* name, S8 priority=0);
      ~HttpDir();
 
      int insertDir(HttpDir* dir);
 
      int insertPage(HttpPage* page);
 
      HttpPage* getFirstPage();
 
      HttpDir* getFirstDir();
 
      HttpDir* getDir(const char* name);
 
      HttpPage* getPage(const char* name);
 
      HttpDir* getNext();
 
      HttpPage* findPage(HttpPage* iter, const char* name);
 
      static HttpDir* findDir(HttpDir* iter, const char* name,
                              unsigned int nameLen);
 
      HttpDir* createOrGet(const char* name);
 
      const char* getName() const { return name; }
 
      HttpDir* getParent() const { return parent; }
 
      char* makeAbsPath(const char* relPath, int relPathLen);
 
      char* getRootPath();
 
 
      HttpDir_Service setService(HttpDir_Service s);
 
      void p403(const char* p403);
 
      bool isLinked();
 
      int unlink();
 
      void setAuthenticator(
         struct AuthenticatorIntf* authenticator,
         struct AuthorizerIntf* authorizer=0);
 
      bool authenticateAndAuthorize(HttpCommand* cmd,const char* path);
 
 
#endif
      HttpDir_Service service;
      struct HttpDir* parent;      /* owner */
      struct HttpDir* next;        /* next sibling */
      const char* name;            /* e.g. /mydir/ */
      struct HttpDir* dirList;     /* list of httpdirs (children) */
      struct AuthorizerIntf* realm;  /* If we have authorization */
      struct AuthenticatorIntf* authenticator; /* If we have authentic. */
      char* _p403;          /* If we have a 403 denied response page. */
      HttpPageNode pageList;     /* pages for this dir */
      /* U8 type; */
      S8 priority;
} HttpDir;
 
#ifdef __cplusplus
extern "C" {
#endif
BA_API void HttpDir_constructor(HttpDir* o, const char* name, S8 priority);
BA_API void HttpDir_destructor(HttpDir* o);
BA_API char* HttpDir_makeAbsPath(
   HttpDir* o, const char* relPath, int relPathLen);
#define HttpDir_getRootPath(o) HttpDir_makeAbsPath(o,"",0)
BA_API int HttpDir_insertDir(HttpDir* o, HttpDir* dir);
#define HttpDir_getFirstPage(o) \
   (o)->pageList.next != &(o)->pageList ? ((HttpPage*)(o)->pageList.next) : 0
#define HttpDir_getFirstDir(o) (o)->dirList
BA_API HttpDir* HttpDir_getDir(HttpDir* o, const char* name);
BA_API HttpPage* HttpDir_getPage(HttpDir* o, const char* name);
#define HttpDir_getNext(o) (o)->next
#define HttpDir_getName(o) (o)->name
#define HttpDir_getParent(o) (o)->parent
BA_API int HttpDir_insertPage(HttpDir* o, HttpPage* page);
BA_API HttpPage* HttpDir_findPage(
   HttpDir* o, HttpPage* iter, const char* name);
BA_API HttpDir* HttpDir_findDir(
   HttpDir* iter, const char* name,unsigned int nameLen);
BA_API HttpDir* HttpDir_createOrGet(HttpDir* o, const char* name);
BA_API void HttpDir_p403(HttpDir* o, const char* p403);
#define HttpDir_overloadService HttpDir_setService
BA_API HttpDir_Service HttpDir_setService(HttpDir*o, HttpDir_Service s);
#define HttpDir_isLinked(o) (o)->parent
BA_API int HttpDir_unlink(HttpDir* o);
#define HttpDir_setAuthenticator(o,authenticatorMA,authorizerMA) \
   (o)->authenticator = authenticatorMA,(o)->realm = authorizerMA
BA_API int HttpDir_authenticateAndAuthorize(
   HttpDir* o,HttpCommand* cmd,const char* path);
#define HttpDir_isAuthorized(o,user,method,path) \
  ((o)->realm ? \
  (user ? AuthorizerIntf_authorize((o)->realm,user,method,path) : FALSE) : \
  TRUE)
#ifdef __cplusplus
}
inline HttpDir::HttpDir() {
   HttpDir_constructor(this, 0, 0); }
inline HttpDir::HttpDir(const char* name, S8 priority) {
   HttpDir_constructor(this, name, priority); }
inline HttpDir::~HttpDir() {
   HttpDir_destructor(this); }
inline char* HttpDir::makeAbsPath(const char* relPath, int relPathLen) {
   return HttpDir_makeAbsPath(this, relPath, relPathLen); }
inline char* HttpDir::getRootPath() {
   return HttpDir_getRootPath(this); }
inline int HttpDir::insertDir(HttpDir* dir) {
   return HttpDir_insertDir(this, dir); }
inline int HttpDir::insertPage(HttpPage* page) {
   return HttpDir_insertPage(this, page); }
inline HttpPage* HttpDir::getFirstPage() { return HttpDir_getFirstPage(this); }
inline HttpDir* HttpDir::getFirstDir() { return HttpDir_getFirstDir(this); }
inline HttpDir* HttpDir::getDir(const char* name) {
   return HttpDir_getDir(this,name); }
inline HttpPage* HttpDir::getPage(const char* name) {
   return HttpDir_getPage(this,name); }
inline HttpDir* HttpDir::getNext() { return HttpDir_getNext(this); }
inline HttpPage* HttpDir::findPage(HttpPage* iter, const char* name) {
   return HttpDir_findPage(this, iter, name); }
inline HttpDir* HttpDir::findDir(HttpDir* iter, const char* name,
                                        unsigned int nameLen) {
   return HttpDir_findDir(iter, name, nameLen); }
inline HttpDir* HttpDir::createOrGet(const char* name) {
   return HttpDir_createOrGet(this, name); }
inline HttpDir_Service HttpDir::setService(HttpDir_Service s) {
   return HttpDir_setService(this, s); }
inline void HttpDir::p403(const char* p403) {
   HttpDir_p403(this, p403); }
inline int HttpDir::unlink() {return HttpDir_unlink(this); }
inline bool HttpDir::isLinked() {
   return HttpDir_isLinked(this) ? true : false; }
inline void HttpDir::setAuthenticator(struct AuthenticatorIntf* authenticator,
                                      struct AuthorizerIntf* authorizer){
   HttpDir_setAuthenticator(this,authenticator,authorizer);
}
inline bool HttpDir::authenticateAndAuthorize(
   HttpCommand* cmd, const char* path) {
   return HttpDir_authenticateAndAuthorize(this,cmd,path) ? true : false; }
#endif
 
#ifndef __DOXYGEN__
 
typedef struct HttpLinkCon
{
      HttpConnection con; /* Inherits from HttpConnection */
      DoubleLink link;
} HttpLinkCon;
 
 
typedef struct
{
      HttpDir super; /* inherit */
      HttpDir_Service superServiceFunc;
      char* page404;
      BaBool page404InProgress;
} HttpRootDir;
 
#endif
 
typedef struct HttpServerConfig
{
#ifdef __cplusplus
      HttpServerConfig();
 
      int setRequest(S16 min, S16 max);
 
      int setResponseHeader(U16 min, U16 max);
 
      int setResponseData(U16 size);
 
      int setCommit(U16 size);
 
      int setNoOfHttpCommands(U16 size);
 
      int setNoOfHttpConnections(U16 size);
 
      int setMaxSessions(U16 size);
#endif
      S16 minRequest;
      S16 maxRequest;
      U16 minResponseHeader;
      U16 maxResponseHeader;
      U16 commit;
      U16 responseData;
      U16 noOfHttpCommands;
      U16 noOfHttpConnections;
      U16 maxSessions;
} HttpServerConfig;
 
#ifdef __cplusplus
extern "C" {
#endif
BA_API void HttpServerConfig_constructor(HttpServerConfig* o);
BA_API int HttpServerConfig_setRequest(HttpServerConfig* o, S16 min, S16 max);
BA_API int HttpServerConfig_setResponseHeader(
   HttpServerConfig* o, U16 min, U16 max);
BA_API int HttpServerConfig_setResponseData(HttpServerConfig* o, U16 size);
BA_API int HttpServerConfig_setCommit(HttpServerConfig* o, U16 size);
BA_API int HttpServerConfig_setNoOfHttpCommands(HttpServerConfig* o, U16 size);
BA_API int HttpServerConfig_setNoOfHttpConnections(
   HttpServerConfig* o, U16 size);
BA_API int HttpServerConfig_setMaxSessions(HttpServerConfig* o, U16 size);
#ifdef __cplusplus
}
inline HttpServerConfig::HttpServerConfig() {
   HttpServerConfig_constructor(this); }
inline int HttpServerConfig::setRequest(S16 min, S16 max) {
   return HttpServerConfig_setRequest(this, min, max); }
inline int HttpServerConfig::setResponseHeader(U16 min, U16 max) {
   return HttpServerConfig_setResponseHeader(this, min, max); }
inline int HttpServerConfig::setResponseData(U16 size) {
   return HttpServerConfig_setResponseData(this, size); }
inline int HttpServerConfig::setCommit(U16 size) {
   return HttpServerConfig_setCommit(this, size); }
inline int HttpServerConfig::setNoOfHttpCommands(U16 size) {
   return HttpServerConfig_setNoOfHttpCommands(this, size); }
inline int HttpServerConfig::setNoOfHttpConnections(U16 size) {
   return HttpServerConfig_setNoOfHttpConnections(this, size); }
inline int HttpServerConfig::setMaxSessions(U16 size) {
   return HttpServerConfig_setMaxSessions(this, size); }
 
#endif
 
 
typedef DoubleList HttpLinkConList;
 
/* Used by LSP plugin */
typedef void (*LspOnTerminateRequest)(struct LHttpCommand* lcmd);
 
typedef struct HttpServer
{
#ifdef __cplusplus
      void *operator new(size_t s) { return ::baMalloc(s); }
      void operator delete(void* d) { if(d) ::baFree(d); }
      void *operator new(size_t, void *place) { return place; }
      void operator delete(void*, void *) { }
      HttpServer(SoDisp* dispatcher, HttpServerConfig* cfg=0);
 
      ~HttpServer();
 
      int insertRootDir(HttpDir* dir);
 
      int insertDir(const char* virtualDirRootPath, HttpDir* dir);
 
      int insertCSP(CspInit cspInit,
                    const char* virtualDirRootPath,
                    struct CspReader* reader);
 
      struct AuthUserList* getAuthUserList(const char* name);
 
      ThreadMutex* getMutex();
 
      SoDisp* getDispatcher();
 
      HttpDir* getFirstRootDir();
 
      HttpSessionContainer* getSessionContainer();
 
      HttpSession* getSession(U32 id);
 
      void set404Page(const char* page404);
 
      const char* get404Page();
 
      int setUserObj(void* userObj, bool overwrite=false);
 
      static void initStatic(void);
 
      static void setErrHnd(UserDefinedErrHandler e);
 
      /* No longer used */
      static int setZlib(ZlibInflateInit2 init,
                         ZlibInflate inflate,
                         ZlibInflateEnd end){
                            (void)init; (void)inflate; (void)end;
                            return 0;                         }
      static const char* getStatusCode(int code);
 
 
#endif
      DoubleList commandPool;
      DoubleList cmdReqList;
      HttpConnection noOpCon;
      HttpLinkConList freeList;
      HttpLinkConList readyList;
      HttpLinkConList connectedList;
      HttpRootDir rootDirContainer;
      SplayTree authUserTree; /* Used by AuthenticatedUser.c */
      struct HttpCmdThreadPoolIntf* threadPoolIntf;
      HttpLinkCon* connections;
      SoDisp* dispatcher;
      void* userObj;
      SingleList waitForConClose; /* Bounded WaitForConClose list, oldest first. */
      LspOnTerminateRequest lspOnTerminateRequest;
      int commandPoolSize;
      U16 noOfConnections;
      S16 maxHttpRequestLen;
      HttpSessionContainer sessionContainer;
} HttpServer;
 
 
/* Used exclusively by HttpCmdThreadPool */
void HttpServer_AsynchProcessDir(HttpServer* o,
                                 HttpDir* dir,
                                 HttpCommand* cmd);
/* Used exclusively by HttpCmdThreadPool */
#define HttpServer_setThreadPoolIntf(o, intf) (o)->threadPoolIntf=intf
#define HttpServer_luaenv(o) (o)->luaenv
 
#ifdef __cplusplus
extern "C" {
#endif
BA_API void HttpServer_constructor(HttpServer*,SoDisp*, HttpServerConfig*);
BA_API void HttpServer_destructor(HttpServer* o);
BA_API int HttpServer_insertRootDir(HttpServer* o, HttpDir* dir);
BA_API int HttpServer_insertDir(HttpServer* o,
                                const char* virtualDirRootPath,
                                HttpDir* dir);
BA_API int HttpServer_insertCSP(HttpServer* o,
                                CspInit cspInit,
                                const char* virtualDirRootPath,
                                struct CspReader* reader);
#define HttpServer_getAuthUserList(o, name) \
   (AuthUserList*)SplayTree_find(&(o)->authUserTree, name)
#define HttpServer_getDispatcher(o) (o)->dispatcher
#define HttpServer_getFirstRootDir(o) \
     HttpDir_getFirstDir((HttpDir*)&(o)->rootDirContainer)
#define HttpServer_getUserObj(o) (o)->userObj
#define HttpServer_getSessionContainer(o) (&(o)->sessionContainer)
#define HttpServer_getMutex(o) SoDisp_getMutex((o)->dispatcher)
BA_API const char* HttpServer_getStatusCode(int code);
void HttpServer_addCon2ConnectedList(HttpServer* o, HttpConnection* con);
void HttpServer_doLingeringClose(
   HttpServer* o, HttpConnection* con, BaFileSize contLen);
 
BA_API HttpSession* HttpServer_getSession(HttpServer* o, U32 id);
BA_API HttpConnection* HttpServer_getFreeCon(HttpServer* o);
void HttpServer_returnFreeCon(HttpServer* o, HttpConnection* con);
BA_API void HttpServer_installNewCon(HttpServer* o, HttpConnection* con);
BA_API void HttpServer_setErrHnd(UserDefinedErrHandler e);
void HttpServer_initStatic(void);
int HttpServer_termOldestIdleCon(HttpServer* o);
BA_API void HttpServer_set404Page(HttpServer*o, const char* page404);
#define HttpServer_get404Page(o) (o)->rootDirContainer.page404
BA_API int HttpServer_setUserObj(
   HttpServer* o, void* userObj, BaBool overwrite);
#define HttpServer_termAllSessions(o) \
   HttpSessionContainer_destructor(&(o)->sessionContainer)
/* No longer used */
#define HttpServer_setZlib(init,inflate,end);
#ifdef __cplusplus
}
inline HttpServer::HttpServer(SoDisp* disp, HttpServerConfig* cfg){
   HttpServer_constructor(this, disp, cfg); }
inline HttpServer::~HttpServer()  {
   HttpServer_destructor(this); }
inline int HttpServer::insertRootDir(HttpDir* dir) {
   return HttpServer_insertRootDir(this, dir); }
inline ThreadMutex* HttpServer::getMutex() {
   return HttpServer_getMutex(this);
}
inline int HttpServer::insertDir(const char* virtualDirRootPath,HttpDir* dir){
   return HttpServer_insertDir(this, virtualDirRootPath, dir); }
inline int HttpServer::insertCSP(CspInit cspInit,
                                 const char* virtualDirRootPath,
                                 struct CspReader* reader) {
   return HttpServer_insertCSP(this, cspInit, virtualDirRootPath, reader); }
inline struct AuthUserList* HttpServer::getAuthUserList(const char* name) {
   return HttpServer_getAuthUserList(this,name); }
inline SoDisp* HttpServer::getDispatcher() {
   return HttpServer_getDispatcher(this); }
inline HttpDir* HttpServer::getFirstRootDir() {
   return HttpServer_getFirstRootDir(this); }
inline HttpSessionContainer* HttpServer::getSessionContainer() {
   return HttpServer_getSessionContainer(this); }
inline HttpSession* HttpServer::getSession(U32 id) {
   return HttpServer_getSession(this, id); }
inline void HttpServer::initStatic(void) {
   HttpServer_initStatic(); }
inline void HttpServer::setErrHnd(UserDefinedErrHandler e) {
   HttpServer_setErrHnd(e); }
inline void HttpServer::set404Page(const char* page404) {
   HttpServer_set404Page(this, page404); }
inline const char* HttpServer::get404Page() {
   return HttpServer_get404Page(this); }
inline int HttpServer::setUserObj(void* userObj, bool overwrite) {
   return HttpServer_setUserObj(this, userObj, overwrite); }
inline const char* HttpServer::getStatusCode(int code) {
   return HttpServer_getStatusCode(code);
}
 
 
inline HttpResponse* HttpRequest::getResponse() {
   return HttpRequest_getResponse(this); }
inline HttpConnection* HttpRequest::getConnection() {
   return HttpRequest_getConnection(this); }
inline HttpRequest* HttpResponse::getRequest() {
   return HttpResponse_getRequest(this); }
inline HttpCommand* HttpResponse::getCommand() {
   return HttpResponse_getCommand(this); }
inline HttpCommand* HttpRequest::getCommand() {
   return HttpRequest_getCommand(this); }
inline struct HttpServer* HttpConnection::getServer() {
   return HttpConnection_getServer(this); }
 
#endif /* __cplusplus */
 /* end of StdWebServer */
 
/* Internal use */
#if !BA_ENABLE_SHARKSSL || SHARKSSL_PSA_CONSUMER
 
#define SHARKSSL_MD5_HASH_LEN       16
 
typedef struct SharkSslMd5Ctx
{
   U32 total[2];
   U32 state[4];
   U8  buffer[64];
} SharkSslMd5Ctx;
 
SHARKSSL_API void  SharkSslMd5Ctx_constructor(SharkSslMd5Ctx* ctx);
SHARKSSL_API void  SharkSslMd5Ctx_append(SharkSslMd5Ctx* ctx, const U8* data, U32 len);
SHARKSSL_API void  SharkSslMd5Ctx_finish(SharkSslMd5Ctx* ctx, U8 digest[SHARKSSL_MD5_HASH_LEN]);
SHARKSSL_API int   sharkssl_md5(const U8*, U16, U8*); 
#endif
 
#if !BA_ENABLE_SHARKSSL || SHARKSSL_PSA_CONSUMER
#define SHARKSSL_SHA1_HASH_LEN      20
 
typedef struct SharkSslSha1Ctx
{
   U32 total[2];
   U32 state[5];
   U8  buffer[64];
} SharkSslSha1Ctx;
 
SHARKSSL_API void  SharkSslSha1Ctx_constructor(SharkSslSha1Ctx* ctx);
SHARKSSL_API void  SharkSslSha1Ctx_append(SharkSslSha1Ctx* ctx, const U8* data, U32 len);
SHARKSSL_API void  SharkSslSha1Ctx_finish(SharkSslSha1Ctx*, U8 digest[SHARKSSL_SHA1_HASH_LEN]);
#if SHARKSSL_PSA_CONSUMER
SHARKSSL_API int sharkssl_sha1(const U8* data, U32 len, U8* digest);
#endif
#if !BA_ENABLE_SHARKSSL
typedef void SharkSsl;
#endif
#endif
 
#endif /* __httpServer_h */