OLD | NEW |
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef CHROME_BROWSER_FAVICON_FAVICON_TAB_HELPER_H_ | 5 #ifndef CHROME_BROWSER_FAVICON_FAVICON_TAB_HELPER_H_ |
6 #define CHROME_BROWSER_FAVICON_FAVICON_TAB_HELPER_H_ | 6 #define CHROME_BROWSER_FAVICON_FAVICON_TAB_HELPER_H_ |
7 | 7 |
8 #include <vector> | 8 #include <vector> |
9 | 9 |
10 #include "base/basictypes.h" | 10 #include "base/basictypes.h" |
11 #include "base/callback.h" | 11 #include "base/callback.h" |
| 12 #include "chrome/browser/favicon/favicon_download_helper_delegate.h" |
12 #include "chrome/browser/favicon/favicon_handler_delegate.h" | 13 #include "chrome/browser/favicon/favicon_handler_delegate.h" |
13 #include "chrome/browser/history/history_types.h" | 14 #include "chrome/browser/history/history_types.h" |
14 #include "chrome/common/favicon_url.h" | 15 #include "chrome/common/favicon_url.h" |
15 #include "content/public/browser/web_contents_observer.h" | 16 #include "content/public/browser/web_contents_observer.h" |
16 #include "content/public/browser/web_contents_user_data.h" | 17 #include "content/public/browser/web_contents_user_data.h" |
17 | 18 |
18 namespace gfx { | 19 namespace gfx { |
19 class Image; | 20 class Image; |
20 } | 21 } |
21 | 22 |
22 class GURL; | 23 class GURL; |
23 class FaviconHandler; | 24 class FaviconHandler; |
24 class Profile; | 25 class Profile; |
25 class SkBitmap; | 26 class SkBitmap; |
26 | 27 |
27 // FaviconTabHelper works with FaviconHandlers to fetch the favicons. | 28 // FaviconTabHelper works with FaviconHandlers to fetch the favicons. |
28 // | 29 // |
29 // FetchFavicon fetches the given page's icons. It requests the icons from the | 30 // FetchFavicon fetches the given page's icons. It requests the icons from the |
30 // history backend. If the icon is not available or expired, the icon will be | 31 // history backend. If the icon is not available or expired, the icon will be |
31 // downloaded and saved in the history backend. | 32 // downloaded and saved in the history backend. |
32 // | 33 // |
33 // DownloadImage downloads the specified icon and returns it through the given | 34 // DownloadImage downloads the specified icon and returns it through the given |
34 // callback. | 35 // callback. |
35 // | 36 // |
36 class FaviconTabHelper : public content::WebContentsObserver, | 37 class FaviconTabHelper : public content::WebContentsObserver, |
37 public FaviconHandlerDelegate, | 38 public FaviconHandlerDelegate, |
| 39 public FaviconDownloadHelperDelegate, |
38 public content::WebContentsUserData<FaviconTabHelper> { | 40 public content::WebContentsUserData<FaviconTabHelper> { |
39 public: | 41 public: |
40 virtual ~FaviconTabHelper(); | 42 virtual ~FaviconTabHelper(); |
41 | 43 |
42 // Initiates loading the favicon for the specified url. | 44 // Initiates loading the favicon for the specified url. |
43 void FetchFavicon(const GURL& url); | 45 void FetchFavicon(const GURL& url); |
44 | 46 |
45 // Returns the favicon for this tab, or IDR_DEFAULT_FAVICON if the tab does | 47 // Returns the favicon for this tab, or IDR_DEFAULT_FAVICON if the tab does |
46 // not have a favicon. The default implementation uses the current navigation | 48 // not have a favicon. The default implementation uses the current navigation |
47 // entry. This will return an empty bitmap if there are no navigation | 49 // entry. This will return an empty bitmap if there are no navigation |
48 // entries, which should rarely happen. | 50 // entries, which should rarely happen. |
49 gfx::Image GetFavicon() const; | 51 gfx::Image GetFavicon() const; |
50 | 52 |
51 // Returns true if we have the favicon for the page. | 53 // Returns true if we have the favicon for the page. |
52 bool FaviconIsValid() const; | 54 bool FaviconIsValid() const; |
53 | 55 |
54 // Returns whether the favicon should be displayed. If this returns false, no | 56 // Returns whether the favicon should be displayed. If this returns false, no |
55 // space is provided for the favicon, and the favicon is never displayed. | 57 // space is provided for the favicon, and the favicon is never displayed. |
56 virtual bool ShouldDisplayFavicon(); | 58 virtual bool ShouldDisplayFavicon(); |
57 | 59 |
| 60 // Message Handler. Must be public, because also called from |
| 61 // PrerenderContents. |
| 62 virtual void OnUpdateFaviconURL(int32 page_id, |
| 63 const std::vector<FaviconURL>& candidates) OVERRIDE; |
| 64 |
58 // Saves the favicon for the current page. | 65 // Saves the favicon for the current page. |
59 void SaveFavicon(); | 66 void SaveFavicon(); |
60 | 67 |
61 // Initiates loading an image from given |image_url|. Returns a download id | 68 // Initiates loading an image from given |image_url|. Returns a download id |
62 // for caller to track the request. When download completes, |callback| is | 69 // for caller to track the request. When download completes, |callback| is |
63 // called with the three params: the download_id, a boolean flag to indicate | 70 // called with the three params: the download_id, a boolean flag to indicate |
64 // whether the download succeeds and a SkBitmap as the downloaded image. | 71 // whether the download succeeds and a SkBitmap as the downloaded image. |
65 // Note that |image_size| is a hint for images with multiple sizes. The | 72 // Note that |image_size| is a hint for images with multiple sizes. The |
66 // downloaded image is not resized to the given image_size. If 0 is passed, | 73 // downloaded image is not resized to the given image_size. If 0 is passed, |
67 // the first frame of the image is returned. | 74 // the first frame of the image is returned. |
68 typedef base::Callback<void(int, bool, const SkBitmap&)> | 75 typedef base::Callback<void(int, bool, const SkBitmap&)> |
69 ImageDownloadCallback; | 76 ImageDownloadCallback; |
70 int DownloadImage(const GURL& image_url, | 77 int DownloadImage(const GURL& image_url, |
71 int image_size, | 78 int image_size, |
72 history::IconType icon_type, | 79 history::IconType icon_type, |
73 const ImageDownloadCallback& callback); | 80 const ImageDownloadCallback& callback); |
74 | 81 |
75 // Message Handler. Must be public, because also called from | |
76 // PrerenderContents. | |
77 void OnUpdateFaviconURL(int32 page_id, | |
78 const std::vector<FaviconURL>& candidates); | |
79 | |
80 // FaviconHandlerDelegate methods. | 82 // FaviconHandlerDelegate methods. |
81 virtual content::NavigationEntry* GetActiveEntry() OVERRIDE; | 83 virtual content::NavigationEntry* GetActiveEntry() OVERRIDE; |
82 virtual int StartDownload(const GURL& url, int image_size) OVERRIDE; | 84 virtual int StartDownload(const GURL& url, int image_size) OVERRIDE; |
83 virtual void NotifyFaviconUpdated() OVERRIDE; | 85 virtual void NotifyFaviconUpdated() OVERRIDE; |
84 | 86 |
85 private: | 87 private: |
86 explicit FaviconTabHelper(content::WebContents* web_contents); | 88 explicit FaviconTabHelper(content::WebContents* web_contents); |
87 friend class content::WebContentsUserData<FaviconTabHelper>; | 89 friend class content::WebContentsUserData<FaviconTabHelper>; |
88 | 90 |
89 // content::WebContentsObserver overrides. | 91 // content::WebContentsObserver overrides. |
90 virtual void NavigateToPendingEntry( | 92 virtual void NavigateToPendingEntry( |
91 const GURL& url, | 93 const GURL& url, |
92 content::NavigationController::ReloadType reload_type) OVERRIDE; | 94 content::NavigationController::ReloadType reload_type) OVERRIDE; |
93 virtual void DidNavigateMainFrame( | 95 virtual void DidNavigateMainFrame( |
94 const content::LoadCommittedDetails& details, | 96 const content::LoadCommittedDetails& details, |
95 const content::FrameNavigateParams& params) OVERRIDE; | 97 const content::FrameNavigateParams& params) OVERRIDE; |
96 virtual bool OnMessageReceived(const IPC::Message& message) OVERRIDE; | |
97 | 98 |
98 // Message handler for IconHostMsg_DidDownloadFavicon. | 99 // FaviconDownloadHelperDelegate overrides. |
99 void OnDidDownloadFavicon(int id, | 100 virtual void OnDidDownloadFavicon( |
100 const GURL& image_url, | 101 int id, |
101 bool errored, | 102 const GURL& image_url, |
102 int requested_size, | 103 bool errored, |
103 const std::vector<SkBitmap>& bitmaps); | 104 int requested_size, |
| 105 const std::vector<SkBitmap>& bitmaps) OVERRIDE; |
104 | 106 |
105 Profile* profile_; | 107 Profile* profile_; |
106 | 108 |
107 scoped_ptr<FaviconHandler> favicon_handler_; | 109 scoped_ptr<FaviconHandler> favicon_handler_; |
108 | 110 |
109 // Handles downloading touchicons. It is NULL if | 111 // Handles downloading touchicons. It is NULL if |
110 // browser_defaults::kEnableTouchIcon is false. | 112 // browser_defaults::kEnableTouchIcon is false. |
111 scoped_ptr<FaviconHandler> touch_icon_handler_; | 113 scoped_ptr<FaviconHandler> touch_icon_handler_; |
112 | 114 |
113 DISALLOW_COPY_AND_ASSIGN(FaviconTabHelper); | 115 DISALLOW_COPY_AND_ASSIGN(FaviconTabHelper); |
114 }; | 116 }; |
115 | 117 |
116 #endif // CHROME_BROWSER_FAVICON_FAVICON_TAB_HELPER_H_ | 118 #endif // CHROME_BROWSER_FAVICON_FAVICON_TAB_HELPER_H_ |
OLD | NEW |