summaryrefslogtreecommitdiff
path: root/ACE/examples/Web_Crawler/URL_Addr.h
diff options
context:
space:
mode:
Diffstat (limited to 'ACE/examples/Web_Crawler/URL_Addr.h')
-rw-r--r--ACE/examples/Web_Crawler/URL_Addr.h120
1 files changed, 120 insertions, 0 deletions
diff --git a/ACE/examples/Web_Crawler/URL_Addr.h b/ACE/examples/Web_Crawler/URL_Addr.h
new file mode 100644
index 00000000000..b864ae26a81
--- /dev/null
+++ b/ACE/examples/Web_Crawler/URL_Addr.h
@@ -0,0 +1,120 @@
+// -*- C++ -*-
+
+
+//=============================================================================
+/**
+ * @file URL_Addr.h
+ *
+ * $Id$
+ *
+ * @author Douglas C. Schmidt <schmidt@cs.wustl.edu>
+ */
+//=============================================================================
+
+
+#ifndef ACE_URL_ADDR_H
+#define ACE_URL_ADDR_H
+
+#include "ace/INET_Addr.h"
+
+#if !defined (ACE_LACKS_PRAGMA_ONCE)
+#pragma once
+#endif /* ACE_LACKS_PRAGMA_ONCE */
+
+#include "ace/ACE.h"
+
+/**
+ * @class ACE_URL_Addr
+ *
+ * @brief Defines a URL address family address format.
+ */
+class ACE_URL_Addr : public ACE_INET_Addr
+{
+public:
+ // = Initialization and termination methods.
+ /// Constructor.
+ ACE_URL_Addr (void);
+
+ ACE_URL_Addr (const ACE_TCHAR *host_name,
+ const ACE_TCHAR *path_name,
+ u_short port = ACE_DEFAULT_HTTP_PORT);
+
+ /// Copy constructor.
+ ACE_URL_Addr (const ACE_URL_Addr &addr);
+
+ /// Essentially the copy constructor.
+ int set (const ACE_URL_Addr &addr);
+
+ /**
+ * Initializes an <ACE_URL_Addr> from the <address>, which can be
+ * "ip-number:port-number/path-name" (e.g.,
+ * "www.cs.wustl.edu:1234/~schmidt/" "ip-number:port-number/path-name"
+ * (e.g., "128.252.166.57:1234/~schmidt"). If there is no ':' in
+ * the <address> it is assumed to be an ip-number or ip-address
+ * number, with the port number <ACE_DEFAULT_HTTP_PORT>.
+ */
+ virtual int string_to_addr (const ACE_TCHAR *address,
+ int address_family = AF_UNSPEC);
+
+ /**
+ * Transform the current <ACE_INET_Addr> address into string format.
+ * If <ipaddr_format> is non-0 this produces
+ * "ip-number:port-number/path-name" (e.g.,
+ * "128.252.166.57:80/~schmidt/"), whereas if <ipaddr_format> is 0
+ * this produces "ip-name:port-number" (e.g.,
+ * "www.cs.wustl.edu:80/~schmidt/"). Returns -1 if the <size> of
+ * the <buffer> is too small, else 0.
+ */
+ virtual int addr_to_string (ACE_TCHAR *s,
+ size_t size,
+ int ipaddr_format = 1) const;
+
+ /**
+ * Transform the current <ACE_INET_Addr> address into string format.
+ * If <ipaddr_format> is non-0 this produces
+ * "ip-number:port-number/path-name" (e.g.,
+ * "128.252.166.57:80/~schmidt/"), whereas if <ipaddr_format> is 0
+ * this produces "ip-name:port-number" (e.g.,
+ * "www.cs.wustl.edu:80/~schmidt/"). Uses dynamic memory, which
+ * is allocated on demand and deallocated when the object is
+ * destroyed. Returns -1 if dynamic memory fails, else 0.
+ */
+ virtual const ACE_TCHAR *addr_to_string (int ipaddr_format = 1) const;
+
+ /// Assignment operator.
+ void operator= (const ACE_URL_Addr &addr);
+
+ /// Destructor.
+ ~ACE_URL_Addr (void);
+
+ /**
+ * Compare two addresses for equality. The addresses are considered
+ * equal if they contain the same IP address, port number, and path
+ * name.
+ */
+ bool operator == (const ACE_URL_Addr &SAP) const;
+
+ /// Compare two addresses for inequality.
+ bool operator != (const ACE_URL_Addr &SAP) const;
+
+ /// Computes and returns hash value.
+ virtual u_long hash (void) const;
+
+ /// Return the path name.
+ const ACE_TCHAR *get_path_name (void) const;
+
+ /// Commit suicide.
+ int destroy (void);
+private:
+ /// Our path name.
+ ACE_TCHAR *path_name_;
+
+ /// The dynamically address string that's used for the
+ /// <addr_to_string> method.
+ ACE_TCHAR *addr_string_;
+
+ /// Current length of the <addr_string_>
+ size_t addr_string_len_;
+};
+
+#endif /* ACE_URL_ADDR_H */