dlibs/dlib/http_client/http_client.h

#ifndef DLIB_BROWSERhH
#define DLIB_BROWSERhH


#include <map>
#include <string>
#include <vector>
#include "http_client_abstract.h"


// Default timeout after 60 seconds
#define DEFAULT_TIMEOUT 60000

namespace dlib
{

    // Function which is called when there is data available.
    //   Return false to stop the download process...
    typedef bool (*fnOnDownload)(long already_downloaded, long total_to_download, void * userInfo);


    class http_client
    {
    public:
        http_client();

        typedef std::map< std::string, std::string > stringmap;
        typedef std::map< std::string, stringmap   > string_to_stringmap;
        typedef std::map< std::string, std::vector<std::string> > string_to_stringvector;

        // Header functions
        void        set_header(const std::string& header_name, const std::string& header_value);
        void        set_header(const std::string& header_name, long header_value);
        std::string get_header(const std::string& header_name) const;
        void        remove_header(const std::string& header_name);
        bool        is_header_set(const std::string& header_name) const;

        // This function will clear out all cookies & headers set until now
        void clear();
        // This function will clear out the Content-Type header
        void prepare_for_next_url();

        void set_callback_function( fnOnDownload od, void * _user_info ) { OnDownload = od; user_info = _user_info; }

        void set_cookie(const std::string& cookie_name, const std::string& cookie_value);
        void set_cookie(const std::string& cookie_name, long cookie_value);
        void remove_cookie(const std::string& cookie_name);

        void set_user_agent(const std::string& new_agent) { set_header("User-Agent", new_agent); }


        void set_timeout( unsigned int milliseconds = DEFAULT_TIMEOUT ) { timeout = milliseconds; }


        string_to_stringvector get_returned_headers() const { return returned_headers; }
        short                  get_http_return     () const { return http_return; }
        const std::string&     get_body            () const { return returned_body; }

        // POST
        const std::string& post_url (const std::string& url, const string_to_stringmap& postvars, const string_to_stringmap& filenames = string_to_stringmap());
        const std::string& post_url (const std::string& url, const std::string& postbuffer);
        // GET
        const std::string& get_url  (const std::string& url);

        bool has_error( ) const { return !error_field.empty(); }
        const std::string& get_error( ) const { return error_field; }

        static std::string urlencode(const std::string& in, bool post_encode = false);
        static std::string urldecode(const std::string& in);
    private:
        bool grab_url(const std::string& url, const std::string& method = "GET", const std::string& post_body = "");
        std::string build_post(std::string& content_type, const string_to_stringmap& postvars, const string_to_stringmap& filenames) const;

        std::string get_random_string( size_t length = 32 ) const;
        std::string get_basename( const std::string& filename ) const;
        std::string strtolower(const std::string& in) const;
        std::string strtoupper(const std::string& in) const;

        bool parse_url(const std::string& url, std::string& scheme, std::string& user, std::string& pass, std::string& host, short& port, std::string& path) const;

        stringmap headers;
        stringmap cookies;

        string_to_stringvector returned_headers;
        short http_return;
        std::string returned_body, error_field;

        unsigned int timeout;

        fnOnDownload OnDownload;
        void *       user_info;
    };

}

#ifdef NO_MAKEFILE
#include "http_client.cpp"
#endif

#endif // DLIB_BROWSERhH