RtspTransportHdr.hxx
上传用户:sy_wanhua
上传日期:2013-07-25
资源大小:3048k
文件大小:7k
源码类别:

流媒体/Mpeg4/MP4

开发平台:

C/C++

  1. #ifndef RtspTransportHdr_hxx
  2. #define RtspTransportHdr_hxx
  3. /* ====================================================================
  4.  * The Vovida Software License, Version 1.0 
  5.  * 
  6.  * Copyright (c) 2000 Vovida Networks, Inc.  All rights reserved.
  7.  * 
  8.  * Redistribution and use in source and binary forms, with or without
  9.  * modification, are permitted provided that the following conditions
  10.  * are met:
  11.  * 
  12.  * 1. Redistributions of source code must retain the above copyright
  13.  *    notice, this list of conditions and the following disclaimer.
  14.  * 
  15.  * 2. Redistributions in binary form must reproduce the above copyright
  16.  *    notice, this list of conditions and the following disclaimer in
  17.  *    the documentation and/or other materials provided with the
  18.  *    distribution.
  19.  * 
  20.  * 3. The names "VOCAL", "Vovida Open Communication Application Library",
  21.  *    and "Vovida Open Communication Application Library (VOCAL)" must
  22.  *    not be used to endorse or promote products derived from this
  23.  *    software without prior written permission. For written
  24.  *    permission, please contact vocal@vovida.org.
  25.  *
  26.  * 4. Products derived from this software may not be called "VOCAL", nor
  27.  *    may "VOCAL" appear in their name, without prior written
  28.  *    permission of Vovida Networks, Inc.
  29.  * 
  30.  * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
  31.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  32.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
  33.  * NON-INFRINGEMENT ARE DISCLAIMED.  IN NO EVENT SHALL VOVIDA
  34.  * NETWORKS, INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT DAMAGES
  35.  * IN EXCESS OF 281421,000, NOR FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
  36.  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  37.  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  38.  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  39.  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  40.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
  41.  * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
  42.  * DAMAGE.
  43.  * 
  44.  * ====================================================================
  45.  * 
  46.  * This software consists of voluntary contributions made by Vovida
  47.  * Networks, Inc. and many individuals on behalf of Vovida Networks,
  48.  * Inc.  For more information on Vovida Networks, Inc., please see
  49.  * <http://www.vovida.org/>.
  50.  *
  51.  */
  52. static const char* const RtspTransportHdr_hxx_Version = 
  53.     "$Id: RtspTransportHdr.hxx,v 1.14 2001/05/15 20:26:12 bko Exp $";
  54. #include "Data.hxx"
  55. #include "RtspBadDataException.hxx"
  56. #include "Sptr.hxx"
  57. #include "CharDataParser.hxx"
  58. /** Grammer for Transport Header
  59.    Transport           =    "Transport" ":"
  60.                             1#transport-spec
  61.    transport-spec      =    transport-protocol/profile[/lower-transport]
  62.                             *parameter
  63.    transport-protocol  =    "RTP"
  64.    profile             =    "AVP"
  65.    lower-transport     =    "TCP" | "UDP"
  66.    parameter           =    ( "unicast" | "multicast" )
  67.                        |    ";" "destination" [ "=" address ]
  68.                        |    ";" "interleaved" "=" channel [ "-" channel ]
  69.                        |    ";" "append"
  70.                        |    ";" "ttl" "=" ttl
  71.                        |    ";" "layers" "=" 1*DIGIT
  72.                        |    ";" "port" "=" port [ "-" port ]
  73.                        |    ";" "client_port" "=" port [ "-" port ]
  74.                        |    ";" "server_port" "=" port [ "-" port ]
  75.                        |    ";" "ssrc" "=" ssrc
  76.                        |    ";" "mode" = <"> 1#mode <">
  77.    ttl                 =    1*3(DIGIT)
  78.    port                =    1*5(DIGIT)
  79.    ssrc                =    8*8(HEX)
  80.    channel             =    1*3(DIGIT)
  81.    address             =    host
  82.    mode                =    <"> *Method <"> | Method
  83.    Example:
  84.      Transport: RTP/AVP;multicast;ttl=127;mode="PLAY",
  85.                 RTP/AVP;unicast;client_port=3456-3457;mode="PLAY"
  86.  */
  87. class RtspTransportSpec
  88. {
  89.     public:
  90.         /** */
  91.         RtspTransportSpec();
  92.         /** */
  93.         RtspTransportSpec(const RtspTransportSpec& x);
  94.         /** */
  95.         ~RtspTransportSpec() {}
  96.         /** */
  97.         RtspTransportSpec& operator= (const RtspTransportSpec& x);
  98.         /** */
  99.         bool operator== (const RtspTransportSpec& x) const;
  100.         /** */
  101.         void reset();
  102.         /** */
  103.         void parse(CharDataParser& parser);
  104.         /** */
  105.         void parseProtocol(CharDataParser& paramParser);
  106.         /** */
  107.         void parseMulticastOrMode(CharDataParser& paramParser);
  108.         /** */
  109.         void parseUnicast(CharDataParser& paramParser);
  110.         /** */
  111.         void parseDestination(CharDataParser& paramParser);
  112.         /** */
  113.         void parseSource(CharDataParser& paramParser);
  114.         /** */
  115.         void parseAppend(CharDataParser& paramParser);
  116.         /** */
  117.         void parseClientPort(CharDataParser& paramParser);
  118.         /** */
  119.         Data encode();
  120.         /** if it is false then it is RTP/AVP/UDP */
  121.         bool myIsTcp; // TODO
  122.         /** if it is false then it is unicast */
  123.         bool myIsMulticast; // TODO
  124.         /** mode: If it is false, it is PLAY */
  125.         bool myIsRecord; 
  126.         /** for record: If it is false, it is overiwritten mode
  127.          *  if it is true but server is not support it, need to refuse 
  128.          *  the request
  129.          */
  130.         bool myIsAppend;
  131.         /** */
  132.         Data myDestination;
  133.         /** */
  134.         Data mySource;
  135.         //
  136. //        bool myIsInterleaved; // TODO
  137.         //
  138. //        u_int8_t myChannelA; // for interleaved
  139.         //
  140. //        u_int8_t myChannelB; // for interleaved
  141.         //
  142. //        u_int8_t myTtl; // for multicast
  143.         //
  144. //        u_int32_t myLayers; // for multicast
  145.         //
  146. //        u_int16_t myPortA; // for multicast
  147.         //
  148. //        u_int16_t myPortB; // for multicast
  149.         //
  150.         u_int16_t myClientPortA;
  151.         /** */
  152.         u_int16_t myClientPortB;
  153.         /** */
  154.         u_int16_t myServerPortA;
  155.         /** */
  156.         u_int16_t myServerPortB;
  157.         //
  158. //        u_int32_t mySSRC; // TODO
  159.     private:
  160. };
  161. class RtspTransportHdr
  162. {
  163.     public:
  164.         /** */
  165.         RtspTransportHdr()
  166.         { }
  167.         /** to check a TransportSpec, return false if it is using TCP
  168.          * or multicast or clientPort is not provided.
  169.          *
  170.          * TODO need to let server to tell if they want TCP or multicast
  171.          *
  172.          */
  173.         bool isSuitableSpec(Sptr< RtspTransportSpec > spec);
  174.         /** It is a list transport-spec, parser finds the first suitable option
  175.          *  and return it; if it couldnot find one, return 0
  176.          */
  177.         Sptr< RtspTransportSpec > parseTransportHeader(CharDataParser& 
  178.             parser); // throw (RtspBadDataException&);
  179.         /** Given a TransportSpec and append it to the exist myTransport 
  180.          * If it is empty, append "Transport:" first.
  181.          * use ',' deliminator between each spec
  182.          */
  183.         void appendTransportSpec(Sptr< RtspTransportSpec > transSpec);
  184.         /** return the exist myTransport for encoder */
  185.         Data encode() 
  186.         { if (myTransport.length() > 0)
  187.               return (myTransport + "rn"); 
  188.           else
  189.               return ""; }
  190.         
  191.     private:
  192.         /** The data for response Transport hdr */
  193.         Data myTransport;
  194. };
  195. /* Local Variables: */
  196. /* c-file-style: "stroustrup" */
  197. /* indent-tabs-mode: nil */
  198. /* c-file-offsets: ((access-label . -) (inclass . ++)) */
  199. /* c-basic-offset: 4 */
  200. /* End: */
  201. #endif