uri.H

/*
 * This file is part of the "Archon" framework.
 * (http://files3d.sourceforge.net)
 *
 * Copyright © 2002 by Kristian Spangsege and Brian Kristiansen.
 *
 * Permission to use, copy, modify, and distribute this software and
 * its documentation under the terms of the GNU General Public License is
 * hereby granted. No representations are made about the suitability of
 * this software for any purpose. It is provided "as is" without express
 * or implied warranty. See the GNU General Public License
 * (http://www.gnu.org/copyleft/gpl.html) for more details.
 *
 * The characters in this file are ISO8859-1 encoded.
 *
 * The documentation in this file is in "Doxygen" style
 * (http://www.doxygen.org).
 */

#ifndef ARCHON_UTILITIES_URI_H
#define ARCHON_UTILITIES_URI_H

#include <string>
#include <vector>
#include <utility>
#include <iostream>

#include <archon/util/exception.H>
#include <archon/util/ref.H>
#include <archon/util/text.H>
#include <archon/util/stream.H>
#include <archon/util/mutex.H>

namespace Archon
{
  namespace Utilities
  {
    using namespace std;


    struct Uri
    {
      struct SyntaxException: virtual Exception
      {
        string val;
        int indexFrom;
        int indexTo;
        SyntaxException(string l, string m, string v, int f, int t):
          Exception(l, m), val(v), indexFrom(f), indexTo(t) {}
        virtual ~SyntaxException() throw() {}
      };

    private:
      string scheme;    // eg. 'http:'
      string authority; // eg. '//www.ietf.org'
      string path;      // eg. '/rfc/rfc2396.txt'
      string query;     // eg. '?foo=bar'

      void canonicalizePath();
      void resolveRelative(const Uri &);

    public:
      Uri();

      Uri(const string &uri, const Uri &baseUri = Uri());

      ~Uri() {}

      bool isFileScheme() const;

      string getScheme() const
      {
        return scheme;
      }

      string getAuthority() const
      {
        return authority;
      }

      string getPath() const
      {
        return path;
      }

      string getQuery() const
      {
        return query;
      }

      string getFile() const;

      static string encode(const string &s, bool plusForSpace);

      static string decode(const string &s, bool plusForSpace);

      static string explain(const SyntaxException &);

      string toString() const;
    };

    ostream &operator<<(ostream &, const Uri &);


    class UriReference
    {
      Uri uri;
      string fragmentIdentifier; // eg. '#foobar'

    public:
      UriReference(): uri(Uri()) {}

      UriReference(const string &uriReference,
                   const UriReference &baseReference = UriReference());

      Uri getUri() const { return uri; }

      string getFragmentIdentifier() const { return fragmentIdentifier; }

      string toString() const;
    };

    ostream &operator<<(ostream &, const UriReference &);
  }
}

#endif // ARCHON_UTILITIES_URI_H

---