CpGatewayManager.h

Go to the documentation of this file.

//
// 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.
//
// $$


#ifndef _CpGatewayManager_h_
#define _CpGatewayManager_h_

// SYSTEM INCLUDES
//#include <...>

// APPLICATION INCLUDES
#include <os/OsServerTask.h>

// DEFINES
// MACROS
// EXTERNAL FUNCTIONS
// EXTERNAL VARIABLES
// CONSTANTS
// STRUCTS
// TYPEDEFS
// FORWARD DECLARATIONS
class PtGatewayInterface;

//:Class short description which may consist of multiple lines (note the ':')
// Class detailed description which may extend to multiple lines
class CpGatewayManager : public OsServerTask
{
/* //////////////////////////// PUBLIC //////////////////////////////////// */
public:

/* ============================ CREATORS ================================== */

   CpGatewayManager();
     //:Default constructor

   CpGatewayManager(const CpGatewayManager& rCpGatewayManager);
     //:Copy constructor

   virtual
   ~CpGatewayManager();
     //:Destructor

/* ============================ MANIPULATORS ============================== */

   static CpGatewayManager* getCpGatewayManager();
    //: Singleton constructor/accessor
    // Note: this class does not need to be a singleton.  The only method that
    // assumes singleton is getCpGatewayManager.

   CpGatewayManager& operator=(const CpGatewayManager& rhs);
     //:Assignment operator

   OsStatus setGatewayInterface(const char* terminalName, 
       PtGatewayInterface* pInterface);
   //: Add a PtGatewayInterface call back object for media setup on the named 
   //: terminal.
   // Note this method does not validate the terminal name in any way.  One
   // validate the terminal name and be sure that it is registered with the 
   // provider (i.e. proxy server) if calls are to work with the provider.

   void getNewCallId(UtlString& callId);
   //: Get a valid callId with which to create a new call
   //  The callId is needed to call methods (i.e. <I>dialUrl</I>) requiring 
   // a callId to create a new call.

   OsStatus connect(const char* callId, 
                    const char* fromAddressUrl,
                    const char* fromTerminalName,
                    const char* toAddressUrl);
   //: Create a call if one does not exist and setup a connection between
   //: the to and from addresses originating on the given terminal.

   OsStatus answer(const char* callId, const char* terminalName);
   //: Answer an incoming call on the given terminal.

   OsStatus disconnectConnection(const char* callId, 
                                 const char* connectionAddressUrl);
   //: Disconnects the indicated connection in the given call.

/* ============================ ACCESSORS ================================= */

   UtlBoolean gatewayInterfaceExists(const char* terminalName);
   //: Checks if the named terminal has a registered gateway interface.
   // Note: this does not validate that the terminal name is valid with respect to the provider or proxy.

/* ============================ INQUIRY =================================== */

/* //////////////////////////// PROTECTED ///////////////////////////////// */
protected:

/* //////////////////////////// PRIVATE /////////////////////////////////// */
private:

};

/* ============================ INLINE METHODS ============================ */

#endif  // _CpGatewayManager_h_