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

流媒体/Mpeg4/MP4

开发平台:

C/C++

  1. #if !defined(IPADDRESS_DOT_H)
  2. #define IPADDRESS_DOT_H
  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 IPAddress_hxx_Version = 
  53.     "$Id: IPAddress.hxx,v 1.20 2001/04/11 19:55:02 icahoon Exp $";
  54. #include "TransportAddress.hxx"
  55. #include <netinet/in.h>
  56. #include <string>
  57. /** Infrastructure common to VOCAL.
  58.  */
  59. namespace Vocal 
  60. {
  61. class SystemException;
  62. /** Infrastructure in VOCAL related to making network transport layer 
  63.  *  connections.<br><br>
  64.  */
  65. namespace Transport 
  66. {
  67. /** IP version 4 style address, extends TransportAddress.<br><br>
  68.  *
  69.  *  @see    Vocal::Transport::TransportAddress
  70.  *  @see    Vocal::Transport::IP6Address
  71.  *  @see    Vocal::Transport::AddressFamily
  72.  *  @see    Vocal::Transport::Socket
  73.  *  @see    Vocal::SystemException
  74.  */
  75. class IPAddress : public Vocal::Transport::TransportAddress
  76. {
  77.     public:
  78.      /** Construct given the optional port number.
  79.  */
  80. IPAddress(u_int16_t       port = 0);
  81.      /** Construct given the ip in dotted decimal, C string format,
  82.  *  and an optional port.
  83.  */
  84. IPAddress(const char      * ip,
  85.   u_int16_t       port = 0);
  86.      /** Construct given the ip in an array of octets, each octet
  87.  *  representing a portion of the address and an optional port.
  88.  *  <br><br>
  89.  *
  90.  *  Note that the size of the array must be at least 4 bytes long,
  91.  *  otherwise the operation is unknown, aka don't call me if
  92.  *  it crashes in this code thanks to a bogus array that you passed
  93.  *  in.
  94.  */
  95. IPAddress(const u_int8_t    *   ip,
  96.   u_int16_t       port = 0);
  97.      /** Construct given an ip as a host ordered long, and a port.
  98.  */
  99. IPAddress(u_int32_t          ip,
  100.   u_int16_t       port);
  101.      /** Construct given a sockaddr_in.
  102.  */
  103. IPAddress(const sockaddr_in &   inAddr);
  104.      /** Copy constructor.
  105.  */
  106. IPAddress(const IPAddress &);
  107.     
  108.      /** Virtual destructor.
  109.  */
  110. virtual ~IPAddress();
  111. /** Assignment operator
  112.  */
  113. IPAddress &       operator=(const IPAddress &);
  114.      /** Factory method. clone the current address.
  115.  */
  116. virtual TransportAddress  * clone() const;
  117.      /** Set the socket address.
  118.  */
  119.      virtual void      setAddress(sockaddr *);
  120. /** Set the address by sockaddr_in
  121.  */
  122. void           setIPAddress(const sockaddr_in &);
  123. /** Set IP portion of address by dotted decimal, C string.
  124.  */
  125. void           setIP(const char *);
  126. /** Set IP portion of address by octet sting. Must be at least
  127.  *  4 octets long.
  128.  */
  129. void           setIP(const u_int8_t *);
  130. /** Set IP portion of address by host ordered unsigned long.
  131.  */
  132. void           setIP(u_int32_t);
  133. /** Set port portion of address.
  134.  */
  135. void           setPort(u_int16_t);
  136.     
  137. /** Get IP portion of the address by dotted decimal notation.
  138.  */
  139. string           getIPAsString() const;
  140. /** Get IP portion of the address by octet sting. 
  141.  *  Assuming dst points to 4-byte memory area.
  142.  */
  143. void              getIPAsOctetString(u_int8_t* dst) const;
  144. /** Get IP portion of the address as host ordered unsigned long.
  145.  */
  146. u_int32_t               getIPAsULong() const;
  147. /** Get IP and port  by dotted decimal notation followed by a colon
  148.  *  followed by a port, e.g. "192.168.5.23:1719".
  149.  */
  150.      string           getIPAndPortAsString() const;
  151.      /** Get the address in the form of a sockaddr.
  152.  */
  153.      virtual sockaddr *   getAddress() const;
  154.      /** Get the entire address as a sockaddr_in.
  155.  */
  156.      const sockaddr_in & getIPAddress() const;
  157.      /** Get the native sockaddr's length.
  158.  */
  159.     virtual socklen_t    getAddressLength() const;
  160. /** Get the port portion of the address.
  161.  */
  162. u_int16_t         getPort() const;
  163.      /** Update the address from the socket.
  164.  */
  165. virtual void      updateAddress(const Socket &)
  166.                     throw ( Vocal::SystemException );
  167.      /** Equality relational operator
  168.  */
  169. bool           operator==(const IPAddress &) const;
  170.      /** Inequality relational operator
  171.  */
  172. bool           operator!=(const IPAddress &) const;
  173.      /** Less than relational operator
  174.  */
  175. bool           operator<(const IPAddress &) const;
  176.      /** Less than  or equal to relational operator
  177.  */
  178. bool           operator<=(const IPAddress &) const;
  179.      /** Greater than relational operator
  180.  */
  181. bool           operator>(const IPAddress &) const;
  182.      /** Greater than or equal to relational operator
  183.  */
  184. bool           operator>=(const IPAddress &) const;
  185.      /** Returns true if the addr portion is INADDR_ANY and the
  186.       *  port is zero.
  187.  */
  188.      bool           isAny() const;
  189.      /** Print the address to a stream.
  190.  */
  191. ostream &      writeTo(ostream &) const;
  192.     private:
  193.      char *           inetNtoa(const struct in_addr & in, char *) const;
  194.     
  195.      mutable sockaddr_in  inAddr_;
  196.         
  197.         char                    separationChar_;
  198. };
  199. } // namespace Transport
  200. } // namespace Vovida
  201. #endif // !defined(IPADDRESS_DOT_H)