rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 1 | // Copyright (c) 2009 The Chromium OS Authors. All rights reserved. |
| 2 | // Use of this source code is governed by a BSD-style license that can be |
| 3 | // found in the LICENSE file. |
| 4 | |
adlr@google.com | c98a7ed | 2009-12-04 18:54:03 +0000 | [diff] [blame] | 5 | #ifndef CHROMEOS_PLATFORM_UPDATE_ENGINE_HTTP_FETCHER_H__ |
| 6 | #define CHROMEOS_PLATFORM_UPDATE_ENGINE_HTTP_FETCHER_H__ |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 7 | |
Andrew de los Reyes | 4516810 | 2010-11-22 11:13:50 -0800 | [diff] [blame] | 8 | #include <deque> |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 9 | #include <string> |
adlr@google.com | c98a7ed | 2009-12-04 18:54:03 +0000 | [diff] [blame] | 10 | #include <vector> |
Andrew de los Reyes | 4516810 | 2010-11-22 11:13:50 -0800 | [diff] [blame] | 11 | |
| 12 | #include <base/basictypes.h> |
| 13 | #include <base/logging.h> |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 14 | #include <glib.h> |
Andrew de los Reyes | f3ed8e7 | 2011-02-16 10:35:46 -0800 | [diff] [blame] | 15 | #include <google/protobuf/stubs/common.h> |
Andrew de los Reyes | 4516810 | 2010-11-22 11:13:50 -0800 | [diff] [blame] | 16 | |
Gilad Arnold | 9dd1e7c | 2012-02-16 12:13:36 -0800 | [diff] [blame] | 17 | #include "http_common.h" |
Andrew de los Reyes | 4516810 | 2010-11-22 11:13:50 -0800 | [diff] [blame] | 18 | #include "update_engine/proxy_resolver.h" |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 19 | |
| 20 | // This class is a simple wrapper around an HTTP library (libcurl). We can |
| 21 | // easily mock out this interface for testing. |
| 22 | |
| 23 | // Implementations of this class should use asynchronous i/o. They can access |
| 24 | // the glib main loop to request callbacks when timers or file descriptors |
| 25 | // change. |
| 26 | |
| 27 | namespace chromeos_update_engine { |
| 28 | |
| 29 | class HttpFetcherDelegate; |
| 30 | |
| 31 | class HttpFetcher { |
| 32 | public: |
Andrew de los Reyes | 4516810 | 2010-11-22 11:13:50 -0800 | [diff] [blame] | 33 | // |proxy_resolver| is the resolver that will be consulted for proxy |
| 34 | // settings. It may be null, in which case direct connections will |
| 35 | // be used. Does not take ownership of the resolver. |
| 36 | explicit HttpFetcher(ProxyResolver* proxy_resolver) |
Darin Petkov | cb46621 | 2010-08-26 09:40:11 -0700 | [diff] [blame] | 37 | : post_data_set_(false), |
| 38 | http_response_code_(0), |
Andrew de los Reyes | 4516810 | 2010-11-22 11:13:50 -0800 | [diff] [blame] | 39 | delegate_(NULL), |
| 40 | proxies_(1, kNoProxy), |
Andrew de los Reyes | f3ed8e7 | 2011-02-16 10:35:46 -0800 | [diff] [blame] | 41 | proxy_resolver_(proxy_resolver), |
| 42 | no_resolver_idle_id_(0), |
| 43 | callback_(NULL) {} |
| 44 | virtual ~HttpFetcher(); |
Darin Petkov | cb46621 | 2010-08-26 09:40:11 -0700 | [diff] [blame] | 45 | |
| 46 | void set_delegate(HttpFetcherDelegate* delegate) { delegate_ = delegate; } |
| 47 | HttpFetcherDelegate* delegate() const { return delegate_; } |
| 48 | int http_response_code() const { return http_response_code_; } |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 49 | |
| 50 | // Optional: Post data to the server. The HttpFetcher should make a copy |
Gilad Arnold | 9dd1e7c | 2012-02-16 12:13:36 -0800 | [diff] [blame] | 51 | // of this data and upload it via HTTP POST during the transfer. The type of |
| 52 | // the data is necessary for properly setting the Content-Type HTTP header. |
| 53 | void SetPostData(const void* data, size_t size, HttpContentType type); |
| 54 | |
| 55 | // Same without a specified Content-Type. |
Andrew de los Reyes | 4516810 | 2010-11-22 11:13:50 -0800 | [diff] [blame] | 56 | void SetPostData(const void* data, size_t size); |
| 57 | |
| 58 | // Proxy methods to set the proxies, then to pop them off. |
Andrew de los Reyes | f3ed8e7 | 2011-02-16 10:35:46 -0800 | [diff] [blame] | 59 | // Returns true on success. |
| 60 | bool ResolveProxiesForUrl(const std::string& url, |
| 61 | google::protobuf::Closure* callback); |
Andrew de los Reyes | 4516810 | 2010-11-22 11:13:50 -0800 | [diff] [blame] | 62 | |
| 63 | void SetProxies(const std::deque<std::string>& proxies) { |
| 64 | proxies_ = proxies; |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 65 | } |
Andrew de los Reyes | 4516810 | 2010-11-22 11:13:50 -0800 | [diff] [blame] | 66 | const std::string& GetCurrentProxy() const { |
| 67 | return proxies_.front(); |
| 68 | } |
| 69 | bool HasProxy() const { return !proxies_.empty(); } |
| 70 | void PopProxy() { proxies_.pop_front(); } |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 71 | |
Andrew de los Reyes | 3fd5d30 | 2010-10-07 20:07:18 -0700 | [diff] [blame] | 72 | // Downloading should resume from this offset |
| 73 | virtual void SetOffset(off_t offset) = 0; |
| 74 | |
Gilad Arnold | e4ad250 | 2011-12-29 17:08:54 -0800 | [diff] [blame] | 75 | // Set/unset the length of the range to be downloaded. |
| 76 | virtual void SetLength(size_t length) = 0; |
| 77 | virtual void UnsetLength() = 0; |
| 78 | |
Darin Petkov | 9ce452b | 2010-11-17 14:33:28 -0800 | [diff] [blame] | 79 | // Begins the transfer to the specified URL. This fetcher instance should not |
| 80 | // be destroyed until either TransferComplete, or TransferTerminated is |
| 81 | // called. |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 82 | virtual void BeginTransfer(const std::string& url) = 0; |
| 83 | |
Darin Petkov | 9ce452b | 2010-11-17 14:33:28 -0800 | [diff] [blame] | 84 | // Aborts the transfer. The transfer may not abort right away -- delegate's |
| 85 | // TransferTerminated() will be called when the transfer is actually done. |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 86 | virtual void TerminateTransfer() = 0; |
| 87 | |
| 88 | // If data is coming in too quickly, you can call Pause() to pause the |
| 89 | // transfer. The delegate will not have ReceivedBytes() called while |
| 90 | // an HttpFetcher is paused. |
| 91 | virtual void Pause() = 0; |
| 92 | |
| 93 | // Used to unpause an HttpFetcher and let the bytes stream in again. |
| 94 | // If a delegate is set, ReceivedBytes() may be called on it before |
| 95 | // Unpause() returns |
| 96 | virtual void Unpause() = 0; |
| 97 | |
Andrew de los Reyes | 3fd5d30 | 2010-10-07 20:07:18 -0700 | [diff] [blame] | 98 | // These two function are overloaded in LibcurlHttp fetcher to speed |
| 99 | // testing. |
| 100 | virtual void set_idle_seconds(int seconds) {} |
| 101 | virtual void set_retry_seconds(int seconds) {} |
| 102 | |
Gilad Arnold | 48085ba | 2011-11-16 09:36:08 -0800 | [diff] [blame] | 103 | // Get the total number of bytes downloaded by fetcher. |
| 104 | virtual size_t GetBytesDownloaded() = 0; |
| 105 | |
Andrew de los Reyes | 819fef2 | 2010-12-17 11:33:58 -0800 | [diff] [blame] | 106 | ProxyResolver* proxy_resolver() const { return proxy_resolver_; } |
| 107 | |
| 108 | // These are used for testing: |
| 109 | virtual void SetConnectionAsExpensive(bool is_expensive) {} |
| 110 | virtual void SetBuildType(bool is_official) {} |
| 111 | |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 112 | protected: |
| 113 | // The URL we're actively fetching from |
| 114 | std::string url_; |
| 115 | |
| 116 | // POST data for the transfer, and whether or not it was ever set |
| 117 | bool post_data_set_; |
| 118 | std::vector<char> post_data_; |
Gilad Arnold | 9dd1e7c | 2012-02-16 12:13:36 -0800 | [diff] [blame] | 119 | HttpContentType post_content_type_; |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 120 | |
Darin Petkov | cb46621 | 2010-08-26 09:40:11 -0700 | [diff] [blame] | 121 | // The server's HTTP response code from the last transfer. This |
| 122 | // field should be set to 0 when a new transfer is initiated, and |
| 123 | // set to the response code when the transfer is complete. |
| 124 | int http_response_code_; |
| 125 | |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 126 | // The delegate; may be NULL. |
| 127 | HttpFetcherDelegate* delegate_; |
Andrew de los Reyes | 4516810 | 2010-11-22 11:13:50 -0800 | [diff] [blame] | 128 | |
| 129 | // Proxy servers |
| 130 | std::deque<std::string> proxies_; |
Andrew de los Reyes | f3ed8e7 | 2011-02-16 10:35:46 -0800 | [diff] [blame] | 131 | |
Andrew de los Reyes | 4516810 | 2010-11-22 11:13:50 -0800 | [diff] [blame] | 132 | ProxyResolver* const proxy_resolver_; |
| 133 | |
Andrew de los Reyes | f3ed8e7 | 2011-02-16 10:35:46 -0800 | [diff] [blame] | 134 | // The ID of the idle callback, used when we have no proxy resolver. |
| 135 | guint no_resolver_idle_id_; |
| 136 | |
| 137 | // Callback for when we are resolving proxies |
| 138 | google::protobuf::Closure* callback_; |
| 139 | |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 140 | private: |
Andrew de los Reyes | f3ed8e7 | 2011-02-16 10:35:46 -0800 | [diff] [blame] | 141 | // Callback from the proxy resolver |
| 142 | void ProxiesResolved(const std::deque<std::string>& proxies); |
| 143 | static void StaticProxiesResolved(const std::deque<std::string>& proxies, |
| 144 | void* data) { |
| 145 | reinterpret_cast<HttpFetcher*>(data)->ProxiesResolved(proxies); |
| 146 | } |
| 147 | |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 148 | DISALLOW_COPY_AND_ASSIGN(HttpFetcher); |
| 149 | }; |
| 150 | |
| 151 | // Interface for delegates |
| 152 | class HttpFetcherDelegate { |
| 153 | public: |
Andrew de los Reyes | 34e41a1 | 2010-10-26 20:07:58 -0700 | [diff] [blame] | 154 | // Called every time bytes are received. |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 155 | virtual void ReceivedBytes(HttpFetcher* fetcher, |
| 156 | const char* bytes, |
| 157 | int length) = 0; |
| 158 | |
Andrew de los Reyes | 34e41a1 | 2010-10-26 20:07:58 -0700 | [diff] [blame] | 159 | // Called if the fetcher seeks to a particular offset. |
| 160 | virtual void SeekToOffset(off_t offset) {} |
| 161 | |
Andrew de los Reyes | 819fef2 | 2010-12-17 11:33:58 -0800 | [diff] [blame] | 162 | // When a transfer has completed, exactly one of these two methods will be |
| 163 | // called. TransferTerminated is called when the transfer has been aborted |
| 164 | // through TerminateTransfer. TransferComplete is called in all other |
| 165 | // situations. It's OK to destroy the |fetcher| object in this callback. |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 166 | virtual void TransferComplete(HttpFetcher* fetcher, bool successful) = 0; |
Darin Petkov | 9ce452b | 2010-11-17 14:33:28 -0800 | [diff] [blame] | 167 | virtual void TransferTerminated(HttpFetcher* fetcher) {} |
rspangler@google.com | 49fdf18 | 2009-10-10 00:57:34 +0000 | [diff] [blame] | 168 | }; |
| 169 | |
| 170 | } // namespace chromeos_update_engine |
| 171 | |
adlr@google.com | c98a7ed | 2009-12-04 18:54:03 +0000 | [diff] [blame] | 172 | #endif // CHROMEOS_PLATFORM_UPDATE_ENGINE_HTTP_FETCHER_H__ |