webx_App.hpp

浏览该文件的文档.

#pragma once

struct AppServerExternalData;

namespace eienwebx
{

class SessionServer;
class Request;
class Response;

class EIENWEBX_DLL App
{
public:
    enum ErrorCode
    {
        Err_Success,            
        Err_DoFileNotFound,     
        Err_WebMainNotFound,    
        Err_InfiniteRecursion,  
    };

    App();

    App( winux::ConfigureSettings const & settings, AppServerExternalData * externalData );

    virtual ~App();

    bool init( winux::ConfigureSettings const & settings, AppServerExternalData * externalData );

    virtual int run( void * runParam );

    int loadedDoFiles( winux::Mixed * arrDoFiles ) const;

    bool unloadDoFile( winux::String const & doFullPath );

    winux::DllLoader & loadModule( winux::String const & modFullPath );

    int loadedModules( winux::Mixed * arrModules ) const;

    bool unloadModule( winux::String const & modFullPath );

    App & loadEnv();

    winux::String dumpEnv() const;

    virtual ErrorCode execWebMain( winux::String const & doFullPath, Response * rsp, void * runParam, int * retCode );

    ErrorCode importDoFile( winux::String const & doFullPath, Response * rsp, void * runParam, int * retCode, winux::String * errDetail );

    // attributes ---------------------------------------------------------------------------
    void * getParam() const { return _param; };

    template < typename _Ty >
    _Ty getParam() const { return reinterpret_cast<_Ty>(_param); };

    void setParam( void * param ) { this->_param = param; }

    void * getRunParam() const { return _runParam; };

    template < typename _Ty >
    _Ty getRunParam() const { return reinterpret_cast<_Ty>(_runParam); };

    AppServerExternalData * getExternalData() { return _externalData; }

    void setExternalData( AppServerExternalData * data ) { _externalData = data; }

    SessionServer * getSessServ() { return _sessServ; }

    void setSessServ( SessionServer * sessServ ) { this->_sessServ = sessServ; }

public:
    winux::ConfigureSettings settings;

    struct AppConfig
    {
        bool isProduction;
        winux::int64 maxUrlencodedPostSize;
        winux::int64 maxMultiFormPostSize;
        winux::String uploadTmpPath;
        winux::String outputTplPath;

        AppConfig() : isProduction(false), maxUrlencodedPostSize(0), maxMultiFormPostSize(0)
        {
        }

    } appConfig;

    winux::StringStringMap environVars;

protected:
    void _clearModules();

    ErrorCode _importDoFileDevelopment( winux::String const & doFullPath, Response * rsp, void * runParam, int * retCode, winux::String * errDetail );
    ErrorCode _importDoFileProduction( winux::String const & doFullPath, Response * rsp, void * runParam, int * retCode, winux::String * errDetail );

    SessionServer * _sessServ;  
    void * _runParam;           
    void * _param;              
    AppServerExternalData * _externalData;  

    typedef int ( * PFN_WebMain )( Response *, void * );
    std::map< winux::String, winux::SimplePointer<winux::DllLoader> > _loadedDlls;  

    typedef winux::DllLoader::Function<PFN_WebMain> WebMainFunc;
    std::map< winux::String, WebMainFunc > _loadedWebMainFuncs;     

    winux::Mutex _mtxApp; 
    bool _isSetDoDirAsWorkDir; 

    friend class Request;
    friend class FcgiRequest;
    friend class CgiRequest;

    DISABLE_OBJECT_COPY(App)
};


} // namespace eienwebx