ACE学习手记----ACE_INET_Addr类

ACE_INET_Addr类，在这个ACE_网络框架中，应该是比较重要的辅助类，该类主要封装了C SOCKET 的地址对象，通过外观封装的模式，把struct sockaddr_in封装在内。方便用户的操作。 

 

因此个人认为掌握此类的常用构造方法和常用的成员函数，并深刻的理解，对于后续的学习ACE或者开发ACE网络应用程序应该会起到很大的帮助。工欲用其器、必先利其器。就先让我们把ACE_INET_Addr对象深刻的牢记在心中吧。

1. /* -*- C++ -*- */
3. //=============================================================================
4. /**
5.  *  @file    INET_Addr.h
6.  *
7.  *  $Id: INET_Addr.h 78617 2007-06-27 20:40:19Z mesnier_p $
8.  *
9.  *  @author Douglas C. Schmidt <schmidt@cs.wustl.edu>
10.  */
11. //=============================================================================
13. #ifndef ACE_INET_ADDR_H
14. #define ACE_INET_ADDR_H
15. #include /**/ "ace/pre.h"
17. #include "ace/Sock_Connect.h"
19. #if !defined (ACE_LACKS_PRAGMA_ONCE)
20. # pragma once
21. #endif /* ACE_LACKS_PRAGMA_ONCE */
23. #include "ace/Addr.h"
25. #if defined(ACE_VXWORKS)
26.    // Needed to get INET_ADDR_LEN
27. #  include /**/ "inetLib.h"
28. #endif /* ACE_VXWORKS */
30. ACE_BEGIN_VERSIONED_NAMESPACE_DECL
32. /**
33.  * @class ACE_INET_Addr
34.  *
35.  * @brief Defines a C++ wrapper facade for the Internet domain address
36.  * family format.
37.  */
38. class ACE_Export ACE_INET_Addr : public ACE_Addr
39. {
40. public:
41.   // = Initialization methods.
43.   /// Default constructor.
44.   /// 默认构造函数
45.   ACE_INET_Addr (void);
47.   /// Copy constructor.
48.   /// 拷贝构造函数
49.   ACE_INET_Addr (const ACE_INET_Addr &);
51.   /// Creates an ACE_INET_Addr from a sockaddr_in structure.
52.   /// 使用参数@addr 地址初始化ACE_INET_Addr对象。
53.   /// 参数@len 为 @addr结构地址对象的长度，使用 sizeof(strcut sockaddr_in)
54.   ACE_INET_Addr (const sockaddr_in *addr, int len);
56.   /// Creates an ACE_INET_Addr from a <port_number> and the remote
57.   /// <host_name>. The port number is assumed to be in host byte order.
58.   /// To set a port already in network byte order, please @see set().
59.   /// Use address_family to select IPv6 (PF_INET6) vs. IPv4 (PF_INET).
60.   /// 使用参数 @port_number 和 host_name 构造一个ACE_INET_Addr对象。
61.   /// @port_number应该为主机字节序，构造函数需要把它转换了网络字节序。
62.   /// 如果port_number为网络字节序，请使用 set成员函数或者set_port_number成员函数。
63.   /// @address_family 用于指定ACE_INET_Addr的地址类型PF_INET(IPv4)或者PF_INET6(IPv6)
64.   ACE_INET_Addr (u_short port_number,
65.                  const char host_name[],
66.                  int address_family = AF_UNSPEC);
68.   /**
69.    * Initializes an ACE_INET_Addr from the <address>, which can be
70.    * "ip-number:port-number" (e.g., "tango.cs.wustl.edu:1234" or
71.    * "128.252.166.57:1234").  If there is no ':' in the <address> it
72.    * is assumed to be a port number, with the IP address being
73.    * INADDR_ANY.
74.    * 使用参数@address初始化一个ACE_INET_Addr对象。
75.    * address的格式为 ip-number:port-number 或者 port-number.
76.    * ip-number 可以为点分号的IP地址，也可是是域名地址。
77.    * 如果参数@address没有提供 ip-number，只提供port-number时，地址被初始化为INADDR_ANY
78.    * port-number 为主机字节序。
79.    */
80.   explicit ACE_INET_Addr (const char address[],
81.                           int address_family = AF_UNSPEC);
83.   /**
84.    * Creates an ACE_INET_Addr from a <port_number> and an Internet
85.    * <ip_addr>.  This method assumes that <port_number> and <ip_addr>
86.    * are in host byte order. If you have addressing information in
87.    * network byte order, @see set().
88.    * 使用主机字节序的@port_number 和 @ip_addr初始化一个ACE_INET_Addr对象。
89.    * 如port_number或者 ip_addr为网络字节序时，请使用 set成员函数。
90.    */
91.   explicit ACE_INET_Addr (u_short port_number,
92.                           ACE_UINT32 ip_addr = INADDR_ANY);
94.   /// Uses <getservbyname> to create an ACE_INET_Addr from a
95.   /// <port_name>, the remote <host_name>, and the <protocol>.
96.   /// 通过 getservbyname API获得port_name的端口，eg port_name="ftp"时，得到的端口是21.
97.   ACE_INET_Addr (const char port_name[],
98.                  const char host_name[],
99.                  const