BaseClass.h

Go to the documentation of this file.

//
// Copyright (C) 2006-2013 SIPez LLC.  All rights reserved.
//
// Copyright (C) 2004-2006 SIPfoundry Inc.
// Licensed by SIPfoundry under the LGPL license.
//
// Copyright (C) 2004-2006 Pingtel Corp.  All rights reserved.
// Licensed to SIPfoundry under a Contributor Agreement.
//
// $$

//  Border Guard
#ifndef _BaseClass_h /* [ */
#define _BaseClass_h

#include "rtcp/RtcpConfig.h"
#include "os/OsSysLog.h"

//  Includes
#ifdef WIN32 /* [ */
#define WIN32_LEAN_AND_MEAN
#include <windows.h>
#include <objbase.h>
#include <stdio.h>

#ifdef PINGTEL_PRINTF
#include "os/OsDefs.h"
#else
#define osPrintf printf
#endif

// Required for VC7 compatibility
#if _MSC_VER >= 1300
#ifndef interface
    #define interface __interface
#endif
#endif

#endif /* WIN32 ] */

#ifdef _VXWORKS /* [ */
#include <vxworks.h>
#include <stdio.h>
#include <inetLib.h>
#include <hostLib.h>
#include <string.h>
#include "os/OsDefs.h"

//  Windows Compatability
#define interface struct

//  Make sure that WAIT FOREVER is defined
#ifndef WAIT_FOREVER
#define WAIT_FOREVER VX_WAIT_FOREVER
#endif /* WAIT_FOREVER */

#endif /* _VXWORKS ] */


//  Static Declarations
// static unsigned long sulTotalReferenceCount = 0;
extern bool     bPingtelDebug;


#ifndef WIN32 /* [ */

#ifdef __pingtel_on_posix__ /* [ */
#include <os/OsBSem.h>
typedef OsBSem * CRITICAL_SECTION;
#define interface struct
#endif /* __pingtel_on_posix__ ] */

#ifdef _VXWORKS /* [ */
#include <semLib.h>
typedef SEM_ID  CRITICAL_SECTION;
#endif /* _VXWORKS ] */


/*|><|************************************************************************
*
* Functions: CriticalSection support
*
*
* Inputs:       CRITICAL_SECTION *csSynchronized
*
* Outputs:      None
*
* Returns:      None
*
* Description:  Compatability functions that map to
*               complementary calls under Win32.
*
*
*************************************************************************|<>|*/
void InitializeCriticalSection(CRITICAL_SECTION *csSynchronized);
void EnterCriticalSection(CRITICAL_SECTION *csSynchronized);
void LeaveCriticalSection(CRITICAL_SECTION *csSynchronized);
void DeleteCriticalSection(CRITICAL_SECTION *csSynchronized);
#endif /* NOT _WIN32 ] */


class CBaseClass
{

//  Public Methods
public:

    CBaseClass CBASECLASS_PROTO_ARGS((const char* pDerivedType = "Unknown", int callLineNum = 0));



    virtual ~CBaseClass(void);

    virtual bool Initialize(void);

    bool IsInitialized(void);

    void setAutomatic(bool);

    virtual unsigned long AddRef ADD_RELEASE_PROTO_ARGS((int callLineNum));

    virtual unsigned long Release ADD_RELEASE_PROTO_ARGS((int callLineNum));

static bool AllowDeletes(void);
static void s_SetAllowDeletes(int v);

// protected:
      bool m_bInitialized;

      bool m_bAutomatic;

      int m_ulReferences;

#ifdef RTCP_DEBUG_REFCOUNTS /* [ */
      const char* m_DerivedType;
      int   m_Line;
#endif /* RTCP_DEBUG_REFCOUNTS ] */

      static bool s_bAllowDeletes;

};

inline bool CBaseClass::Initialize(void)
{

//  Set initialization flag to TRUE
    m_bInitialized = TRUE;

    return(TRUE);

}


inline bool CBaseClass::IsInitialized(void)
{

    return(m_bInitialized);

}

inline void CBaseClass::setAutomatic(bool yesNo)
{
    m_bAutomatic = yesNo;
}

inline bool CBaseClass::AllowDeletes(void)
{
    return(s_bAllowDeletes);
}


#define DECLARE_IBASE_M \
   unsigned long AddRef ADD_RELEASE_PROTO_ARGS((int callLineNum)) \
   { \
      if (callLineNum > 0) OsSysLog::add(FAC_MP, PRI_DEBUG,  __FILE__ " %p->AddRef(%d),  count: %d", this, callLineNum, m_ulReferences); \
      return CBaseClass::AddRef(ADD_RELEASE_CALL_ARGS(callLineNum)); \
   } \
   unsigned long Release ADD_RELEASE_PROTO_ARGS((int callLineNum)) \
   { \
      int ulRefCount; \
      if((ulRefCount = CBaseClass::Release(ADD_RELEASE_CALL_ARGS(callLineNum))) == 0) \
      { \
        if (CBaseClass::AllowDeletes()) { \
          delete this; \
        } else { \
          if (callLineNum > 0) OsSysLog::add(FAC_MP, PRI_DEBUG,  __FILE__ " %p->Release(%d) [would delete this]", this, callLineNum); \
        } \
      } \
      if (callLineNum > 0) OsSysLog::add(FAC_MP, PRI_DEBUG,  __FILE__ " %p->Release(%d), count: %d", this, callLineNum, ulRefCount); \
      return(ulRefCount); \
   }
#endif /* ] */