eientpl.hpp

浏览该文件的文档.

#ifndef __EIENTPL_HPP__
#define __EIENTPL_HPP__

#include "winux.hpp"
#include "eienexpr.hpp"
#include "eienml.hpp"

namespace eientpl
{
#ifdef EIENTPL_DLL_USE
    #if defined(_MSC_VER) || defined(WIN32)
        #pragma warning( disable: 4251 )
        #ifdef EIENTPL_DLL_EXPORTS
            #define EIENTPL_DLL  __declspec(dllexport)
        #else
            #define EIENTPL_DLL  __declspec(dllimport)
        #endif

        #define EIENTPL_API __stdcall
    #else
        #define EIENTPL_DLL
        #define EIENTPL_API
    #endif
#else
    #define EIENTPL_DLL
    #define EIENTPL_API
#endif

#define EIENTPL_FUNC_DECL(ret) EIENTPL_DLL ret EIENTPL_API
#define EIENTPL_FUNC_IMPL(ret) ret EIENTPL_API

class EIENTPL_DLL TplError : public winux::Error
{
public:
    enum
    {
        teNone,  
    };
    TplError( int errNo, winux::AnsiString const & err ) throw() : winux::Error( errNo, err ) { }
};

class Template;
class TemplateCache;

class EIENTPL_DLL __TemplateLang
{
public:
    Template * _tpl; 
    eienexpr::ExprPackage _exprPack; 
    eienml::ElemPackage _elemPack; 
    winux::StringArray _loadFilesChains; 
public:
    __TemplateLang( Template * tpl );

    winux::Mixed evalExprVal( winux::SimplePointer<eienexpr::Expression> & expr, winux::String const & exprStr );

    bool evalExprMixedPtr( winux::SimplePointer<eienexpr::Expression> & expr, winux::String const & exprStr, winux::Mixed ** ppv );

};

class EIENTPL_DLL Template
{
public:
    Template( winux::String const & tplDir = "", winux::String const & localEncoding = "", winux::String const & targetEncoding = "" );
    virtual ~Template();

    void assign( winux::String const & name, winux::Mixed const & v, bool convertEncoding = true );
    void assignPtr( winux::String const & name, winux::Mixed * p, bool convertEncoding = true );
    void clear();

    winux::String output( winux::String const & tplFile, winux::String const & cacheId = "" );
    winux::String outputStr( winux::String const & tplStr, winux::String const & cacheId );

    winux::String _outputInternal( winux::String const & tplFilePath );

    void setTplDirPath( winux::String const & dirPath ) { this->_tplDirPath = winux::PathWithSep(dirPath); }
    winux::String const & getTplDirPath() const { return this->_tplDirPath; }

    void setCache( TemplateCache * cache = NULL ) { this->_cache = cache; }

    __TemplateLang * getTplLangObj();
    eienexpr::VarContext * getVarContext() { return &this->_varCtx; }
    winux::Mixed const & getVar( winux::String const & name ) const;

    winux::String convFrom( winux::String const & str ) const;
    winux::String convTo( winux::String const & str ) const;

    winux::String const & getLocalEncoding() const { return _localEncoding; }
    winux::String const & getTargetEncoding() const { return _targetEncoding; }
private:
    winux::String _tplDirPath; // 模板目录
    winux::String _localEncoding; // 本地编码
    winux::String _targetEncoding; // 目标编码
    TemplateCache * _cache; // 模板缓存
    eienexpr::VarContext _varCtx; // 变量场景

    winux::MembersWrapper<struct Template_Data> _self; // 隐藏的数据

    DISABLE_OBJECT_COPY(Template)
};

class EIENTPL_DLL TemplateCache
{
public:
    virtual ~TemplateCache() {}
    virtual bool hasCache( winux::String const & cacheName ) const = 0;
    virtual bool getCacheName( winux::String * cacheName, winux::String const & tplFile, winux::String const & cacheId = "" ) const = 0;
    virtual bool readCache( winux::String const & cacheName, winux::String * str ) = 0;
    virtual winux::String get( winux::String const & cacheName ) const = 0;
    virtual bool writeCache( winux::String const & cacheName, winux::String const & str ) = 0;

    virtual void setLifeTime( time_t lifeTime = 0 ) = 0;
    virtual time_t getLifeTime() const = 0;
};

class EIENTPL_DLL TemplateFileCache : public TemplateCache
{
public:
    TemplateFileCache( time_t lifeTime, winux::String const & cacheDir, winux::String const & cacheExt = ".cah" );

    virtual bool hasCache( winux::String const & cacheName ) const override;
    virtual bool getCacheName( winux::String * cacheName, winux::String const & tplFile, winux::String const & cacheId = "" ) const override;
    virtual bool readCache( winux::String const & cacheName, winux::String * str ) override;
    virtual winux::String get( winux::String const & cacheName ) const override;
    virtual bool writeCache( winux::String const & cacheName, winux::String const & str ) override;

    virtual void setLifeTime( time_t lifeTime = 0 ) override;
    virtual time_t getLifeTime() const override;

    void setCacheDirPath( winux::String const & dirPath );
    winux::String const & getCacheDirPath() const { return this->_cacheDirPath; }

    void setCacheExt( winux::String const & extName );
    winux::String const & getCacheExt() const { return this->_cacheExt; }

private:
    time_t _cacheLifeTime; // 缓存生命期 0表示不缓存
    winux::String _cacheDirPath; // 缓存目录带分隔符
    winux::String _cacheExt; //缓存文件扩展名 默认为`.cah`
};

class EIENTPL_DLL TemplateMemoryCache : public TemplateCache
{
public:
    struct CacheItem
    {
        time_t timeStamp;
        winux::String content;
    };

    typedef std::map< winux::String, CacheItem > CacheItemsMap;
    typedef std::map< winux::String, CacheItemsMap > CacheStruct;

    TemplateMemoryCache( time_t lifeTime, CacheItemsMap * cacheItems );

    virtual bool hasCache( winux::String const & cacheName ) const override;
    virtual bool getCacheName( winux::String * cacheName, winux::String const & tplFile, winux::String const & cacheId = "" ) const override;
    virtual bool readCache( winux::String const & cacheName, winux::String * str ) override;
    virtual winux::String get( winux::String const & cacheName ) const override;
    virtual bool writeCache( winux::String const & cacheName, winux::String const & str ) override;

    virtual void setLifeTime( time_t lifeTime = 0 ) override;
    virtual time_t getLifeTime() const override;

private:
    time_t _cacheLifeTime; // 缓存生命期 0表示不缓存
    CacheItemsMap * _cacheItems;
};

} // namespace eientpl

#endif // __EIENTPL_HPP__