Home |  Recent changes |  Search |  Glossary |  Sitemap |  Login

About |  News |  SIP Resources |  Documentation |  Downloads |  Projects |  SIP Service |  Support          Project shortcuts:  SER |  SERweb |  SEMS

AmSipDialog.h

Go to the documentation of this file.

/*
 * $Id: AmSipDialog.h 923 2008-04-30 15:02:22Z sayer $
 *
 * Copyright (C) 2002-2003 Fhg Fokus
 *
 * This file is part of sems, a free SIP media server.
 *
 * sems is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version
 *
 * For a license to use the ser software under conditions
 * other than those described here, or to purchase support for this
 * software, please contact iptel.org by e-mail at the following addresses:
 *    info@iptel.org
 *
 * sems is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License 
 * along with this program; if not, write to the Free Software 
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
#ifndef AmSipDialog_h
#define AmSipDialog_h

#include "AmSipMsg.h"

#include <string>
#include <vector>
#include <map>
using std::string;

#define MAX_SER_KEY_LEN 30
#define CONTACT_USER_PREFIX "sems"

// flags which may be used when sending request/reply
#define SIP_FLAGS_VERBATIM     1 // send request verbatim, 
                                 // i.e. modify as little as possible

struct AmSipTransaction
{
  string       method;
  unsigned int cseq;

  // last reply code
  // (sent or received)
  //int reply_code;

  AmSipTransaction(const string& method, unsigned int cseq)
    : method(method),
       cseq(cseq)
  {}

  AmSipTransaction()
  {}
};

typedef std::map<int,AmSipTransaction> TransMap;

class AmSipDialogEventHandler 
{
 public:
  virtual void onSendRequest(const string& method,
                             const string& content_type,
                             const string& body,
                             string& hdrs,
                             int flags,
                             unsigned int cseq)=0;

  virtual void onSendReply(const AmSipRequest& req,
                           unsigned int  code,
                           const string& reason,
                           const string& content_type,
                           const string& body,
                           string& hdrs,
                           int flags)=0;

  virtual ~AmSipDialogEventHandler() {};
};

class AmSipDialog
{
  int status;

  TransMap uas_trans;
  TransMap uac_trans;

  AmSipDialogEventHandler* hdl;
  std::vector<string> route;        // record routing

  int updateStatusReply(const AmSipRequest& req, 
                        unsigned int code);

 public:
  enum Status {
        
    Disconnected=0,
    Pending,
    Connected,
    Disconnecting
  };

  static const char* status2str[4];

  string user;         // local user
  string domain;       // local domain
  string sip_ip;       // destination IP of first received message
  string sip_port;     // optional: SIP port

  string local_uri;    // local uri
  string remote_uri;   // remote uri

  string contact_uri;  // pre-calculated contact uri

  string callid;
  string remote_tag;
  string local_tag;

  string remote_party; // To/From
  string local_party;  // To/From

  string getRoute(); // record routing
  void   setRoute(const string& n_route);

  string next_hop;     // next_hop for t_uac_dlg

  int cseq;            // CSeq for next request

  char serKey[MAX_SER_KEY_LEN];      // opaque string returned by SER, when staring a T
  unsigned int serKeyLen;

  AmSipDialog(AmSipDialogEventHandler* h=0);
  ~AmSipDialog();

  bool   getUACTransPending() { return !uac_trans.empty(); }
  int    getStatus() { return status; }
  string getContactHdr();

  void updateStatus(const AmSipRequest& req);
  void updateStatus(const AmSipReply& reply);
  void updateStatusFromLocalRequest(const AmSipRequest& req);

  int reply(const AmSipRequest& req, // Ser's transaction key
            unsigned int  code, 
            const string& reason,
            const string& content_type = "",
            const string& body = "",
            const string& hdrs = "",
            int flags = 0);

  int sendRequest(const string& method, 
                  const string& content_type = "",
                  const string& body = "",
                  const string& hdrs = "",
                  int flags = 0);
    
  int bye();
  int cancel();
  int update(const string& hdrs);
  int reinvite(const string& hdrs,  
               const string& content_type,
               const string& body);
  int invite(const string& hdrs,  
             const string& content_type,
             const string& body);
  int refer(const string& refer_to);
  int transfer(const string& target);
  int drop();

  bool match_cancel(const AmSipRequest& cancel_req);

  string get_uac_trans_method(unsigned int cseq);

  static int reply_error(const AmSipRequest& req,
                         unsigned int  code, 
                         const string& reason,
                         const string& hdrs = "");
};


#endif

---

Legal Notices |  Privacy Policy

Home |  Recent changes |  Search |  Glossary |  Sitemap |  Login

Copyright (c) 2001-2007 iptel.org. All rights reserved.

Sponsored by FhG FOKUS, iptelorg GmbH, and iptego GmbH