chrome/browser/android/shortcut_data_fetcher.h

   1 // Copyright 2015 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_ANDROID_SHORTCUT_DATA_FETCHER_H_
   6 #define CHROME_BROWSER_ANDROID_SHORTCUT_DATA_FETCHER_H_
   7
   8 #include "base/basictypes.h"
   9 #include "base/task/cancelable_task_tracker.h"
  10 #include "base/timer/timer.h"
  11 #include "chrome/browser/android/shortcut_info.h"
  12 #include "chrome/common/web_application_info.h"
  13 #include "components/favicon_base/favicon_types.h"
  14 #include "content/public/browser/web_contents_observer.h"
  15 #include "content/public/common/manifest.h"
  16
  17 namespace content {
  18 class WebContents;
  19 }  // namespace content
  20
  21 namespace IPC {
  22 class Message;
  23 }
  24
  25 class GURL;
  26
  27 // Aysnchronously fetches and processes data needed to create a shortcut for an
  28 // Android Home screen launcher.
  29 //
  30 // Because of the various asynchronous calls made by this class, it is
  31 // refcounted to prevent the class from being prematurely deleted.  If the
  32 // pointer to the ShortcutHelper becomes invalid, the pipeline should kill
  33 // itself.
  34 class ShortcutDataFetcher
  35     : public base::RefCounted<ShortcutDataFetcher>,
  36       public content::WebContentsObserver {
  37  public:
  38   class Observer {
  39    public:
  40     // Called when the title of the page is available.
  41     virtual void OnUserTitleAvailable(const base::string16& title) = 0;
  42
  43     // Converts the icon into one that can be used on the Android Home screen.
  44     virtual SkBitmap FinalizeLauncherIcon(const SkBitmap& icon,
  45                                           const GURL& url) = 0;
  46
  47     // Called when all the data needed to create a shortcut is available.
  48     virtual void OnDataAvailable(const ShortcutInfo& info,
  49                                  const SkBitmap& icon) = 0;
  50   };
  51
  52   // Initialize the fetcher by requesting the information about the page to the
  53   // renderer process. The initialization is asynchronous and
  54   // OnDidGetWebApplicationInfo is expected to be called when finished.
  55   ShortcutDataFetcher(content::WebContents* web_contents, Observer* observer);
  56
  57   // IPC message received when the initialization is finished.
  58   void OnDidGetWebApplicationInfo(const WebApplicationInfo& web_app_info);
  59
  60   // Called when the Manifest has been parsed, or if no Manifest was found.
  61   void OnDidGetManifest(const content::Manifest& manifest);
  62
  63   // Accessors, etc.
  64   void set_weak_observer(Observer* observer) { weak_observer_ = observer; }
  65   bool is_ready() { return is_ready_; }
  66   ShortcutInfo& shortcut_info() { return shortcut_info_; }
  67   const SkBitmap& shortcut_icon() { return shortcut_icon_; }
  68
  69   // WebContentsObserver
  70   bool OnMessageReceived(const IPC::Message& message) override;
  71
  72  private:
  73   ~ShortcutDataFetcher() override;
  74
  75   // Grabs the favicon for the current URL.
  76   void FetchFavicon();
  77   void OnFaviconFetched(
  78       const favicon_base::FaviconRawBitmapResult& bitmap_result);
  79
  80   // Creates the launcher icon from the given bitmap.
  81   void CreateLauncherIcon(
  82       const favicon_base::FaviconRawBitmapResult& bitmap_result);
  83
  84   // Callback run after an attempt to download manifest icon has been made.  May
  85   // kick off the download of a favicon if it failed.
  86   void OnManifestIconFetched(int id,
  87                              int http_status_code,
  88                              const GURL& url,
  89                              const std::vector<SkBitmap>& bitmaps,
  90                              const std::vector<gfx::Size>& sizes);
  91
  92   // Notifies the observer that the shortcut data is all available.
  93   void NotifyObserver(const SkBitmap& icon);
  94
  95   Observer* weak_observer_;
  96
  97   bool is_waiting_for_web_application_info_;
  98   bool is_icon_saved_;
  99   bool is_ready_;
 100   base::Timer icon_timeout_timer_;
 101   ShortcutInfo shortcut_info_;
 102
 103   // The icon must only be set on the UI thread for thread safety.
 104   SkBitmap shortcut_icon_;
 105   base::CancelableTaskTracker favicon_task_tracker_;
 106
 107   const int preferred_icon_size_in_px_;
 108   static const int kPreferredIconSizeInDp;
 109
 110   friend class base::RefCounted<ShortcutDataFetcher>;
 111   DISALLOW_COPY_AND_ASSIGN(ShortcutDataFetcher);
 112 };
 113
 114 #endif  // CHROME_BROWSER_ANDROID_SHORTCUT_DATA_FETCHER_H_