sipcon.h

Go to the documentation of this file.

/*
 * sipcon.h
 *
 * Session Initiation Protocol connection.
 *
 * Open Phone Abstraction Library (OPAL)
 * Formally known as the Open H323 project.
 *
 * Copyright (c) 2001 Equivalence Pty. Ltd.
 *
 * The contents of this file are subject to the Mozilla Public License
 * Version 1.0 (the "License"); you may not use this file except in
 * compliance with the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 * the License for the specific language governing rights and limitations
 * under the License.
 *
 * The Original Code is Open Phone Abstraction Library.
 *
 * The Initial Developer of the Original Code is Equivalence Pty. Ltd.
 *
 * Contributor(s): ______________________________________.
 *
 * $Revision: 20907 $
 * $Author: rjongbloed $
 * $Date: 2008-09-09 04:30:12 +0000 (Tue, 09 Sep 2008) $
 */

#ifndef __OPAL_SIPCON_H
#define __OPAL_SIPCON_H

#ifdef P_USE_PRAGMA
#pragma interface
#endif

#include <opal/buildopts.h>
#include <opal/rtpconn.h>
#include <sip/sippdu.h>
#if OPAL_VIDEO
#include <opal/pcss.h>                  // for OpalPCSSConnection
#include <codec/vidcodec.h>             // for OpalVideoUpdatePicture command
#endif

class OpalCall;
class SIPEndPoint;



//class SIPConnection : public OpalConnection
class SIPConnection : public OpalRTPConnection
{
  PCLASSINFO(SIPConnection, OpalRTPConnection);
  public:

    SIPConnection(
      OpalCall & call,                          
      SIPEndPoint & endpoint,                   
      const PString & token,                    
      const SIPURL & address,                   
      OpalTransport * transport,                
      unsigned int options = 0,                 
      OpalConnection::StringOptions * stringOptions = NULL  
    );

    ~SIPConnection();

    virtual bool IsNetworkConnection() const { return true; }

    virtual PString GetPrefixName() const;

    virtual PString GetRemotePartyURL() const;

    virtual PBoolean SetUpConnection();

    virtual PString GetDestinationAddress();

    virtual PString GetCalledPartyURL();

    virtual bool TransferConnection(
      const PString & remoteParty   
    );

    virtual bool HoldConnection();

    virtual bool RetrieveConnection();

    virtual PBoolean IsConnectionOnHold();

    virtual PBoolean SetAlerting(
      const PString & calleeName,   
      PBoolean withMedia
    );

    virtual PBoolean SetConnected();

    virtual OpalMediaFormatList GetMediaFormats() const;
    
    virtual OpalMediaStreamPtr OpenMediaStream(
      const OpalMediaFormat & mediaFormat, 
      unsigned sessionID,                  
      bool isSource                        
    );

    virtual bool CloseMediaStream(
      OpalMediaStream & stream  
    );

    virtual void OnReleased();

    virtual PBoolean ForwardCall(
      const PString & forwardParty   
    );

    virtual SendUserInputModes GetRealSendUserInputMode() const;

    PBoolean SendUserInputTone(char tone, unsigned duration);

    virtual void OnRTPStatistics(
      const RTP_Session & session         
    ) const;

    virtual void OnTransactionFailed(
      SIPTransaction & transaction
    );

    virtual void OnReceivedPDU(SIP_PDU & pdu);

    virtual void OnReceivedINVITE(SIP_PDU & pdu);

    virtual void OnReceivedReINVITE(SIP_PDU & pdu);

    virtual void OnReceivedACK(SIP_PDU & pdu);
  
    virtual void OnReceivedOPTIONS(SIP_PDU & pdu);

    virtual void OnReceivedNOTIFY(SIP_PDU & pdu);

    virtual void OnReceivedREFER(SIP_PDU & pdu);
  
    virtual void OnReceivedINFO(SIP_PDU & pdu);

    virtual void OnReceivedPING(SIP_PDU & pdu);

    virtual void OnReceivedBYE(SIP_PDU & pdu);
  
    virtual void OnReceivedCANCEL(SIP_PDU & pdu);
  
    virtual void OnReceivedResponseToINVITE(
      SIPTransaction & transaction,
      SIP_PDU & response
    );

    virtual void OnReceivedResponse(
      SIPTransaction & transaction,
      SIP_PDU & response
    );

    virtual void OnReceivedTrying(SIP_PDU & pdu);
  
    virtual void OnReceivedRinging(SIP_PDU & pdu);
  
    virtual void OnReceivedSessionProgress(SIP_PDU & pdu);
  
    virtual PBoolean OnReceivedAuthenticationRequired(
      SIPTransaction & transaction,
      SIP_PDU & response
    );
  
    virtual void OnReceivedRedirection(SIP_PDU & pdu);

    virtual void OnReceivedOK(
      SIPTransaction & transaction,
      SIP_PDU & response
    );
  
    virtual void OnCreatingINVITE(SIP_PDU & pdu);

    virtual PBoolean SendInviteOK(const SDPSessionDescription & sdp);
        
    virtual PBoolean SendInviteResponse(
      SIP_PDU::StatusCodes code,
      const char * contact = NULL,
      const char * extra = NULL,
      const SDPSessionDescription * sdp = NULL
    );

    unsigned GetNextCSeq() { return ++lastSentCSeq; }

    OpalTransportAddress GetLocalAddress(WORD port = 0) const;

    OpalTransport & GetTransport() const { return *transport; }

    SIPEndPoint & GetEndPoint() const { return endpoint; }
    const SIPURL & GetRequestURI() const { return m_requestURI; }
    const PString & GetDialogFrom() const { return m_dialogFrom; }
    const PString & GetDialogTo() const { return m_dialogTo; }
    const PStringList & GetRouteSet() const { return routeSet; }
    SIPAuthentication * GetAuthenticator() const { return authentication; }

#if OPAL_VIDEO

    virtual PBoolean OnMediaControlXML(SIP_PDU & pdu);
#endif

    virtual void OnMediaCommand(OpalMediaCommand & note, INT extra);

  protected:
    PDECLARE_NOTIFIER(PTimer, SIPConnection, OnInviteResponseRetry);
    PDECLARE_NOTIFIER(PTimer, SIPConnection, OnAckTimeout);

    void AdjustOutgoingINVITE();
    virtual RTP_UDP *OnUseRTPSession(
      const unsigned rtpSessionId,
      const OpalMediaType & mediaType,
      const OpalTransportAddress & mediaAddress,
      OpalTransportAddress & localAddress
    );

    virtual bool OnSendSDP(
      bool isAnswerSDP,
      OpalRTPSessionManager & rtpSessions,
      SDPSessionDescription & sdpOut
    );
    virtual bool OfferSDPMediaDescription(
      const OpalMediaType & mediaType,
      unsigned sessionID,
      OpalRTPSessionManager & rtpSessions,
      SDPSessionDescription & sdpOut
    );
    virtual bool AnswerSDPMediaDescription(
      const SDPSessionDescription & sdpIn,
      unsigned sessionIndex,
      SDPSessionDescription & sdpOut
    );

    virtual void OnReceivedSDP(
      SIP_PDU & pdu
    );
    virtual bool OnReceivedSDPMediaDescription(
      SDPSessionDescription & sdp,
      unsigned sessionId
    );
    friend class SIPInvite;
    static PBoolean WriteINVITE(OpalTransport & transport, void * param);

    OpalTransport * CreateTransport(const OpalTransportAddress & address, PBoolean isLocalAddress = PFalse);

    void UpdateRemoteAddresses(const PString & addr);

    SIPEndPoint         & endpoint;
    OpalTransport       * transport;
    bool                  deleteTransport;

    enum HoldState {
      eHoldOff,
      eRetrieveInProgress,

      // Order is important!
      eHoldOn,
      eHoldInProgress
    };
    HoldState             m_holdToRemote;
    bool                  m_holdFromRemote;
    PString               forwardParty;

    SIP_PDU             * originalInvite;
    PTime                 originalInviteTime;

    bool                  needReINVITE;
    PStringList           routeSet;
    SIPURL                m_requestURI;
    PString               m_dialogFrom;
    PString               m_dialogTo;
    SIPAuthentication   * authentication;

    std::map<SIP_PDU::Methods, unsigned> m_lastRxCSeq;

    PTimer                    ackTimer;
    PTimer                    ackRetry;
    SIP_PDU                   ackPacket;
    bool                      ackReceived;
    PSafePtr<SIPTransaction>  referTransaction;
    PSafeList<SIPTransaction> forkedInvitations; // Not for re-INVITE
    PAtomicInteger            lastSentCSeq;

    enum {
      ReleaseWithBYE,
      ReleaseWithCANCEL,
      ReleaseWithResponse,
      ReleaseWithNothing,
    } releaseMethod;

    OpalMediaFormatList remoteFormatList;

  protected:
    PTimer sessionTimer;
  public:
    PDECLARE_NOTIFIER(PTimer, SIPConnection, OnSessionTimeout);
};


class SIP_RTP_Session : public RTP_UserData
{
  PCLASSINFO(SIP_RTP_Session, RTP_UserData);

    SIP_RTP_Session(
      const SIPConnection & connection  
    );

    virtual void OnTxStatistics(
      const RTP_Session & session   
    ) const;

    virtual void OnRxStatistics(
      const RTP_Session & session   
    ) const;

#if OPAL_VIDEO

    virtual void OnRxIntraFrameRequest(
      const RTP_Session & session   
    ) const;

    virtual void OnTxIntraFrameRequest(
      const RTP_Session & session   
    ) const;
#endif


    void OnClearCall(const RTP_Session & /*session*/);

  protected:
    const SIPConnection & connection; 
};


#endif // __OPAL_SIPCON_H


// End of File ///////////////////////////////////////////////////////////////

---