web_client.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_WEB_CLIENT_H
#define ARCHON_UTILITIES_WEB_CLIENT_H

#include <string>
#include <vector>

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

namespace Archon
{
  namespace Utilities
  {
    namespace Web
    {
      using namespace std;

      struct RequestException: virtual Exception
      {
        RequestException(string l, string m): Exception(l, m) {}
      };

      struct Client: RefObjectBase
      {
        static Ref<Client> get(string applicationName,
                               string applicationVersion,
                               int maxSockets = 32)
          throw(UnexpectedException);

        static Ref<Client> get(string applicationName,
                               string applicationVersion,
                               string cacheRootPath, long cacheSize,
                               int maxSockets = 32)
          throw(UnexpectedException);


        struct Request: RefObjectBase
        {
          static Ref<Request> get(const Uri &);

          const Uri &getUri() { return uri; }

        protected:
          Request(const Uri &uri): uri(uri) {}

          Uri uri;
        };

        struct Response: virtual Stream::ReaderBase<char>
        {
          virtual string getContentType() = 0;

        protected:
          Response() {}
        };

        virtual Ref<Response> request(Ref<Request>) throw(RequestException) = 0;

      protected:
        Client() {}
      };
    }
  }
}

#endif // ARCHON_UTILITIES_WEB_CLIENT_H

---