SBtrdRefCount.hpp
上传用户:xqtpzdz
上传日期:2022-05-21
资源大小:1764k
文件大小:4k
源码类别:

xml/soap/webservice

开发平台:

Visual C++

  1. /* SBtrdRefCount, base class for managing reference counts */
  2. /****************License************************************************
  3.  * Vocalocity OpenVXI
  4.  * Copyright (C) 2004-2005 by Vocalocity, Inc. All Rights Reserved.
  5.  * This program is free software; you can redistribute it and/or
  6.  * modify it under the terms of the GNU General Public License
  7.  * as published by the Free Software Foundation; either version 2
  8.  * of the License, or (at your option) any later version.
  9.  *  
  10.  * This program is distributed in the hope that it will be useful,
  11.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13.  * GNU General Public License for more details.
  14.  *
  15.  * You should have received a copy of the GNU General Public License
  16.  * along with this program; if not, write to the Free Software
  17.  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  18.  * Vocalocity, the Vocalocity logo, and VocalOS are trademarks or 
  19.  * registered trademarks of Vocalocity, Inc. 
  20.  * OpenVXI is a trademark of Scansoft, Inc. and used under license 
  21.  * by Vocalocity.
  22.  ***********************************************************************/
  23. // -----1=0-------2=0-------3=0-------4=0-------5=0-------6=0-------7=0-------8
  24. #ifndef _SBTRD_REFCOUNT_H__
  25. #define _SBTRD_REFCOUNT_H__
  26. #include "VXIheaderPrefix.h"          // For SYMBOL_EXPORT_CPP_DECL
  27. #include "VXItrd.h"                   // For error codes
  28. #ifdef SBTRDUTIL_EXPORTS
  29. #define SBTRDUTIL_API_CLASS SYMBOL_EXPORT_CPP_CLASS_DECL
  30. #else
  31. #define SBTRDUTIL_API_CLASS SYMBOL_IMPORT_CPP_CLASS_DECL
  32. #endif
  33. class SBtrdMutex;
  34. class SBTRDUTIL_API_CLASS SBtrdRefCount {
  35.  public:
  36.   // Constructor and destructor, pass NULL for the mutex if mutex
  37.   // protection is not required. Note that this class assumes the
  38.   // passed mutex will be shared across many instances to avoid having
  39.   // huge numbers of mutexes in the system, see above.
  40.   SBtrdRefCount (SBtrdMutex *mutex) : _refCount(1), _mutex(mutex) { }
  41.   virtual ~SBtrdRefCount( ) { }
  42.   // Add a reference and release a reference. Note: Release sets the
  43.   // pointer to NULL.
  44.   static VXItrdResult AddRef  (SBtrdRefCount *obj);
  45.   static VXItrdResult Release (SBtrdRefCount **obj);
  46.   // Get a unique copy if this is being shared in preparation for a
  47.   // write operation, don't want to change this under someone else's
  48.   // feet. The passed pointer will be changed if this is being shared.
  49.   // The passed mutex is used for future use by the new copy if a new
  50.   // copy is made, if NULL is passed the mutex used for the original
  51.   // copy will be shared.
  52.   static VXItrdResult GetUniqueCopy (SBtrdRefCount **obj,
  53.      SBtrdMutex *mutex);
  54.   
  55.   // Copy constructor for deep copies of derrived class during
  56.   // GetUniqueCopy( )
  57.   SBtrdRefCount (const SBtrdRefCount &r) : _refCount(1), _mutex(r._mutex) { }
  58.  protected:
  59.   // Ability to specify the mutex after the constructor
  60.   void SetRefCountMutex (SBtrdMutex *mutex) { _mutex = mutex; }
  61.   // Used to allocate a copy of the real derrived class when we don't
  62.   // know/care what the real derrived class is, must be implemented by
  63.   // all derrived classes. Default implementation here is to not
  64.   // support this, meaning GetUniqueCopy( ) is not supported.
  65.   virtual SBtrdRefCount *AllocateCopy( ) const { return NULL; }
  66.  private:
  67.   // Disable the assignment operator, just doesn't make sense to do
  68.   // this on the actual derrived class (need to have a wrapper class
  69.   // that does so by copying the pointer to the derrived class and
  70.   // adding a reference)
  71.   SBtrdRefCount & operator= (const SBtrdRefCount &r);
  72.  private:
  73.   unsigned long  _refCount;
  74.   SBtrdMutex    *_mutex;
  75. };
  76. #include "VXIheaderSuffix.h"
  77. #endif  // _SBTRD_REFCOUNT_H__