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

流媒体/Mpeg4/MP4

开发平台:

C/C++

  1. #if !defined(VOCAL_DATAGRAM_SOCKET_HXX)
  2. #define VOCAL_DATAGRAM_SOCKET_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 $1,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 DatagramSocket_hxx_Version = 
  53.     "$Id: DatagramSocket.hxx,v 1.18 2001/06/26 22:54:22 icahoon Exp $";
  54. #include "Socket.hxx"
  55. #include "Sptr.hxx"
  56. #include "TransportAddress.hxx"
  57. #include "SystemException.hxx"
  58. #include "SystemStatus.hxx"
  59. #include <string>
  60. #include <vector>
  61. /** Infrastructure common to VOCAL.
  62.  */
  63. namespace Vocal 
  64. {
  65. /** Infrastructure in VOCAL related to making network transport layer 
  66.  *  connections.<br><br>
  67.  */
  68. namespace Transport 
  69. {
  70. /** Datagram socket is a connection-oriented or connectionless
  71.  *  abstraction for unreliable message transport.<br><br>
  72.  *
  73.  *  @see    Vocal::Transport::UDPSocket
  74.  *  @see    Vocal::Transport::Socket
  75.  *  @see    Vocal::Transport::TransportAddress
  76.  *  @see    Vocal::Transport::AddressFamily
  77.  *  @see    Vocal::Transport::SocketType
  78.  *  @see    Vocal::SystemException
  79.  *  @see    Vocal::SystemStatus
  80.  */
  81. class DatagramSocket : public Vocal::Transport::Socket
  82. {
  83.     protected:
  84.      /** Construct given the addressFamily and the name.
  85.  */
  86.      DatagramSocket(const AddressFamily & addressFamily,
  87.        const char * name = 0)
  88.           throw ( Vocal::SystemException );
  89.      /** Construct given the local transport address and name.
  90.  */
  91.      DatagramSocket(const TransportAddress & localAddr,
  92.        const char * name = 0)
  93.           throw ( Vocal::SystemException );
  94.      /** Construct given the local transport address, the remote address
  95.  *  and name. Binds to the local address and connects to the remote 
  96.  *  address.
  97.  */
  98.      DatagramSocket(const TransportAddress & localAddr,
  99.        const TransportAddress & remoteAddr,
  100.        const char * name = 0)
  101.           throw ( Vocal::SystemException );
  102.     public:    
  103.      /** Virtual destructor
  104.  */
  105. virtual ~DatagramSocket();
  106.      /** To create a connection oriented circuit.
  107.  *  If connect() is used, send() and receive()
  108.  *  will interact with the specified remote address.
  109.  */
  110.      void connect(const TransportAddress & remoteAddr)
  111.      throw ( Vocal::SystemException );
  112.      /** To dissolve the connect oriented circuit.
  113.  */
  114.      void disconnect()
  115. throw ( Vocal::SystemException );
  116.      /** Text version of a connection oriented send. 
  117.  *  Use connect() first. This will transmit the 
  118.  *  string to the remote address specified in connect().
  119.  *  Returns the number of bytes sent. If 0 was returned, 
  120.  *  there either was an empty message to send. If 
  121.  *  a SystemStatus was thrown, the socket was set 
  122.  *  non-blocking and it would have blocked (status EAGAIN), 
  123.  *  or the socket was set blocking and it was interrupted 
  124.  *  by a signal (status EINTR). 
  125.  */
  126.      int  send(const string &)
  127.     throw ( Vocal::SystemException, Vocal::SystemStatus );
  128.      /** See send(const string &).
  129.  */
  130.      int  send(const char *)
  131.     throw ( Vocal::SystemException, Vocal::SystemStatus );
  132.      /** Binary version of a connection oriented send. 
  133.  *  See send(const string &)
  134.  */
  135.      int  send(const vector<u_int8_t> &)
  136.     throw ( Vocal::SystemException, Vocal::SystemStatus );
  137.      /** Binary version of a connection oriented send. 
  138.  *  See send(const string &)
  139.  */
  140.      int  send(const u_int8_t *, size_t)
  141.     throw ( Vocal::SystemException, Vocal::SystemStatus );
  142.      /** Text version of a connectionless send. 
  143.  *  This will transmit the string to the remote address.
  144.  *  See send(const string &) for return semantics.
  145.  */
  146.      int  sendTo(
  147.     const string &, 
  148.     const TransportAddress & remoteAddress
  149. )
  150.     throw ( Vocal::SystemException, Vocal::SystemStatus );
  151.      /** Text version of a connectionless send. 
  152.  *  This will transmit the string to the remote address.
  153.  *  See send(const string &) for return semantics.
  154.  */
  155.      int  sendTo( 
  156.     const char *, 
  157.     const TransportAddress & remoteAddress
  158. )
  159.     throw ( Vocal::SystemException, Vocal::SystemStatus );
  160.      /** Binary version of a connectionless send. 
  161.       *  See sendTo(const string &, const TransportAddress &).
  162.  */
  163.      int  sendTo( 
  164.     const vector<u_int8_t> &,
  165.               const TransportAddress & remoteAddress
  166. )
  167.               throw ( Vocal::SystemException, Vocal::SystemStatus );
  168.      /** Binary version of a connectionless send. 
  169.       *  See sendTo(const string &, const TransportAddress &).
  170.  */
  171.      int  sendTo( 
  172.          const u_int8_t *, size_t,
  173.     const TransportAddress & remoteAddress
  174. )
  175.               throw ( Vocal::SystemException, Vocal::SystemStatus );
  176.      /** Text version of a connection oriented receive. 
  177.  *  Use connect() first. This will receive the 
  178.  *  string from the remote address specified in connect().
  179.  *  Returns the number of received bytes. If a SystemStatus
  180.  *  was thrown either the socket was set non-blocking and it
  181.  *  would have blocked (status EAGAIN), or the socket was set 
  182.  *  blocking and it was interrupted by a signal (status EINTR). 
  183.  */
  184.      int  receive(string &)
  185.               throw ( Vocal::SystemException, Vocal::SystemStatus );
  186.      /** Text version of a connection oriented receive. 
  187.  *  See receiver(string &)
  188.  */
  189.      int  receive(char *, size_t)
  190.               throw ( Vocal::SystemException, Vocal::SystemStatus );
  191.      /** Binary version of a connection oriented receive. 
  192.  *  See receive(string &).
  193.  */
  194.      int  receive(vector<u_int8_t> &)
  195.               throw ( Vocal::SystemException, Vocal::SystemStatus );
  196.      /** Binary version of a connection oriented receive. 
  197.  *  See receive(string &).
  198.  */
  199.      int  receive(u_int8_t *, size_t)
  200.               throw ( Vocal::SystemException, Vocal::SystemStatus );
  201.      /** Text version of a connectionless receive. 
  202.  *  This will receive the string from the remote address.
  203.  *  See receive(string &) for return semantics.
  204.  */
  205.      int  receiveFrom(
  206.     string &, 
  207.     TransportAddress & remoteAddress
  208. )
  209.               throw ( Vocal::SystemException, Vocal::SystemStatus );
  210.      /** Text version of a connectionless receive. 
  211.  *  This will receive the string from the remote address.
  212.  *  See receive(string &) for return semantics.
  213.  */
  214.      int  receiveFrom(
  215.     char *, size_t,
  216.     TransportAddress & remoteAddress
  217. )
  218.               throw ( Vocal::SystemException, Vocal::SystemStatus );
  219.      /** Binary version of a connectionless receive. 
  220.  *  See receiveFrom(string &, Sptr<TransportAddress> &).
  221.  */
  222.      int  receiveFrom( 
  223.     vector<u_int8_t> &,
  224.     TransportAddress & remoteAddress
  225. )
  226.               throw ( Vocal::SystemException, Vocal::SystemStatus );
  227.      /** Binary version of a connectionless receive. 
  228.  *  See receiveFrom(string &, Sptr<TransportAddress> &).
  229.  */
  230.      int  receiveFrom( 
  231.     u_int8_t *, size_t,
  232.     TransportAddress & remoteAddress
  233. )
  234.               throw ( Vocal::SystemException, Vocal::SystemStatus );
  235.      /** If connected, this will return a pointer to the 
  236.  *  remote address. Otherwise 0 will be returned.
  237.  */
  238.      Sptr<TransportAddress>      getRemoteAddress() const;
  239.      /** Write the DatagramSocket to an ostream.
  240.  */
  241. virtual ostream &            writeTo(ostream &) const;
  242.     private:
  243.      int  sendMessage(void *, int length, const TransportAddress *)
  244.               throw ( Vocal::SystemException, Vocal::SystemStatus );
  245.      int  recvMessage(void *, int length, TransportAddress *)
  246.               throw ( Vocal::SystemException, Vocal::SystemStatus );
  247.           Sptr<TransportAddress>     remoteAddr_;
  248. bool               localAddrUpdated_;
  249. };
  250. } // namespace Transport
  251. } // namespace Vocal
  252. #endif // !defined(VOCAL_DATAGRAM_SOCKET_HXX)