ehs.h

/* $Id: ehs.h 121 2012-04-05 22:39:22Z felfert $
 *
 * EHS is a library for embedding HTTP(S) support into a C++ application
 *
 * Copyright (C) 2004 Zachary J. Hansen
 *
 * Code cleanup, new features and bugfixes: Copyright (C) 2010 Fritz Elfert
 *
 *    This library is free software; you can redistribute it and/or
 *    modify it under the terms of the GNU Lesser General Public
 *    License version 2.1 as published by the Free Software Foundation;
 *
 *    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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 *    This can be found in the 'COPYING' file.
 *
 */

#ifndef EHS_H
#define EHS_H

// Pragma'ing away nasty MS 255-char-name problem.  Otherwise
// you will get warnings on many template names that
//  "identifier was truncated to '255' characters in the debug information".
#ifdef _MSC_VER
# pragma warning(disable : 4786)
#endif

// EHS headers

#include <formvalue.h>
#include <ehstypes.h>
#include <datum.h>
#include <httpresponse.h>
#include <httprequest.h>

#include <memory>
#include <string>

extern "C" {
    const char * getEHSconfig();
}

class RawSocketHandler {
    public:
        virtual bool OnData(EHSConnection *conn, std::string data) = 0;

        virtual void OnConnect(EHSConnection *conn) = 0;

        virtual void OnDisconnect(EHSConnection *conn) = 0;

        virtual ~RawSocketHandler ( ) { }
};

class PrivilegedBindHelper {

    public:

        virtual bool BindPrivilegedPort(int socket, const char *addr, const unsigned short port) = 0;

        virtual ~PrivilegedBindHelper ( ) { }

};

class PassphraseHandler {

    public:

        virtual const std::string GetPassphrase(bool twice) = 0;

        virtual ~PassphraseHandler ( ) { }
};

#define MAX_REQUEST_SIZE_DEFAULT (256 * 1024)

class EHS : public PassphraseHandler {

    private:
        EHS(const EHS &);

        EHS & operator=(const EHS &);

    protected:

        EHSMap m_oEHSMap;

        EHS *m_poParent; 

        std::string m_sRegisteredAs;

        EHSServer *m_poEHSServer;

        EHS *m_poSourceEHS;

        PrivilegedBindHelper *m_poBindHelper;

        RawSocketHandler *m_poRawSocketHandler;

        bool m_bNoRouting;

    public:

        EHS(EHS *parent = NULL, std::string registerpath = "");

        virtual ~EHS ();

        virtual const std::string GetPassphrase(bool twice);

        void RegisterEHS(EHS *child, const char *uripath);

        void UnregisterEHS (const char *uripath);

        ehs_autoptr<HttpResponse> RouteRequest(HttpRequest *request);

        virtual ResponseCode HandleRequest(HttpRequest *request, HttpResponse *response);

        void SetSourceEHS (EHS & source);

        EHSServerParameters m_oParams;

        void StartServer(EHSServerParameters &params);

        void StopServer();

        void HandleData(int timeout = 0);

        virtual bool ThreadInitHandler();

        virtual void ThreadExitHandler();

        virtual HttpResponse *HandleThreadException(ehs_threadid_t tid, HttpRequest *request, std::exception & ex);

        bool ShouldTerminate() const;

        void SetBindHelper(PrivilegedBindHelper *helper)
        {
            m_poBindHelper = helper;
        }

        PrivilegedBindHelper * GetBindHelper() const
        {
            return m_poBindHelper;
        }

        void SetRawSocketHandler(RawSocketHandler *helper)
        {
            m_poRawSocketHandler = helper;
        }

        RawSocketHandler * GetRawSocketHandler() const
        {
            return m_poRawSocketHandler;
        }

        void AddResponse(ehs_autoptr<GenericResponse> ehs_rvref response);
};

#endif // EHS_H