root/uri.hh

/*  This file is part of Alue, the multiprotocol Internet discussion daemon

    Copyright © 2009, 2010 Antti-Juhani Kaijanaho

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

    Alue 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
    General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with Alue.  If not, see <http://www.gnu.org/licenses/>.

 */

#ifndef GUARD_URI_HH
#define GUARD_URI_HH

#include <string>

class uri
{
public:
        class invalid : public std::exception
        {
                static const char msgprefix[];
                const std::string msg;
        public:
                invalid() : msg(msgprefix) {}
                invalid(std::string msg) 
                        : msg(std::string(msgprefix) + ": " + msg)
                        {}
                ~invalid() throw () {}
                const char *what() const throw () { return msg.c_str(); }
        };

        uri() : port(-1) {}
        uri(std::string str);

        static std::string percent_decode(std::string);

        // note! does not encode the solidus ('/')
        static std::string percent_encode(std::string); 


        // none of these has been percent-decoded
        std::string get_scheme() const { return scheme; }
        std::string get_userinfo() const { return userinfo; }
        std::string get_host() const { return host; }
        int get_port() const { return port; } // -1 means missing
        std::string get_path() const { return path; }
        std::string get_query() const { return query; }

        std::string get_query_param(std::string name) const;
        void replace_query_param(std::string name, std::string new_value);
        void replace_query_param(std::string name, int new_value);
        void remove_query_param(std::string name);

        std::string to_string() const;

private:
        std::string scheme;
        std::string userinfo;
        std::string host;
        int port; /* missing port is -1 */
        std::string path;
        std::string query;
};

#endif /* GUARD_URI_HH */