SDPSessionDescription.h

Go to the documentation of this file.

/* Copyright (C) 2000 KOM/Darmstadt University of Technology
 *
 * You are allowed to use all other parts of the code under the following terms:
 *
 * For non-commercial use, code may be used in unmodified form provided
 * that this copyright notice and this permission notice appear in
 * supporting documentation.
 *
 * This software is provided "as is" and without any express or implied
 * warranties, including, without limitation, the implied warranty of
 * fitness for a particular purpose.
 *
 * The code may be subjected to the GNU General Public License, Version 2,
 * and re-distributed under the terms of this license.
 * As a special exception, permission is granted to link this code
 * with the Qt library and distribute executables, as long as you
 * follow the requirements of the GNU GPL in regard to all of the
 * software in the executable aside from Qt.
 *
 * Commercial use other than under the terms of the GNU General Public
 * License is allowed only after express negotiation of conditions
 * with the authors.
 */
#ifndef SDP_SESSION_DESCRIPTION_H
#define SDP_SESSION_DESCRIPTION_H

#include "MNString.h"
#include "MNList.h"
#include "MNArrayList.h"
#include "MNValid.h"
#include "TimeDefs.h"
#include "SDPMediaDescription.h"

class SDPSessionDescription
{
    DECLARE_VALID
private:
    bool      _ok;
    MNString* _version;
    MNString* _origin;
    MNString* _session_name;
    MNString* _information;
    MNString* _uri;
    MNString* _email;
    MNString* _phone;

    MNString*         connection_field;
    SDP::Bandwidths   _bandwidths;
    MNList<MNString>* time_fields;
    MNList<MNString>* repeat_fields;
    MNString*         key_field;

    ParseTimeRange*   _a_range;
    MNList<MNString>* attribute_fields;

    MDescList* _mdescs;

public:

  SDPSessionDescription();
  SDPSessionDescription( const MNString& sdptext );
  SDPSessionDescription( const SDPSessionDescription& orig );
  virtual ~SDPSessionDescription();

  inline bool ok() const { return _ok; }

  SDPSessionDescription& operator=( const SDPSessionDescription& orig );

  void setField( SDP::SessionFieldName fn, const MNString& in );
  void setField( SDP::SessionFieldName fn, const char* in );

  void setConnection( const MNString& in );
  void setConnection( const char* in );

  void insertTime( const MNString& in );
  void insertTime( const char* in );

  void insertRepeat( const MNString& in );
  void insertRepeat( const char* in );

  void setKey( const MNString& in );
  void setKey( const char* in );

  void setRangeAttribute( ParseTimeRange*& in );

  void insertAttribute( const MNString& in );
  void insertAttribute( const char* in );

  void setMediaDescriptionList( MDescList* in );

  bool hasVersion( ) const;
  const MNString& getVersion();

  bool hasOrigin( ) const;
  const MNString& getOrigin() const;

  bool hasSessionName( ) const;
  const MNString& getSessionName() const;

  bool hasInformation( ) const;
  const MNString& getInformation() const;

  bool hasURI( ) const;
  const MNString& getURI() const;

  bool hasEmail( ) const;
  const MNString& getEmail() const;

  bool hasPhone( ) const;
  const MNString& getPhone() const;

  bool hasARange( ) const;
  const ParseTimeRange& getARange() const;

  bool hasConnection( int idx ) const;

  MNString getConnection( int idx ) const;

  MNString getConnectionAddress( int idx ) const;

    void   addBandwidth( const char* in );

    bool   hasASBandwidth( int idx = -1 ) const;

    size_t getASBandwidth( int idx = -1 ) const;

private:
    bool hasTime( ) const;
    const MNList<MNString>& getTimes() const;

public:
  bool hasRepeat( );
  const MNList<MNString>& getRepeats() const;

  bool hasKey( );
  const MNString& getKey() const;

  bool hasAttributes( );
  const MNList<MNString>& getAttributes() const;

  bool     hasANYAttribute( const char* name );
  bool     getANYAttribute( const char* attributeName, MNString& value );

  bool     hasPatchAttribute();
  MNString getPatchAttribute();
  void     getPatchRange( int& start, int& stop );

  bool     hasStreamIdAttribute();
  bool     hasLCRTPAttribute();

  bool     hasFramerateAttribute();
  MNString getFramerateAttribute();

  bool hasMediaDescription( );
  int  getMediaDescriptionCount() const;
  void getMediaDescriptions( MDescList& inout ) const;
  const MDescList& getMediaDescriptionArray() const;
  MDescList&       getMediaDescriptionArray();

  int getMainConnection( MNString& host );

    ParseTimeRange* getPlayDuration( ) const;

  int dump( MNString& desc );

  MNString toString();
private:
    void private_copy( const SDPSessionDescription& orig );
    void private_clear( );

    MDescPtr media( int idx ) const;
};

#endif

---