include/wx/uri.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        uri.h
   3 // Purpose:     wxURI - Class for parsing URIs
   4 // Author:      Ryan Norton
   5 // Modified By:
   6 // Created:     07/01/2004
   7 // RCS-ID:      $Id$
   8 // Licence:     wxWindows
   9 /////////////////////////////////////////////////////////////////////////////
  10
  11 #ifndef _WX_URI_H_
  12 #define _WX_URI_H_
  13
  14 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
  15 #pragma interface "uri.h"
  16 #endif
  17
  18 #include "wx/defs.h"
  19 #include "wx/object.h"
  20 #include "wx/string.h"
  21
  22 // Host Type that the server component can be
  23 enum wxURIHostType
  24 {
  25     wxURI_REGNAME,      // Host is a normal register name (www.mysite.com etc.)
  26     wxURI_IPV4ADDRESS,  // Host is a version 4 ip address (192.168.1.100)
  27     wxURI_IPV6ADDRESS,  // Host is a version 6 ip address [aa:aa:aa:aa::aa:aa]:5050
  28     wxURI_IPVFUTURE     // Host is a future ip address (wxURI is unsure what kind)
  29 };
  30
  31 // Component Flags
  32 enum wxURIFieldType
  33 {
  34     wxURI_SCHEME = 1,
  35     wxURI_USERINFO = 2,
  36     wxURI_SERVER = 4,
  37     wxURI_PORT = 8,
  38     wxURI_PATH = 16,
  39     wxURI_QUERY = 32,
  40     wxURI_FRAGMENT = 64
  41 };
  42
  43 // Miscellaneous other flags
  44 enum wxURIFlags
  45 {
  46     wxURI_STRICT = 1
  47 };
  48
  49
  50 // Generic class for parsing URIs.
  51 //
  52 // Originally based off of RFC 2396 - then
  53 // extended to meet the newer RFC 2396.bis
  54 // specifications.
  55 class WXDLLIMPEXP_BASE wxURI : public wxObject
  56 {
  57 public:
  58     wxURI();
  59     wxURI(const wxString& uri);
  60     wxURI(const wxURI& uri);
  61
  62     virtual ~wxURI();
  63
  64     const wxChar* Create(const wxString& uri);
  65
  66     bool HasScheme() const      {   return (m_fields & wxURI_SCHEME) == wxURI_SCHEME;       }
  67     bool HasUserInfo() const    {   return (m_fields & wxURI_USERINFO) == wxURI_USERINFO;   }
  68     bool HasServer() const      {   return (m_fields & wxURI_SERVER) == wxURI_SERVER;       }
  69     bool HasPort() const        {   return (m_fields & wxURI_PORT) == wxURI_PORT;           }
  70     bool HasPath() const        {   return (m_fields & wxURI_PATH) == wxURI_PATH;           }
  71     bool HasQuery() const       {   return (m_fields & wxURI_QUERY) == wxURI_QUERY;         }
  72     bool HasFragment() const    {   return (m_fields & wxURI_FRAGMENT) == wxURI_FRAGMENT;   }
  73
  74     const wxString& GetScheme() const           {   return m_scheme;    }
  75     const wxString& GetPath() const             {   return m_path;      }
  76     const wxString& GetQuery() const            {   return m_query;     }
  77     const wxString& GetFragment() const         {   return m_fragment;  }
  78     const wxString& GetPort() const             {   return m_port;      }
  79     const wxString& GetUserInfo() const         {   return m_userinfo;  }
  80     const wxString& GetServer() const           {   return m_server;    }
  81     const wxURIHostType& GetHostType() const    {   return m_hostType;  }
  82
  83     //Note that the following two get functions are explicitly depreciated by RFC 2396
  84     wxString GetUser() const;
  85     wxString GetPassword() const;
  86
  87     wxString BuildURI() const;
  88     wxString BuildUnescapedURI() const;
  89
  90     void Resolve(const wxURI& base, int flags = wxURI_STRICT);
  91     bool IsReference() const;
  92
  93     wxURI& operator = (const wxURI& uri);
  94     wxURI& operator = (const wxString& string);
  95     bool operator == (const wxURI& uri) const;
  96
  97     static wxString Unescape (const wxString& szEscapedURI);
  98
  99 protected:
 100     wxURI& Assign(const wxURI& uri);
 101
 102     void Clear();
 103
 104     const wxChar* Parse          (const wxChar* uri);
 105     const wxChar* ParseAuthority (const wxChar* uri);
 106     const wxChar* ParseScheme    (const wxChar* uri);
 107     const wxChar* ParseUserInfo  (const wxChar* uri);
 108     const wxChar* ParseServer    (const wxChar* uri);
 109     const wxChar* ParsePort      (const wxChar* uri);
 110     const wxChar* ParsePath      (const wxChar* uri,
 111                                   bool bReference = false,
 112                                   bool bNormalize = true);
 113     const wxChar* ParseQuery     (const wxChar* uri);
 114     const wxChar* ParseFragment  (const wxChar* uri);
 115
 116
 117     static bool ParseH16(const wxChar*& uri);
 118     static bool ParseIPv4address(const wxChar*& uri);
 119     static bool ParseIPv6address(const wxChar*& uri);
 120     static bool ParseIPvFuture(const wxChar*& uri);
 121
 122     static void Normalize(wxChar* uri, bool bIgnoreLeads = false);
 123     static void UpTree(const wxChar* uristart, const wxChar*& uri);
 124
 125     static wxChar TranslateEscape(const wxChar* s);
 126     static void Escape  (wxString& s, const wxChar& c);
 127     static bool IsEscape(const wxChar*& uri);
 128
 129     static wxChar CharToHex(const wxChar& c);
 130
 131     static bool IsUnreserved (const wxChar& c);
 132     static bool IsReserved (const wxChar& c);
 133     static bool IsGenDelim (const wxChar& c);
 134     static bool IsSubDelim (const wxChar& c);
 135     static bool IsHex(const wxChar& c);
 136     static bool IsAlpha(const wxChar& c);
 137     static bool IsDigit(const wxChar& c);
 138
 139     wxString m_scheme;
 140     wxString m_path;
 141     wxString m_query;
 142     wxString m_fragment;
 143
 144     wxString m_userinfo;
 145     wxString m_server;
 146     wxString m_port;
 147
 148     wxURIHostType m_hostType;
 149
 150     size_t m_fields;
 151
 152     DECLARE_DYNAMIC_CLASS(wxURI)
 153 };
 154
 155 #endif // _WX_URI_H_
 156