1 files changed, 120 insertions, 0 deletions
diff --git a/content/public/browser/download_manager_delegate.h b/content/public/browser/download_manager_delegate.h
new file mode 100644
index 0000000..fbc9bd3
--- /dev/null
+++ b/content/public/browser/download_manager_delegate.h
@@ -0,0 +1,120 @@
+// Copyright (c) 2011 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 CONTENT_PUBLIC_BROWSER_DOWNLOAD_MANAGER_DELEGATE_H_
+#define CONTENT_PUBLIC_BROWSER_DOWNLOAD_MANAGER_DELEGATE_H_
+#pragma once
+
+#include "base/basictypes.h"
+#include "base/memory/weak_ptr.h"
+#include "base/time.h"
+
+class DownloadItem;
+class FilePath;
+class TabContents;
+class SavePackage;
+
+namespace content {
+
+// Browser's download manager: manages all downloads and destination view.
+class DownloadManagerDelegate {
+ public:
+  virtual ~DownloadManagerDelegate() {}
+
+  // Lets the delegate know that the download manager is shutting down.
+  virtual void Shutdown() = 0;
+
+  // Notifies the delegate that a download is starting. The delegate can return
+  // false to delay the start of the download, in which case it should call
+  // DownloadManager::RestartDownload when it's ready.
+  virtual bool ShouldStartDownload(int32 download_id) = 0;
+
+  // Asks the user for the path for a download. The delegate calls
+  // DownloadManager::FileSelected or DownloadManager::FileSelectionCanceled to
+  // give the answer.
+  virtual void ChooseDownloadPath(TabContents* tab_contents,
+                                  const FilePath& suggested_path,
+                                  void* data) = 0;
+
+  // Allows the embedder to override the file path for the download while it's
+  // progress. Return false to leave the filename as item->full_path(), or
+  // return true and set |intermediate_path| with the intermediate path.
+  virtual bool OverrideIntermediatePath(DownloadItem* item,
+                                        FilePath* intermediate_path) = 0;
+
+  // Called when the download system wants to alert a TabContents that a
+  // download has started, but the TabConetnts has gone away. This lets an
+  // delegate return an alternative TabContents. The delegate can return NULL.
+  virtual TabContents* GetAlternativeTabContentsToNotifyForDownload() = 0;
+
+  // Tests if a file type should be opened automatically.
+  virtual bool ShouldOpenFileBasedOnExtension(const FilePath& path) = 0;
+
+  // Allows the delegate to override the opening of a download. If it returns
+  // true then it's reponsible for opening the item.
+  virtual bool ShouldOpenDownload(DownloadItem* item) = 0;
+
+  // Allows the delegate to override completing the download. The delegate needs
+  // to call DownloadItem::CompleteDelayedDownload when it's done with the item,
+  // and is responsible for opening it.
+  virtual bool ShouldCompleteDownload(DownloadItem* item) = 0;
+
+  // Returns true if we need to generate a binary hash for downloads.
+  virtual bool GenerateFileHash() = 0;
+
+  // Informs the delegate that given download has finishd downloading, and gives
+  // it the hash (if it chose to compute it from GenerateFileHash()).
+  virtual void OnResponseCompleted(DownloadItem* item,
+                                   const std::string& hash) = 0;
+
+  // Notifies the delegate that a new download item is created. The
+  // DownloadManager waits for the delegate to add information about this
+  // download to its persistent store. When the delegate is done, it calls
+  // DownloadManager::OnDownloadItemAddedToPersistentStore.
+  virtual void AddItemToPersistentStore(DownloadItem* item) = 0;
+
+  // Notifies the delegate that information about the given download has change,
+  // so that it can update its persistent store.
+  // Does not update |url|, |start_time|, |total_bytes|; uses |db_handle| only
+  // to select the row in the database table to update.
+  virtual void UpdateItemInPersistentStore(DownloadItem* item) = 0;
+
+  // Notifies the delegate that path for the download item has changed, so that
+  // it can update its persistent store.
+  virtual void UpdatePathForItemInPersistentStore(
+      DownloadItem* item,
+      const FilePath& new_path) = 0;
+
+  // Notifies the delegate that it should remove the download item from its
+  // persistent store.
+  virtual void RemoveItemFromPersistentStore(DownloadItem* item) = 0;
+
+  // Notifies the delegate to remove downloads from the given time range.
+  virtual void RemoveItemsFromPersistentStoreBetween(
+      const base::Time remove_begin,
+      const base::Time remove_end) = 0;
+
+  // Retrieve the directories to save html pages and downloads to.
+  virtual void GetSaveDir(TabContents* tab_contents,
+                          FilePath* website_save_dir,
+                          FilePath* download_save_dir) = 0;
+
+  // Asks the user for the path to save a page. The delegate calls
+  // SavePackage::OnPathPicked to give the answer.
+  virtual void ChooseSavePath(const base::WeakPtr<SavePackage>& save_package,
+                              const FilePath& suggested_path,
+                              bool can_save_as_complete) = 0;
+
+  // Informs the delegate that the progress of downloads has changed.
+  virtual void DownloadProgressUpdated() = 0;
+
+ protected:
+  DownloadManagerDelegate() {}
+
+  DISALLOW_COPY_AND_ASSIGN(DownloadManagerDelegate);
+};
+
+}  // namespace content
+
+#endif  // CONTENT_PUBLIC_BROWSER_DOWNLOAD_MANAGER_DELEGATE_H_