--- parser3/src/include/pa_pool.h 2001/03/13 11:15:03 1.30 +++ parser3/src/include/pa_pool.h 2002/02/08 08:30:13 1.78 @@ -1,165 +1,181 @@ -/* - Parser - Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com) - Author: Alexander Petrosyan (http://design.ru/paf) +/** @file + Parser: pool class decl. - $Id: pa_pool.h,v 1.30 2001/03/13 11:15:03 paf Exp $ + Copyright (c) 2001, 2002 ArtLebedev Group (http://www.artlebedev.com) + + Author: Alexandr Petrosian (http://paf.design.ru) + + $Id: pa_pool.h,v 1.78 2002/02/08 08:30:13 paf Exp $ */ #ifndef PA_POOL_H #define PA_POOL_H -#include +#include "pa_config_includes.h" + +#ifdef XML +# include "gdome.h" +// for xmlChar +# include "libxml/tree.h" +#endif + +// forwards class Exception; -class Temp_exception; +class String; +class Charset; +class GdomeDOMString_auto_ptr; + +/** + Pool mechanizm allows users not to free up allocated memory, + leaving that problem to 'pools'. + + @see Pooled +*/ class Pool { - friend Temp_exception; public: - Pool() : - fexception_to_trhow(0), - fpending_exception(0) { - } - ~Pool() {} + Pool(void *astorage); + + ///{@ statistics + size_t total_allocated() { return ftotal_allocated; } + unsigned int total_times() { return ftotal_times; } + ///}@ - Exception& exception_to_throw() const { return *fexception_to_throw; } - //Exception *pending_exception() const { return fpending_exception; } + void set_context(void *acontext) { fcontext=acontext; } + void *get_context() { return fcontext; } - void *malloc(size_t size) { - return check(real_malloc(size), size); + /// allocates some bytes on pool + void *malloc(size_t size, int place=0) { + return check(real_malloc(size, place), size); } + /// allocates some bytes clearing them with zeros void *calloc(size_t size) { return check(real_calloc(size), size); } - void maybe_rethrow_pending_exception() { - if(fpending_exception) - fexception_to_throw._throw( - fpending_exception.type(), - fpending_exception.code(), - fpending_exception.problem_source(), - fpending_exception.comment() - ); - } + /// registers a routine to clean up non-pooled allocations + void register_cleanup(void (*cleanup) (void *), void *data) { + if(!real_register_cleanup(cleanup, data)) + fail_register_cleanup(); + } + + ///{@ source charset + void set_source_charset(Charset& acharset); + Charset& get_source_charset(); + ///}@ + + ///{@ client charset + void set_client_charset(Charset& charset); + Charset& get_client_charset(); + ///}@ + +#ifdef XML + + /// @see Charset::transcode_cstr(xmlChar *s); + const char *transcode_cstr(xmlChar *s); + /// @see Charset::transcode(xmlChar *s); + String& transcode(xmlChar *s); + /// @see Charset::transcode_cstr(GdomeDOMString *s); + const char *transcode_cstr(GdomeDOMString *s); + /// @see Charset::transcode(GdomeDOMString *s); + String& transcode(GdomeDOMString *s); + /// @see Charset::transcode(const String& s) + GdomeDOMString_auto_ptr transcode(const String& s); -private: // implementation defined +#endif - void *real_malloc(size_t size); +private: + + void *fstorage; + void *fcontext; + Charset *source_charset; + Charset *client_charset; + +private: + + //{ + /// @name implementation defined + void *real_malloc(size_t size, int place); void *real_calloc(size_t size); + bool real_register_cleanup(void (*cleanup) (void *), void *data); + //} private: - // checks whether mem allocated OK. throws exception otherwise + /// checks whether mem allocated OK. throws exception otherwise void *check(void *ptr, size_t size) { - if(ptr) + if(ptr) { + ftotal_allocated+=size; + ftotal_times++; return ptr; + } - fail(size); + fail_alloc(size); // never reached return 0; } - // throws proper exception - void fail(size_t size) const; + /// throws allocation exception + void fail_alloc(size_t size) const; -protected: // exception handling - - // exception replacement mechanism is 'protected' from direct usage - // Temp_exception_change object enforces paired set/restore - Exception *set_exception(Exception *e){ - Exception *r=fexception_to_throw; - fexception_to_throw=e; - return r; - } - void restore_exception(Exception *e) { - fpending_exception=fexception_to_throw.is_handled()?0:fexception_to_throw; - fexception_to_throw=e; - } - -private: + /// throws register cleanup exception + void fail_register_cleanup() const; - // current request's exception object - Exception *fexception_to_throw; - - // just catched request's exception object - Exception *fpending_exception; +private: // statistics + + size_t ftotal_allocated; + unsigned int ftotal_times; private: //disabled - // Pool(const Pool&) {} - Pool& operator = (const Pool&) { return *this; } + Pool(const Pool&); + Pool& operator= (const Pool&); }; +/** + Base for all classes that are allocated in 'pools'. + + Holds Pool object. Contains useful wrappers to it's methods. + + @see NEW +*/ class Pooled { // the pool i'm allocated on - Pool& fpool; + Pool *fpool; public: - - static void *operator new(size_t size, Pool& apool) { - return apool.malloc(size); - } - Pooled(Pool& apool) : fpool(apool) { + /// the Pooled-sole: Pooled instances can be allocated in Pool rather then on heap + static void *operator new(size_t size, Pool& apool) { + return apool.malloc(size, 1); } - Pool& pool() const { return fpool; } + Pooled(Pool& apool) : fpool(&apool) {} - void *malloc(size_t size) const { return fpool.malloc(size); } - void *calloc(size_t size) const { return fpool.calloc(size); } -}; -#define NEW new(pool()) + /// my pool + Pool& pool() const { return *fpool; } -class Temp_exception { - Pool& fpool; - Exception *saved_exception; -public: - Temp_exception(Pool& apool, Exception& exception) : - fpool(apool), - saved_exception(apool.set_exception(&exception)) { - } - ~Temp_exception() { - fpool.restore_exception(saved_exception); - } -public: - bool triggered; -}; + /** used for moving objects from one pool to another. + in between object can have no pool and can not be used + @see SQL_Driver_manager + */ + void set_pool(Pool *apool) { fpool=apool; } -#define XTRY(p) \ - { \ - Exception temp_exception; \ - Temp_exception le(p, temp_exception); \ - if(setjmp(temp_exception.mark)==0) -#define XTHROW(p) p.exception_to_throw()._throw -#define XCATCH(e) \ - else{ \ - Exception& e=temp_exception; -#define XFINALLY(p) \ - } \ - p.maybe_rethrow_pending_exception(); -#define XEND_TRY \ - } + //{ + /// @name useful wrapper around pool + void *malloc(size_t size, int place=0) const { return fpool->malloc(size, place); } + void *calloc(size_t size) const { return fpool->calloc(size); } + void register_cleanup(void (*cleanup) (void *), void *data) { fpool->register_cleanup(cleanup, data); } +#ifdef XML -// usage: -// TRY { ...; if(?) RAISE(?); ...; } CATCH(e) { catch-code e.comment() } END_TRY + const char *transcode_cstr(GdomeDOMString *s) { return fpool->transcode_cstr(s); } + String& transcode(GdomeDOMString *s) { return fpool->transcode(s); } -#define TRY XTRY(pool()) -#define THROW XTHROW(pool()) -#define CATCH(e) XCATCH(e) -#define FINALLY(p) XFINALLY(pool()) -#define END_TRY XEND_TRY - -#define PTRY XTRY(pool) -#define PTHROW XTHROW(pool) -#define PCATCH(e) XCATCH(e) -#define PINALLY(p) XFINALLY(pool) -#define PEND_TRY XEND_TRY - -#define RTRY XTRY(r.pool()) -#define RTHROW XTHROW(r.pool()) -#define RCATCH(e) XCATCH(e) -#define RFINALLY(p) XFINALLY(r.pool()) -#define REND_TRY XEND_TRY +#endif + //} +}; +/// useful macro for creating objects on current Pooled object Pooled::pool() +#define NEW new(pool()) #endif