src/dom/uri.h

   1 #ifndef __URI_H__
   2 #define __URI_H__
   3
   4 /**
   5  * Phoebe DOM Implementation.
   6  *
   7  * This is a C++ approximation of the W3C DOM model, which follows
   8  * fairly closely the specifications in the various .idl files, copies of
   9  * which are provided for reference.  Most important is this one:
  10  *
  11  * http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/idl-definitions.html
  12  *
  13  * Authors:
  14  *   Bob Jamison
  15  *
  16  * Copyright (C) 2005 Bob Jamison
  17  *
  18  *  This library is free software; you can redistribute it and/or
  19  *  modify it under the terms of the GNU Lesser General Public
  20  *  License as published by the Free Software Foundation; either
  21  *  version 2.1 of the License, or (at your option) any later version.
  22  *
  23  *  This library is distributed in the hope that it will be useful,
  24  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  25  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  26  *  Lesser General Public License for more details.
  27  *
  28  *  You should have received a copy of the GNU Lesser General Public
  29  *  License along with this library; if not, write to the Free Software
  30  *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  31  */
  32
  33
  34 #include "dom.h"
  35
  36
  37 namespace org
  38 {
  39 namespace w3c
  40 {
  41 namespace dom
  42 {
  43
  44
  45 /**
  46  *  A class that implements the W3C URI resource reference.
  47  */
  48 class URI
  49 {
  50 public:
  51
  52     typedef enum
  53         {
  54         SCHEME_NONE =0,
  55         SCHEME_DATA,
  56         SCHEME_HTTP,
  57         SCHEME_HTTPS,
  58         SCHEME_FTP,
  59         SCHEME_FILE,
  60         SCHEME_LDAP,
  61         SCHEME_MAILTO,
  62         SCHEME_NEWS,
  63         SCHEME_TELNET
  64         } SchemeTypes;
  65
  66     /**
  67      *
  68      */
  69     URI();
  70
  71     /**
  72      *
  73      */
  74     URI(const DOMString &str);
  75
  76
  77     /**
  78      *
  79      */
  80     URI(const char *str);
  81
  82     /**
  83      * Copy constructor
  84      */
  85     URI(const URI &other);
  86
  87     /**
  88      *  Assignment
  89      */
  90     URI &URI::operator=(const URI &other);
  91
  92     /**
  93      *
  94      */
  95     virtual ~URI();
  96
  97     /**
  98      *
  99      */
 100     virtual bool parse(const DOMString &str);
 101
 102     /**
 103      *
 104      */
 105     virtual DOMString toString() const;
 106
 107     /**
 108      *
 109      */
 110     virtual int getScheme() const;
 111
 112     /**
 113      *
 114      */
 115     virtual DOMString getSchemeStr() const;
 116
 117     /**
 118      *
 119      */
 120     virtual DOMString getAuthority() const;
 121
 122     /**
 123      *  Same as getAuthority, but if the port has been specified
 124      *  as host:port , the port will not be included
 125      */
 126     virtual DOMString getHost() const;
 127
 128     /**
 129      *
 130      */
 131     virtual int getPort() const;
 132
 133     /**
 134      *
 135      */
 136     virtual DOMString getPath() const;
 137
 138     /**
 139      *
 140      */
 141     virtual bool isAbsolute() const;
 142
 143     /**
 144      *
 145      */
 146     virtual bool isOpaque() const;
 147
 148     /**
 149      *
 150      */
 151     virtual DOMString getQuery() const;
 152
 153     /**
 154      *
 155      */
 156     virtual DOMString getFragment() const;
 157
 158     /**
 159      *
 160      */
 161     virtual URI resolve(const URI &other) const;
 162
 163     /**
 164      *
 165      */
 166     virtual void normalize();
 167
 168 private:
 169
 170     void init();
 171
 172     //assign values of other to this. used by copy constructor
 173     void assign(const URI &other);
 174
 175     int scheme;
 176
 177     DOMString schemeStr;
 178
 179     DOMString authority;
 180
 181     bool portSpecified;
 182
 183     int port;
 184
 185     DOMString path;
 186
 187     bool absolute;
 188
 189     bool opaque;
 190
 191     DOMString query;
 192
 193     DOMString fragment;
 194
 195     void error(const char *fmt, ...);
 196
 197     void trace(const char *fmt, ...);
 198
 199
 200     int peek(int p);
 201
 202     int match(int p, char *key);
 203
 204     int parseScheme(int p);
 205
 206     int parseHierarchicalPart(int p0);
 207
 208     int parseQuery(int p0);
 209
 210     int parseFragment(int p0);
 211
 212     int parse(int p);
 213
 214     char *parsebuf;
 215
 216     int parselen;
 217
 218 };
 219
 220
 221
 222 }  //namespace dom
 223 }  //namespace w3c
 224 }  //namespace org
 225
 226
 227
 228 #endif /* __URI_H__ */
 229