nsprpub/pr/src/cplus/rcnetdb.h

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
   2 /* ***** BEGIN LICENSE BLOCK *****
   3  * Version: MPL 1.1/GPL 2.0/LGPL 2.1
   4  *
   5  * The contents of this file are subject to the Mozilla Public License Version
   6  * 1.1 (the "License"); you may not use this file except in compliance with
   7  * the License. You may obtain a copy of the License at
   8  * http://www.mozilla.org/MPL/
   9  *
  10  * Software distributed under the License is distributed on an "AS IS" basis,
  11  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
  12  * for the specific language governing rights and limitations under the
  13  * License.
  14  *
  15  * The Original Code is the Netscape Portable Runtime (NSPR).
  16  *
  17  * The Initial Developer of the Original Code is
  18  * Netscape Communications Corporation.
  19  * Portions created by the Initial Developer are Copyright (C) 1998-2000
  20  * the Initial Developer. All Rights Reserved.
  21  *
  22  * Contributor(s):
  23  *
  24  * Alternatively, the contents of this file may be used under the terms of
  25  * either the GNU General Public License Version 2 or later (the "GPL"), or
  26  * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
  27  * in which case the provisions of the GPL or the LGPL are applicable instead
  28  * of those above. If you wish to allow use of your version of this file only
  29  * under the terms of either the GPL or the LGPL, and not to allow others to
  30  * use your version of this file under the terms of the MPL, indicate your
  31  * decision by deleting the provisions above and replace them with the notice
  32  * and other provisions required by the GPL or the LGPL. If you do not delete
  33  * the provisions above, a recipient may use your version of this file under
  34  * the terms of any one of the MPL, the GPL or the LGPL.
  35  *
  36  * ***** END LICENSE BLOCK ***** */
  37
  38 /*
  39 ** Base class definitions for network access functions (ref: prnetdb.h)
  40 */
  41
  42 #if defined(_RCNETDB_H)
  43 #else
  44 #define _RCNETDB_H
  45
  46 #include "rclock.h"
  47 #include "rcbase.h"
  48
  49 #include <prnetdb.h>
  50
  51 class PR_IMPLEMENT(RCNetAddr): public RCBase
  52 {
  53 public:
  54     typedef enum {
  55         any = PR_IpAddrAny,             /* assign logical INADDR_ANY */
  56         loopback = PR_IpAddrLoopback    /* assign logical INADDR_LOOPBACK */
  57     } HostValue;
  58
  59     RCNetAddr();                        /* default constructor is unit'd object */
  60     RCNetAddr(const RCNetAddr&);        /* copy constructor */
  61     RCNetAddr(HostValue, PRUint16 port);/* init'd w/ 'special' assignments */
  62     RCNetAddr(const RCNetAddr&, PRUint16 port);
  63                                         /* copy w/ port reassigment */
  64
  65     virtual ~RCNetAddr();
  66
  67     void operator=(const RCNetAddr&);
  68
  69     virtual PRBool operator==(const RCNetAddr&) const;
  70                                         /* compare of all relavent fields */
  71     virtual PRBool EqualHost(const RCNetAddr&) const;
  72                                         /* compare of just host field */
  73
  74
  75 public:
  76
  77     void operator=(const PRNetAddr*);   /* construction from more primitive data */
  78     operator const PRNetAddr*() const;  /* extraction of underlying representation */
  79     virtual PRStatus FromString(const char* string);
  80                                         /* initialization from an ASCII string */
  81     virtual PRStatus ToString(char *string, PRSize size) const;
  82                                         /* convert internal fromat to a string */
  83
  84 private:
  85
  86     PRNetAddr address;
  87
  88 };  /* RCNetAddr */
  89
  90 /*
  91 ** Class: RCHostLookup
  92 **
  93 ** Abstractions to look up host names and addresses.
  94 **
  95 ** This is a stateful class. One looks up the host by name or by
  96 ** address, then enumerates over a possibly empty array of network
  97 ** addresses. The storage for the addresses is owned by the class.
  98 */
  99
 100 class RCHostLookup: public RCBase
 101 {
 102 public:
 103     virtual ~RCHostLookup();
 104
 105     RCHostLookup();
 106
 107     virtual PRStatus ByName(const char* name);
 108     virtual PRStatus ByAddress(const RCNetAddr&);
 109
 110     virtual const RCNetAddr* operator[](PRUintn);
 111
 112 private:
 113     RCLock ml;
 114     PRIntn max_index;
 115     RCNetAddr* address;
 116
 117     RCHostLookup(const RCHostLookup&);
 118     RCHostLookup& operator=(const RCHostLookup&);
 119 };
 120
 121 inline RCNetAddr::RCNetAddr(): RCBase() { }
 122 inline RCNetAddr::operator const PRNetAddr*() const { return &address; }
 123
 124
 125 #endif /* defined(_RCNETDB_H) */
 126
 127 /* RCNetdb.h */
 128
 129