--- parser3/src/include/pa_pool.h 2001/03/19 16:44:00 1.35 +++ parser3/src/include/pa_pool.h 2001/10/18 13:09:37 1.63 @@ -1,18 +1,28 @@ /** @file - Parser + Parser: pool class decl. + Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com) + Author: Alexander Petrosyan (http://design.ru/paf) - $Id: pa_pool.h,v 1.35 2001/03/19 16:44:00 paf Exp $ + $Id: pa_pool.h,v 1.63 2001/10/18 13:09:37 parser Exp $ */ #ifndef PA_POOL_H #define PA_POOL_H -#include +#include "pa_config_includes.h" + +#ifdef XML +#include +#include +#endif + +// forwards class Exception; class Temp_exception; +class String; /** Pool mechanizm allows users not to free up allocated memory, @@ -20,31 +30,61 @@ class Temp_exception; Also holds Exception object, which can be temporary set using Temp_exception auto-object. + + @see Pooled */ class Pool { friend Temp_exception; public: - Pool() : fexception(0) {} - ~Pool() {} + Pool(void *astorage); + ~Pool(); - /// current exception object of the pool - Exception& exception() const { return *fexception; } + void set_context(void *acontext) { fcontext=acontext; } + void *context() { return fcontext; } + + void set_tag(void *atag) { ftag=atag; } + void *tag() { return ftag; } /// allocates some bytes on pool - void *malloc(size_t size) { - return check(real_malloc(size), size); + 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); } -private: // implementation defined + /// 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(); + } + + /// current exception object of the pool + Exception& exception() const { return *fexception; } + + /// resets transcoder if they change charset + void set_charset(const String &charset); + /// returns current charset + const String& get_charset() { return *charset; } + +private: + + void *fstorage; + void *fcontext; + void *ftag; + const String *charset; - void *real_malloc(size_t size); +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: @@ -53,17 +93,20 @@ private: if(ptr) 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; + + /// throws register cleanup exception + void fail_register_cleanup() const; private: // exception handling - // exception replacement mechanism is 'protected' from direct usage + // exception replacement mechanism is 'private'zed from direct usage // Temp_exception object enforces paired set/restore Exception *set_exception(Exception *e){ Exception *r=fexception; @@ -79,6 +122,29 @@ private: // current request's exception object Exception *fexception; +#ifdef XML + +public: + /// converts Xalan string to char * + const char *transcode_cstr(const XalanDOMString& s); + /// converts Xalan string to parser String + String& transcode(const XalanDOMString& s); + /// converts char * to Xalan string + XalanDOMString& Pool::transcode_buf(const char *buf, size_t buf_size); + /// converts parser String to Xalan string + XalanDOMString& Pool::transcode(const String& s); + +private: + + void set_charset(const char *new_scharset); + void update_transcoder(); + +private: + + XMLTranscoder *transcoder; + +#endif + private: //disabled // Pool(const Pool&) {} @@ -89,28 +155,41 @@ private: //disabled Base for all classes that are allocated in 'pools'. Holds Pool object. Contains useful wrappers to it's methods. + + @see NEW, Temp_exception */ class Pooled { // the pool i'm allocated on - Pool& fpool; + Pool *fpool; public: - + + /// 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); + return apool.malloc(size/*, 1*/); } - Pooled(Pool& apool) : fpool(apool) { - } + Pooled(Pool& apool) : fpool(&apool) {} /// my pool - Pool& pool() const { return fpool; } + Pool& pool() const { return *fpool; } - /// useful wrapper around pool - void *malloc(size_t size) const { return fpool.malloc(size); } - /// useful wrapper around pool - void *calloc(size_t size) const { return fpool.calloc(size); } - /// useful wrapper around pool - Exception& exception() const { return fpool.exception(); } + /** 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; } + + //{ + /// @name useful wrapper around pool + void *malloc(size_t size) const { return fpool->malloc(size); } + void *calloc(size_t size) const { return fpool->calloc(size); } + void register_cleanup(void (*cleanup) (void *), void *data) { fpool->register_cleanup(cleanup, data); } + Exception& exception() const { return fpool->exception(); } +#ifdef XML + const char *transcode_cstr(const XalanDOMString& s) { return fpool->transcode_cstr(s); } + String& transcode(const XalanDOMString& s) { return fpool->transcode(s); } +#endif + //} }; /// useful macro for creating objects on current Pooled object Pooled::pool() #define NEW new(pool()) @@ -119,18 +198,20 @@ public: Auto-object used for temporary changing Pool's exception(). Use by with these macros: - \code + @code TRY { - ... + // ... if(?) THROW(?); - ...; + // ... } CATCH(e) { - code, using e fields - e.comment() + // code, using e fields + // e.comment() } END_CATCH - \endcode + @endcode + + @see TRY, THROW */ class Temp_exception { Pool& fpool; @@ -171,8 +252,6 @@ public: #define PTHROW XTHROW(pool.exception()) #define PCATCH(e) XCATCH(e) #define PEND_CATCH XEND_CATCH - -#define RTHROW XTHROW(r.pool().exception()) //@} #endif