1// Copyright 2013 The Chromium 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
5#ifndef CHROME_BROWSER_DOWNLOAD_DOWNLOAD_UI_CONTROLLER_H_
6#define CHROME_BROWSER_DOWNLOAD_DOWNLOAD_UI_CONTROLLER_H_
7
8#include <set>
9
10#include "base/memory/scoped_ptr.h"
11#include "chrome/browser/download/all_download_item_notifier.h"
12
13class Profile;
14
15namespace content {
16class WebContents;
17}
18
19// This class handles the task of observing for download notifications and
20// notifying the UI when a new download should be displayed in the UI.
21//
22// This class monitors each IN_PROGRESS download that is created (for which
23// OnDownloadCreated is called) until:
24// - it is assigned a target path or
25// - is interrupted.
26// Then the NotifyDownloadStarting() method of the Delegate is invoked.
27class DownloadUIController : public AllDownloadItemNotifier::Observer {
28 public:
29  // The delegate is responsible for figuring out how to notify the UI.
30  class Delegate {
31   public:
32    virtual ~Delegate();
33    virtual void NotifyDownloadStarting(content::DownloadItem* item) = 0;
34  };
35
36  // |manager| is the download manager to observe for new downloads. If
37  // |delegate.get()| is NULL, then the default delegate is constructed.
38  //
39  // On Android the default delegate notifies DownloadControllerAndroid. On
40  // other platforms the target of the notification is a Browser object.
41  //
42  // Currently explicit delegates are only used for testing.
43  DownloadUIController(content::DownloadManager* manager,
44                       scoped_ptr<Delegate> delegate);
45
46  virtual ~DownloadUIController();
47
48 private:
49  virtual void OnDownloadCreated(content::DownloadManager* manager,
50                                 content::DownloadItem* item) OVERRIDE;
51  virtual void OnDownloadUpdated(content::DownloadManager* manager,
52                                 content::DownloadItem* item) OVERRIDE;
53
54  AllDownloadItemNotifier download_notifier_;
55
56  scoped_ptr<Delegate> delegate_;
57
58  DISALLOW_COPY_AND_ASSIGN(DownloadUIController);
59};
60
61#endif  // CHROME_BROWSER_DOWNLOAD_DOWNLOAD_UI_CONTROLLER_H_
62