Get web app icon via FavIconHelper and auto repair/update

chrome/browser/fav_icon_helper.h

 // Copyright (c) 2006-2008 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 CHROME_BROWSER_FAV_ICON_HELPER_H__
 #define CHROME_BROWSER_FAV_ICON_HELPER_H__
 
 #include <map>
 #include <vector>
 
@@ skipping 49 matching lines @@
 // db knew about the favicon), or requests the renderer to download the
 // favicon.
 //
 // When the renderer downloads the favicon SetFavIconImageData is invoked,
 // at which point we update the favicon of the NavigationEntry and notify
 // the database to save the favicon.
 
 class FavIconHelper : public RenderViewHostDelegate::FavIcon {
  public:
   explicit FavIconHelper(TabContents* tab_contents);
+  virtual ~FavIconHelper();
 
   // Initiates loading the favicon for the specified url.
   void FetchFavIcon(const GURL& url);
 
-  // Sets the image data for the favicon. This is invoked asynchronously after
-  // we request the TabContents to download the favicon.
-  void SetFavIcon(int download_id,
-                  const GURL& icon_url,
-                  const SkBitmap& image);
-
-  // Invoked when a request to download the favicon failed.
-  void FavIconDownloadFailed(int download_id);
-
-  // Converts the image data to an SkBitmap and sets it on the NavigationEntry.
-  // If the TabContents has a delegate, it is notified of the new favicon
-  // (INVALIDATE_FAVICON).
-  void UpdateFavIcon(NavigationEntry* entry,
-                     const std::vector<unsigned char>& data);
-  void UpdateFavIcon(NavigationEntry* entry, const SkBitmap& image);
+  // Initiates loading an image from given |image_url|. Returns a download id
+  // for caller to track the request. When download completes, |callback| is
+  // called with the three params: the download_id, a boolean flag to indicate
+  // whether the download succeeds and a SkBitmap as the downloaded image.
+  // Note that |image_size| is a hint for images with multiple sizes. The
+  // downloaded image is not resized to the given image_size. If 0 is passed,
+  // the first frame of the image is returned.
+  typedef Callback3<int, bool, const SkBitmap&>::Type ImageDownloadCallback;
+  int DownloadImage(const GURL& image_url, int image_size,
+                    ImageDownloadCallback* callback);
 
  private:
   struct DownloadRequest {
     DownloadRequest() {}
     DownloadRequest(const GURL& url,
-                    const GURL& fav_icon_url)
+                    const GURL& image_url,
+                    ImageDownloadCallback* callback)
         : url(url),
-          fav_icon_url(fav_icon_url) { }
+          image_url(image_url),
+          callback(callback) { }
 
     GURL url;
-    GURL fav_icon_url;
+    GURL image_url;
+    ImageDownloadCallback* callback;
   };
 
   // RenderViewHostDelegate::Favicon implementation.
   virtual void DidDownloadFavIcon(RenderViewHost* render_view_host,
                                   int id,
                                   const GURL& image_url,
                                   bool errored,
                                   const SkBitmap& image);
   virtual void UpdateFavIconURL(RenderViewHost* render_view_host,
                                 int32 page_id,
@@ skipping 21 matching lines @@
 
   // See description above class for details.
   void OnFavIconData(FaviconService::Handle handle,
                      bool know_favicon,
                      scoped_refptr<RefCountedBytes> data,
                      bool expired,
                      GURL icon_url);
 
   // Schedules a download for the specified entry. This adds the request to
   // download_requests_.
-  void ScheduleDownload(NavigationEntry* entry);
+  int ScheduleDownload(const GURL& url, const GURL& image_url, int image_size,
+                       ImageDownloadCallback* callback);
+
+  // Sets the image data for the favicon. This is invoked asynchronously after
+  // we request the TabContents to download the favicon.
+  void SetFavIcon(const GURL& url, const GURL& icon_url, const SkBitmap& image);
+
+  // Converts the image data to an SkBitmap and sets it on the NavigationEntry.
+  // If the TabContents has a delegate, it is notified of the new favicon
+  // (INVALIDATE_FAVICON).
+  void UpdateFavIcon(NavigationEntry* entry,
+                     const std::vector<unsigned char>& data);
+  void UpdateFavIcon(NavigationEntry* entry, const SkBitmap& image);
 
   // Scales the image such that either the width and/or height is 16 pixels
   // wide. Does nothing if the image is empty.
   SkBitmap ConvertToFavIconSize(const SkBitmap& image);
 
   // Hosting TabContents. We callback into this when done.
   TabContents* tab_contents_;
 
   // Used for history requests.
   CancelableRequestConsumer cancelable_consumer_;
@@ skipping 16 matching lines @@
   bool fav_icon_expired_;
 
   // Requests to the renderer to download favicons.
   typedef std::map<int, DownloadRequest> DownloadRequests;
   DownloadRequests download_requests_;
 
   DISALLOW_EVIL_CONSTRUCTORS(FavIconHelper);
 };
 
 #endif  // CHROME_BROWSER_FAV_ICON_HELPER_H__