HttpsSession.h

/***************************************************************************
 * \file HttpsSession.h
 * \brief Defines an interface for establishing an HTTPS session.
 * \author DA
 * \copyright (c) 2017 CyberRadio Solutions, Inc.  All rights reserved.
 *
 * \note Requires C++11 compiler support.
 *
 ***************************************************************************/
 
#ifndef INCLUDED_LIBCYBERRADIO_HTTPSSESSION_H_
#define INCLUDED_LIBCYBERRADIO_HTTPSSESSION_H_
 
#include "LibCyberRadio/Common/Debuggable.h"
#include <curl/curl.h>
#include <sstream>
#include <string>
 

namespace LibCyberRadio
{

    class HttpsSession : public Debuggable
    {
        public:
            HttpsSession(
                    bool debug = false
            );
            virtual ~HttpsSession();
            virtual bool get(
                    const std::string& url,
                    bool verify = true
            );
            virtual bool post(
                    const std::string& url,
                    void* data,
                    size_t length,
                    const char* contentType = "text/plain",
                    bool verify = true
            );
            virtual long getResponseCode() const;
            virtual std::string getResponseHeader() const;
            virtual std::string getResponseBody() const;
            virtual std::string getLastRequestErrorInfo() const;
            virtual size_t writeHeader(
                    char *ptr,
                    size_t size
            );
            virtual size_t writeResponseData(
                    char *ptr,
                    size_t size
            );
 
        protected:
            virtual CURLcode initializeRequest();
            virtual const char* debugCurl(
                    CURLcode x
            );
            static size_t headerCallback(
                    char *buffer,
                    size_t size,
                    size_t nitems,
                    void *userdata
            );
            static size_t writeDataCallback(
                    char *ptr,
                    size_t size,
                    size_t nmemb,
                    void *userdata
            );
 
        protected:
            // libcurl handle
            CURL* _session;
            // HTTPS request data
            // -- Response code
            long _responseCode;
            // -- Response header
            std::ostringstream _header;
            // -- Response body
            std::ostringstream _response;
            // Error message from the last request
            std::string _lastReqErrInfo;
    };
 
} /* namespace LibCyberRadio */
 
#endif /* INCLUDED_LIBCYBERRADIO_HTTPSSESSION_H_ */