cdsa/cdsa_utilities/url.h

   1 /*
   2  * Copyright (c) 2000-2001 Apple Computer, Inc. All Rights Reserved.
   3  *
   4  * The contents of this file constitute Original Code as defined in and are
   5  * subject to the Apple Public Source License Version 1.2 (the 'License').
   6  * You may not use this file except in compliance with the License. Please obtain
   7  * a copy of the License at http://www.apple.com/publicsource and read it before
   8  * using this file.
   9  *
  10  * This Original Code and all software distributed under the License are
  11  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS
  12  * OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, INCLUDING WITHOUT
  13  * LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
  14  * PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. Please see the License for the
  15  * specific language governing rights and limitations under the License.
  16  */
  17
  18
  19 //
  20 // url - URL object with decomposition
  21 //
  22 // This is a wrapper around CoreFoundation CFURL objects,
  23 // without any attempt at re-interpretation (other than cleaning
  24 // up the obvious CFishness).
  25 //
  26 #ifndef _H_URL
  27 #define _H_URL
  28
  29 #include <string>
  30 #include "ip++.h"
  31
  32
  33 struct __CFURL;
  34 using IPPlusPlus::IPPort;
  35
  36
  37 namespace Security {
  38 namespace Network {
  39
  40
  41 //
  42 // A thin encapsulation of a URL
  43 //
  44 class URL {
  45 public:
  46     URL();
  47     URL(const char *url);
  48     URL(const char *url, const URL &base);
  49     ~URL();
  50
  51     operator string() const;
  52
  53     string scheme() const;
  54     string host() const;
  55     IPPort port(IPPort defaultPort = 0) const;
  56     string path() const;
  57     string resourceSpec() const;
  58     string fullPath() const;
  59
  60     string username() const;
  61     string password() const;
  62     string basename() const;
  63     string extension() const;
  64
  65     void recreateURL(const char* url);
  66
  67 private:
  68     const __CFURL *ref;
  69 };
  70
  71
  72 }       // end namespace Network
  73 }       // end namespace Security
  74
  75
  76 #endif _H_URL