Popular sites on the NTP: Favicons!

chrome/android/java/src/org/chromium/chrome/browser/favicon/FaviconHelper.java

 // Copyright 2013 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.
 
 package org.chromium.chrome.browser.favicon;
 
 import android.graphics.Bitmap;
 import android.graphics.Color;
 
 import org.chromium.base.annotations.CalledByNative;
 import org.chromium.chrome.browser.profiles.Profile;
+import org.chromium.content_public.browser.WebContents;
 
 /**
  * This is a helper class to use favicon_service.cc's functionality.
  *
  * You can request a favicon image by web page URL. Note that an instance of
  * this class should be created & used & destroyed (by destroy()) in the same
  * thread due to the C++ base::CancelableTaskTracker class
  * requirement.
  */
 public class FaviconHelper {
@@ skipping 13 matching lines @@
         /**
          * This method will be called when the result favicon is ready.
          * @param image   Favicon image.
          * @param iconUrl Favicon image's icon url.
          */
         @CalledByNative("FaviconImageCallback")
         public void onFaviconAvailable(Bitmap image, String iconUrl);
     }
 
     /**
+     * Callback interface for the result of the ensureFaviconIsAvailable method.
+     */
+    public interface FaviconAvailabilityCallback {
+        /**
+         * This method will be called when the availability of the favicon has been checked.
+         * @param newlyAvailable true if the favicon was downloaded and is now available,
+         *            false if the favicon was already there or the download failed.
+         */
+        @CalledByNative("FaviconAvailabilityCallback")
+        public void onFaviconAvailabilityChecked(boolean newlyAvailable);
+    }
+
+    /**
      * Allocate and initialize the C++ side of this class.
      */
     public FaviconHelper() {
         mNativeFaviconHelper = nativeInit();
     }
 
     /**
      * Clean up the C++ side of this class. After the call, this class instance shouldn't be used.
      */
     public void destroy() {
@@ skipping 62 matching lines @@
      * @param profile   Profile used for the FaviconService construction.
      * @param pageUrl   The target Page URL to get the favicon.
      *
      * @return          16x16 favicon Bitmap corresponding to the pageUrl.
      */
     public Bitmap getSyncedFaviconImageForURL(Profile profile, String pageUrl) {
         assert mNativeFaviconHelper != 0;
         return nativeGetSyncedFaviconImageForURL(mNativeFaviconHelper, profile, pageUrl);
     }
 
+    public void ensureFaviconIsAvailable(
+            Profile profile, WebContents webContents, String pageUrl, String faviconUrl,
+            FaviconAvailabilityCallback callback) {
+        nativeEnsureFaviconIsAvailable(
+                mNativeFaviconHelper, profile, webContents, pageUrl, faviconUrl, callback);
+    }
+
     private static native long nativeInit();
     private static native void nativeDestroy(long nativeFaviconHelper);
     private static native boolean nativeGetLocalFaviconImageForURL(long nativeFaviconHelper,
             Profile profile, String pageUrl, int iconTypes, int desiredSizeInDip,
             FaviconImageCallback faviconImageCallback);
     private static native void nativeGetLargestRawFaviconForUrl(long nativeFaviconHelper,
             Profile profile, String pageUrl, int[] iconTypes, int minSizeThresholdPx,
             FaviconImageCallback faviconImageCallback);
     private static native Bitmap nativeGetSyncedFaviconImageForURL(long nativeFaviconHelper,
             Profile profile, String pageUrl);
     private static native int nativeGetDominantColorForBitmap(Bitmap image);
+    private static native void nativeEnsureFaviconIsAvailable(
+            long nativeFaviconHelper, Profile profile, WebContents webContents, String pageUrl,
+            String faviconUrl, FaviconAvailabilityCallback callback);
 }