---

abstract_application.hh

/*
*  Name:      abstract_application.hh
*  Author:    Angel Jimenez Jimenez
*             Rafael Jesus Alcantara Perez
*  Summary:   CGI base application
*  Date:      $Date: 2003/10/06 12:45:11 $
*  Revision:  $Revision: 1.1 $
*
*  Copyright (C) 1994-2003  Rafael Jesus Alcantara Perez <rafa@dedalo-ing.com>
*
*  This program is free software; you can redistribute it and/or modify
*  it under the terms of the GNU General Public License as published by
*  the Free Software Foundation; either version 2 of the License, or
*  (at your option) any later version.
*
*  This program 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 General Public License for more details.
*
*  You should have received a copy of the GNU General Public License
*  along with this program; if not, write to the Free Software
*  Foundation, Inc., 59 Temple Place, Suite 330, Boston,
*  MA 02111-1307, USA.
*/

#ifndef _MPCL_NET_CGI_ABSTRACT_APPLICATION__
#define _MPCL_NET_CGI_ABSTRACT_APPLICATION__

#include <iostream>
#include "../../abstract_application.hh"
#include "../../memory/smart_pointer.hh"
#include "../../text/html/base_page.hh"
#include "../../text/html/form.hh"
#include "../../text/string.hh"
#include "../../util/collection/map.hh"
#include "config_processor.hh"
#include "cookie.hh"
#include "session.hh"


namespace mpcl
{

  namespace net
  {

    namespace cgi
    {

      using text::html::QKTBasePage;
      using text::html::QTBasePage;
      using text::html::TForm;

      class TAbstractApplication : public mpcl::TAbstractApplication
      {

        private:

          bool gIsRedirected;

          TForm*   ptSourceForm;

          QTBasePage   qtSourcePage;

          QTBasePage   qtTargetPage;

          TString   yTargetUrl;


        protected:

          std::basic_ostream<char>*   ptTargetOstream;

          TConfigProcessor   tConfigProcessor;

          TSession<TCookie>   tSession;


        private:

          //
          //  C O N S T R U C T O R S
          //

          void buildSourcePage (void);


        public:

          //
          //  C O N S T R U C T O R S
          //

          TAbstractApplication ( const char*  pkcNAME          ,
                                 const char*  pkcRELEASE       ,
                                 int          iPARAMETER_COUNT ,
                                 const char** ppkcPARAMETERS   )  :
            mpcl::TAbstractApplication (pkcNAME, pkcRELEASE)      ,
            gIsRedirected      (false)                            ,
            ptSourceForm       (NULL)                             ,
            qtSourcePage       ()                                 ,
            qtTargetPage       ()                                 ,
            yTargetUrl         ()                                 ,
            ptTargetOstream    (&std::cout)                       ,
            tConfigProcessor   (iPARAMETER_COUNT, ppkcPARAMETERS) ,
            tSession           ()
          {
            TString                           yHttpCookieValue;
            std::basic_istringstream<char>*   ptIstrstream;

            //
            //  Loads cookies from HTTP environment variable.
            //
            yHttpCookieValue = tConfigProcessor.environmentValue ("HTTP_COOKIE");
            ptIstrstream     = new std::basic_istringstream<char> (yHttpCookieValue.c_str());
            *ptIstrstream >> tSession;
            delete ptIstrstream;
          }

          virtual QTBasePage buildPage (const TString& rkyPAGE_IDENTIFIER) = 0;

          void initialize (void) = 0;

          virtual void processRequest (void) = 0;

          void redirect (const TString& rkyTARGET_URL)
          {
            gIsRedirected = true;
            yTargetUrl    = rkyTARGET_URL;
          }

          void setOutput (std::basic_ostream<char>& rtTARGET_OSTREAM)
          {
            ptTargetOstream = &rtTARGET_OSTREAM;
          }

          void setResponse (const QTBasePage& rkqtTARGET_PAGE)
          {
            gIsRedirected = false;
            qtTargetPage  = rkqtTARGET_PAGE;
          }

          int start (void)
          {
            buildSourcePage();
            processRequest();
            writeResponse();
            return 0;
          }


        private:

          //
          //  S E L E C T O R S
          //

          void writeResponse (void) const;


        protected:

          bool hasSourcePage (void) const
          {
            return !qtSourcePage.isNull();
          }


        public:

          //
          //  S E L E C T O R S
          //

          QKTBasePage getSourcePage (void) const
          {
            return QKTBasePage (qtSourcePage);
          }

          const TForm& getSourceForm (void) const
          {
            if ( !ptSourceForm )
            {
              throw TConstraintException ("form is null", __FILE__, __LINE__);
            }
            return *ptSourceForm;
          }

          QTBasePage getResponsePage (void) const
          {
            return qtTargetPage;
          }

          TString fullName (void) const
          {
            return tConfigProcessor.environmentValue ("SCRIPT_NAME");
          }

          TString programFileName (void) const
          {
            return tConfigProcessor.programFileName();
          }

      };  // class TAbstractApplication

    }  // namespace cgi

  }  // namespace net

}  // namespace mpcl


#endif  // not _MPCL_NET_CGI_ABSTRACT_APPLICATION__

---