nim_tools_http_cpp.h

浏览该文件的文档.

 
#ifndef _NIM_TOOLS_SDK_CPP_HTTP_H_
#define _NIM_TOOLS_SDK_CPP_HTTP_H_
 
#include <functional>
#include <map>
#include <string>
#include "nim_define_include.h"
#include "nim_tools_http_def.h"
 
namespace nim_http {
typedef std::function<void(bool, int)> CompletedCallback;
 
typedef std::function<void(bool, int, const std::string&)> ResponseCallback;
 
typedef std::function<void(bool, int, const std::string&, const std::string&)> ResponseCallbackEx;
 
typedef std::function<void(double, double, double, double)> ProgressCallback;
 
typedef std::function<void(double, double)> SpeedCallback;
 
typedef std::function<void(double, double, double, double)> TransferCallback;
 
class HttpRequest;
 
bool Init(const std::string& library_path = "");
 
void Uninit();
 
void InitLog(const std::string& log_file_path);
 
bool IsInitLog();
 
void SetGlobalProxy(nim::NIMProxyType type, const std::string& host, short port, const std::string& user, const std::string& pass);
 
HttpRequestID PostRequest(const HttpRequest& http_request);
 
void RemoveRequest(HttpRequestID http_request_id);
 
std::string GetResponseHead(HttpRequestID http_request_id);
 
class HttpRequest {
public:
    HttpRequest(const std::string& url,
        const std::string& download_file_path,
        const CompletedCallback& complete_cb,
        const ProgressCallback& progress_cb = ProgressCallback(),
        const SpeedCallback& speed_cb = SpeedCallback(),
        const TransferCallback& transfer_cb = TransferCallback());
 
    HttpRequest(const std::string& url,
        const std::string& download_file_path,
        int64_t range_start,
        const CompletedCallback& complete_cb,
        const ProgressCallback& progress_cb = ProgressCallback(),
        const SpeedCallback& speed_cb = SpeedCallback(),
        const TransferCallback& transfer_cb = TransferCallback());
 
    HttpRequest(const std::string& url,
        const char* post_body,
        size_t post_body_size,
        const ResponseCallback& response_cb,
        const ProgressCallback& progress_cb = ProgressCallback(),
        const SpeedCallback& speed_cb = SpeedCallback(),
        const TransferCallback& transfer_cb = TransferCallback());
 
    HttpRequest(const std::string& url,
        const char* post_body,
        size_t post_body_size,
        const ResponseCallbackEx& response_cb,
        const ProgressCallback& progress_cb = ProgressCallback(),
        const SpeedCallback& speed_cb = SpeedCallback(),
        const TransferCallback& transfer_cb = TransferCallback());
 
    void AddHeader(const std::string& key, const std::string& value);
 
    void AddHeader(const std::map<std::string, std::string>& headers_map);
 
    void SetMethodAsPost();
 
    void SetTimeout(int timeout_ms);
 
    void SetLowSpeed(int low_speed_limit, int low_speed_time);
 
    void SetProxy(nim::NIMProxyType type, const std::string& host, short port, const std::string& user, const std::string& pass);
 
private:
    static void CompletedCallbackWrapper(const void* user_data, bool is_ok, int response_code);
    static void ResponseCallbackWrapper(const void* user_data, bool is_ok, int response_code, const char* content, const char* head);
    static void ProgressCallbackWrapper(const void* user_data,
        double upload_size,
        double uploaded_size,
        double download_size,
        double downloaded_size);
    static void SpeedCallbackWrapper(const void* user_data, double upload_speed, double download_speed);
    static void TransferCallbackWrapper(const void* user_data,
        double actual_upload_size,
        double upload_speed,
        double actual_download_size,
        double download_speed);
 
private:
    friend HttpRequestID PostRequest(const HttpRequest& http_request);
    HttpRequestHandle http_reuqest_handle_;
};
 
}  // namespace nim_http
 
#endif  // _NIM_TOOLS_SDK_CPP_HTTP_H_