Index: components/rappor/log_uploader.h |
diff --git a/components/rappor/log_uploader.h b/components/rappor/log_uploader.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..30a129a5b3fcc0c877c0fe4c7306402198fa4687 |
--- /dev/null |
+++ b/components/rappor/log_uploader.h |
@@ -0,0 +1,94 @@ |
+// Copyright 2014 The Chromium Authors. All rights reserved. |
+// Use of this source code is governed by a BSD-style license that can be |
+// found in the LICENSE file. |
+ |
+#ifndef COMPONENTS_RAPPOR_LOG_UPLOADER_H_ |
+#define COMPONENTS_RAPPOR_LOG_UPLOADER_H_ |
+ |
+#include <queue> |
+#include <string> |
+ |
+#include "base/memory/scoped_ptr.h" |
+#include "base/time/time.h" |
+#include "base/timer/timer.h" |
+#include "net/url_request/url_fetcher_delegate.h" |
+#include "net/url_request/url_request_context_getter.h" |
+#include "url/gurl.h" |
+ |
+namespace net { |
+class URLFetcher; |
+} |
+ |
+namespace rappor { |
+ |
+// Handles uploading logs to an external server. |
+class LogUploader : public net::URLFetcherDelegate { |
+ public: |
+ // Constructor takes the server_url that logs should be uploaded to, the |
+ // mime_type of the uploaded data, and request_context to create uploads |
+ // with. |
+ LogUploader(const GURL& server_url, |
+ const std::string& mime_type, |
+ net::URLRequestContextGetter* request_context); |
+ |
+ virtual ~LogUploader(); |
+ |
+ // Adds an entry to the queue of logs to be uploaded to the server. The |
+ // uploader makes no assumptions about the format of |log| and simply sends |
+ // it verbatim to the server. |
+ void QueueLog(const std::string& log); |
+ |
+ protected: |
+ // Check if an upload has been scheduled. |
+ virtual bool IsUploadScheduled() const; |
+ |
+ // Schedules a future call to StartScheduledUpload if one isn't already |
+ // pending. Can be overridden for testing. |
+ virtual void ScheduleNextUpload(base::TimeDelta interval); |
+ |
+ // Starts transmission of the next log. Exposed for tests. |
+ void StartScheduledUpload(); |
+ |
+ // Increases the upload interval each time it's called, to handle the case |
+ // where the server is having issues. Exposed for tests. |
+ static base::TimeDelta BackOffUploadInterval(base::TimeDelta); |
+ |
+ private: |
+ // Implementation of net::URLFetcherDelegate. Called after transmission |
+ // completes (either successfully or with failure). |
+ virtual void OnURLFetchComplete(const net::URLFetcher* source) OVERRIDE; |
+ |
+ // Called when the upload is completed. |
+ void OnUploadFinished(bool server_is_healthy, bool more_logs_remaining); |
+ |
+ // The server URL to upload logs to. |
+ const GURL server_url_; |
+ |
+ // The mime type to specify on uploaded logs. |
+ const std::string mime_type_; |
+ |
+ // The request context used to send uploads. |
+ scoped_refptr<net::URLRequestContextGetter> request_context_; |
+ |
+ // The outstanding transmission that appears as a URL Fetch operation. |
+ scoped_ptr<net::URLFetcher> current_fetch_; |
+ |
+ // The logs that still need to be uploaded. |
+ std::queue<std::string> queued_logs_; |
+ |
+ // A timer used to delay before attempting another upload. |
+ base::OneShotTimer<LogUploader> upload_timer_; |
+ |
+ // Indicates that the last triggered upload hasn't resolved yet. |
+ bool has_callback_pending_; |
+ |
+ // The interval to wait after an upload's URLFetcher completion before |
+ // starting the next upload attempt. |
+ base::TimeDelta upload_interval_; |
+ |
+ DISALLOW_COPY_AND_ASSIGN(LogUploader); |
+}; |
+ |
+} // namespace rappor |
+ |
+#endif // COMPONENTS_RAPPOR_LOG_UPLOADER_H_ |