SipXEventDispatcher.h

Go to the documentation of this file.

//
// Copyright (C) 2006 SIPfoundry Inc.
// Licensed by SIPfoundry under the LGPL license.
//
// Copyright (C) 2006 Robert J. Andreasen, Jr.
// Licensed to SIPfoundry under a Contributor Agreement.
//
// $$

#ifndef _SIPXEVENTDISPATCHER_H_
#define _SIPXEVENTDISPATCHER_H_

// SYSTEM INCLUDES
// APPLICATION INCLUDES
#include "os/OsServerTask.h"
#include "tapi/sipXtapi.h"
#include "tapi/sipXtapiEvents.h"
#include "utl/UtlHashMap.h"
#include "os/OsRWMutex.h"

// DEFINES
// MACROS
// EXTERNAL FUNCTIONS
// CONSTANTS
// STRUCTS
// TYPEDEFS
typedef struct
{   
    SIPX_INST                   hInst ;
    SIPX_EVENT_CALLBACK_PROC    pCallbackProc ;
    void*                       pUserData ;
} SIPX_EVENT_LISTENER_CONTEXT ;

// MACROS

// FORWARD DECLARATIONS
class OsEventMsg ;

class SipXEventDispatcher : public OsServerTask
{
public:
/* ============================ CREATORS ================================== */

    SipXEventDispatcher(SIPX_INST hInst);

    virtual ~SipXEventDispatcher(void);
    
/* ============================ MANIPULATORS ============================== */

    UtlBoolean handleMessage(OsMsg& rMsg);

    bool addListener(SIPX_EVENT_CALLBACK_PROC  pCallbackProc,
                     void*                     pUserData) ;

    bool removeListener(SIPX_EVENT_CALLBACK_PROC  pCallbackProc,
                        void*                     pUserData) ;

    void removeAllListeners() ;

    void serviceListeners(SIPX_EVENT_CATEGORY category, 
                          void*               pInfo) ;

    void setInstanceHandle(SIPX_INST hNew) ;

protected:
    static bool SIPX_CALLING_CONVENTION EventCallBack(SIPX_EVENT_CATEGORY category, 
                                                      void*               pInfo, 
                                                      void*               pUserData);
        
private:
    SIPX_INST  mhInst ;
    UtlHashMap mListeners ;
    OsRWMutex  mListenerLock;
};

#endif // _SIPXEVENTDISPATCHER_H_