/*************************************************************************/ /* http_request.h */ /*************************************************************************/ /* This file is part of: */ /* GODOT ENGINE */ /* https://godotengine.org */ /*************************************************************************/ /* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */ /* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */ /* */ /* 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. */ /*************************************************************************/ #ifndef HTTPREQUEST_H #define HTTPREQUEST_H #include "core/io/http_client.h" #include "core/os/file_access.h" #include "core/os/thread.h" #include "core/safe_refcount.h" #include "node.h" #include "scene/main/timer.h" class HTTPRequest : public Node { GDCLASS(HTTPRequest, Node); public: enum Result { RESULT_SUCCESS, RESULT_CHUNKED_BODY_SIZE_MISMATCH, RESULT_CANT_CONNECT, RESULT_CANT_RESOLVE, RESULT_CONNECTION_ERROR, RESULT_SSL_HANDSHAKE_ERROR, RESULT_NO_RESPONSE, RESULT_BODY_SIZE_LIMIT_EXCEEDED, RESULT_REQUEST_FAILED, RESULT_DOWNLOAD_FILE_CANT_OPEN, RESULT_DOWNLOAD_FILE_WRITE_ERROR, RESULT_REDIRECT_LIMIT_REACHED, RESULT_TIMEOUT }; private: bool requesting; String request_string; String url; int port; Vector headers; bool validate_ssl; bool use_ssl; HTTPClient::Method method; PoolVector request_data; bool request_sent; Ref client; PoolByteArray body; SafeFlag use_threads; bool got_response; int response_code; PoolVector response_headers; String download_to_file; FileAccess *file; int body_len; SafeNumeric downloaded; int body_size_limit; int redirections; bool _update_connection(); int max_redirects; int timeout; void _redirect_request(const String &p_new_url); bool _handle_response(bool *ret_value); Error _parse_url(const String &p_url); Error _request(); SafeFlag thread_done; SafeFlag thread_request_quit; Thread thread; void _request_done(int p_status, int p_code, const PoolStringArray &p_headers, const PoolByteArray &p_data); static void _thread_func(void *p_userdata); protected: void _notification(int p_what); static void _bind_methods(); public: Error request(const String &p_url, const Vector &p_custom_headers = Vector(), bool p_ssl_validate_domain = true, HTTPClient::Method p_method = HTTPClient::METHOD_GET, const String &p_request_data = ""); //connects to a full url and perform request Error request_raw(const String &p_url, const Vector &p_custom_headers = Vector(), bool p_ssl_validate_domain = true, HTTPClient::Method p_method = HTTPClient::METHOD_GET, const PoolVector &p_request_data_raw = PoolVector()); //connects to a full url and perform request void cancel_request(); HTTPClient::Status get_http_client_status() const; void set_use_threads(bool p_use); bool is_using_threads() const; void set_download_file(const String &p_file); String get_download_file() const; void set_download_chunk_size(int p_chunk_size); int get_download_chunk_size() const; void set_body_size_limit(int p_bytes); int get_body_size_limit() const; void set_max_redirects(int p_max); int get_max_redirects() const; Timer *timer; void set_timeout(int p_timeout); int get_timeout(); void _timeout(); int get_downloaded_bytes() const; int get_body_size() const; // Use empty string or -1 to unset. void set_http_proxy(const String &p_host, int p_port); void set_https_proxy(const String &p_host, int p_port); HTTPRequest(); ~HTTPRequest(); }; VARIANT_ENUM_CAST(HTTPRequest::Result); #endif // HTTPREQUEST_H