// Copyright (c) 2016-2018 Kiwano - Nomango // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN // THE SOFTWARE. #pragma once #include #include #include namespace kiwano { namespace network { class HttpResponse; KGE_DECLARE_SMART_PTR(HttpRequest); /** * \addtogroup Network * @{ */ /// \~chinese /// @brief HTTP请求类型 enum class HttpType { Unknown, ///< 未知 Get, ///< HTTP GET请求 Post, ///< HTTP POST请求 Put, ///< HTTP PUT请求 Delete ///< HTTP DELETE请求 }; /** * \~chinese * @brief HTTP请求 */ class KGE_API HttpRequest : public ObjectBase { public: /// \~chinese /// @brief 响应回调函数 using ResponseCallback = Function; /// \~chinese /// @brief 创建HTTP请求 /// @param url 请求地址 /// @param type 请求类型 /// @param callback 响应回调函数 HttpRequest(const String& url, HttpType type, const ResponseCallback& callback); /// \~chinese /// @brief 创建HTTP请求 /// @param url 请求地址 /// @param type 请求类型 /// @param data 请求数据 /// @param callback 响应回调函数 HttpRequest(const String& url, HttpType type, const String& data, const ResponseCallback& callback); /// \~chinese /// @brief 创建HTTP请求 /// @param url 请求地址 /// @param type 请求类型 /// @param json 请求的JSON数据 /// @param callback 响应回调函数 HttpRequest(const String& url, HttpType type, const Json& json, const ResponseCallback& callback); HttpRequest(); /// \~chinese /// @brief 设置请求地址 void SetUrl(const String& url); /// \~chinese /// @brief 设置请求类型 void SetType(HttpType type); /// \~chinese /// @brief 设置请求数据 void SetData(const String& data); /// \~chinese /// @brief 设置请求的JSON数据 void SetJsonData(const Json& json); /// \~chinese /// @brief 设置HTTP头 void SetHeaders(const Map& headers); /// \~chinese /// @brief 设置HTTP头 void SetHeader(const String& field, const String& content); /// \~chinese /// @brief 设置响应回调函数 void SetResponseCallback(const ResponseCallback& callback); /// \~chinese /// @brief 获取请求地址 const String& GetUrl() const; /// \~chinese /// @brief 获取请求类型 HttpType GetType() const; /// \~chinese /// @brief 获取请求数据 const String& GetData() const; /// \~chinese /// @brief 获取HTTP头 Map& GetHeaders(); /// \~chinese /// @brief 获取HTTP头 const String& GetHeader(const String& header) const; /// \~chinese /// @brief 获取响应回调函数 const ResponseCallback& GetResponseCallback() const; private: HttpType type_; String url_; String data_; Map headers_; ResponseCallback response_cb_; }; /** @} */ inline HttpRequest::HttpRequest() : type_(HttpType::Unknown) { } inline void HttpRequest::SetUrl(const String& url) { url_ = url; } inline const String& HttpRequest::GetUrl() const { return url_; } inline void HttpRequest::SetType(HttpType type) { type_ = type; } inline HttpType HttpRequest::GetType() const { return type_; } inline void HttpRequest::SetData(const String& data) { data_ = data; } inline const String& HttpRequest::GetData() const { return data_; } inline void HttpRequest::SetHeaders(const Map& headers) { headers_ = headers; } inline void HttpRequest::SetHeader(const String& field, const String& content) { headers_[field] = content; } inline Map& HttpRequest::GetHeaders() { return headers_; } inline const String& HttpRequest::GetHeader(const String& header) const { return headers_.at(header); } inline void HttpRequest::SetResponseCallback(const ResponseCallback& callback) { response_cb_ = callback; } inline const HttpRequest::ResponseCallback& HttpRequest::GetResponseCallback() const { return response_cb_; } } // namespace network } // namespace kiwano