URL.h++

Go to the documentation of this file.

/* ---------------------------------------------------------------------------
   commonc++ - A C++ Common Class Library
   Copyright (C) 2005-2012  Mark A Lindner

   This file is part of commonc++.

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License as published by the Free Software Foundation; either
   version 2 of the License, or (at your option) any later version.

   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public
   License along with this library; if not, write to the Free
   Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
   ---------------------------------------------------------------------------
*/

#ifndef __ccxx_URL_hxx
#define __ccxx_URL_hxx

#include <memory>

#include <commonc++/Common.h++>
#include <commonc++/String.h++>
#include <commonc++/ParseException.h++>
#include <commonc++/RegExp.h++>

namespace ccxx {

class COMMONCPP_API URL
{
  public:

  URL();

  URL(const String& url);

  URL(const URL& other);

  ~URL() throw();

  inline void setScheme(const String& scheme)
  { _scheme = scheme; _url = String::null; }

  inline String getScheme() const
  { return(_scheme); }

  inline void setHost(const String& host)
  { _host = host; _url = String::null; }

  inline String getHost() const
  { return(_host); }

  inline void setPort(uint16_t port) throw()
  { _port = port; _url = String::null; }

  inline uint16_t getPort() const throw()
  { return(_port); }

  void setPath(const String& path);

  inline String getPath() const
  { return(_path); }

  inline String getCanonicalPath() const
  { return(_canonicalPath); }

  inline void setQuery(const String& query)
  { _query = query; _url = String::null; }

  inline String getQuery() const
  { return(_query); }

  bool isValid() const throw();

  String toString() const;

  bool operator==(const URL& other) const throw();

  inline bool operator!=(const URL& other) const throw()
  { return(! operator==(other)); }

  URL& operator=(const String& other);

  URL& operator=(const URL& other);

  static String encode(const String& str);

  static String decode(const String& str);

  private:

  void _init();
  void _parseURL(const String& url);
  String _canonicalizePath(const String &path);

  String _scheme;
  String _host;
  uint16_t _port;
  String _path;
  String _canonicalPath;
  String _query;
  mutable String _url;
  RegExp _re;
};

}; // namespace ccxx

#endif // __ccxx_URL_hxx

/* end of header file */