[Autofill] Sort profiles and credit cards by frecency in PaymentRequest.

chrome/browser/autofill/android/personal_data_manager_android.h

 // 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.
 
 #ifndef CHROME_BROWSER_AUTOFILL_ANDROID_PERSONAL_DATA_MANAGER_ANDROID_H_
 #define CHROME_BROWSER_AUTOFILL_ANDROID_PERSONAL_DATA_MANAGER_ANDROID_H_
 
 #include "base/android/jni_weak_ref.h"
 #include "base/android/scoped_java_ref.h"
 #include "base/macros.h"
 #include "components/autofill/core/browser/personal_data_manager.h"
 #include "components/autofill/core/browser/personal_data_manager_observer.h"
 
 namespace autofill {
 
 // Android wrapper of the PersonalDataManager which provides access from the
 // Java layer. Note that on Android, there's only a single profile, and
 // therefore a single instance of this wrapper.
 class PersonalDataManagerAndroid : public PersonalDataManagerObserver {
  public:
   PersonalDataManagerAndroid(JNIEnv* env, jobject obj);
 
   // These functions act on "web profiles" aka "LOCAL_PROFILE" profiles.
   // -------------------------
 
-  // Returns the number of web and auxiliary profiles.
-  jint GetProfileCount(JNIEnv* unused_env,
-                       const base::android::JavaParamRef<jobject>& unused_obj);
+  // Returns the GUIDs of all profiles.
+  base::android::ScopedJavaLocalRef<jobjectArray> GetProfileGUIDsForSettings(
+      JNIEnv* env,
+      const base::android::JavaParamRef<jobject>& unused_obj);
 
-  // Returns the profile as indexed by |index| in the PersonalDataManager's
-  // |GetProfiles()| collection.
-  base::android::ScopedJavaLocalRef<jobject> GetProfileByIndex(
+  // Returns the GUIDs of the profiles to suggest to the user. See
+  // PersonalDataManager::GetProfilesToSuggest for more details.
+  base::android::ScopedJavaLocalRef<jobjectArray> GetProfileGUIDsToSuggest(
       JNIEnv* env,
-      const base::android::JavaParamRef<jobject>& unused_obj,
-      jint index);
+      const base::android::JavaParamRef<jobject>& unused_obj);
 
   // Returns the profile with the specified |jguid|, or NULL if there is no
   // profile with the specified |jguid|. Both web and auxiliary profiles may
   // be returned.
   base::android::ScopedJavaLocalRef<jobject> GetProfileByGUID(
       JNIEnv* env,
       const base::android::JavaParamRef<jobject>& unused_obj,
       const base::android::JavaParamRef<jstring>& jguid);
 
   // Adds or modifies a profile.  If |jguid| is an empty string, we are creating
   // a new profile.  Else we are updating an existing profile.  Always returns
   // the GUID for this profile; the GUID it may have just been created.
   base::android::ScopedJavaLocalRef<jstring> SetProfile(
       JNIEnv* env,
       const base::android::JavaParamRef<jobject>& unused_obj,
       const base::android::JavaParamRef<jobject>& jprofile);
 
   // Gets the labels for all known profiles. These labels are useful for
   // distinguishing the profiles from one another.
   //
   // The labels never contain the full name and include at least 2 fields.
+  base::android::ScopedJavaLocalRef<jobjectArray> GetProfileLabelsForSettings(
+      JNIEnv* env,
+      const base::android::JavaParamRef<jobject>& unused_obj);
+
+  // Gets the labels for the profiles to suggest to the user. These labels are
+  // useful for distinguishing the profiles from one another.
   //
-  // If |address_only| is true, then such fields as phone number and email
-  // address are also omitted, but all fields are included in the label.
-  base::android::ScopedJavaLocalRef<jobjectArray> GetProfileLabels(
+  // The labels never contain the full name and include at least 2 fields.
+  //
+  // Fields such as phone number and email address are also omitted, but all

[please use gerrit instead, 2016/05/31 18:51:56]

This comment is inconsistent. Above you say "at least 2 fields." Here you say
"all fields are included."  I think the latter is correct. Please clean up.

[sebsg, 2016/06/01 20:58:24]

Done.

+  // fields are included in the label.
+  base::android::ScopedJavaLocalRef<jobjectArray> GetProfileLabelsToSuggest(
       JNIEnv* env,
-      const base::android::JavaParamRef<jobject>& unused_obj,
-      bool address_only);
+      const base::android::JavaParamRef<jobject>& unused_obj);
 
   // These functions act on local credit cards.
   // --------------------
 
-  // Returns the number of credit cards.
-  jint GetCreditCardCount(
-      JNIEnv* unused_env,
+  // Returns the GUIDs of all the credit cards.
+  base::android::ScopedJavaLocalRef<jobjectArray> GetCreditCardGUIDsForSettings(
+      JNIEnv* env,
       const base::android::JavaParamRef<jobject>& unused_obj);
 
-  // Returns the credit card as indexed by |index| in the PersonalDataManager's
-  // |GetCreditCards()| collection.
-  base::android::ScopedJavaLocalRef<jobject> GetCreditCardByIndex(
+  // Returns the GUIDs of the credit cards to suggest to the user. See
+  // PersonalDataManager::GetCreditCardsToSuggest for more details.
+  base::android::ScopedJavaLocalRef<jobjectArray> GetCreditCardGUIDsToSuggest(
       JNIEnv* env,
-      const base::android::JavaParamRef<jobject>& unused_obj,
-      jint index);
+      const base::android::JavaParamRef<jobject>& unused_obj);
 
   // Returns the credit card with the specified |jguid|, or NULL if there is
   // no credit card with the specified |jguid|.
   base::android::ScopedJavaLocalRef<jobject> GetCreditCardByGUID(
       JNIEnv* env,
       const base::android::JavaParamRef<jobject>& unused_obj,
       const base::android::JavaParamRef<jstring>& jguid);
 
   // Adds or modifies a local credit card.  If |jguid| is an empty string, we
   // are creating a new card.  Else we are updating an existing profile.  Always
@@ skipping 27 matching lines @@
       const base::android::JavaParamRef<jobject>& jweb_contents,
       const base::android::JavaParamRef<jstring>& jguid,
       const base::android::JavaParamRef<jobject>& jdelegate);
 
   // PersonalDataManagerObserver:
   void OnPersonalDataChanged() override;
 
   // Registers the JNI bindings for this class.
   static bool Register(JNIEnv* env);
 
+  // Sets the use count and use date of the profile associated to the |jguid|.
+  // Both |count| and |date| should be non-negative. |date| represents an
+  // absolute point in coordinated universal time (UTC) represented as
+  // microseconds since the Windows epoch. For more details see the comment
+  // header in time.h.
+  void SetProfileUseStatsForTesting(
+      JNIEnv* env,
+      const base::android::JavaParamRef<jobject>& unused_obj,
+      const base::android::JavaParamRef<jstring>& jguid,
+      jint count,
+      jint date);
+
+  // Sets the use count and use date of the credit card associated to the
+  // |jguid|. Both |count| and |date| should be non-negative. |date| represents
+  // an absolute point in coordinated universal time (UTC) represented as
+  // microseconds since the Windows epoch. For more details see the comment
+  // header in time.h.
+  void SetCreditCardUseStatsForTesting(
+      JNIEnv* env,
+      const base::android::JavaParamRef<jobject>& unused_obj,
+      const base::android::JavaParamRef<jstring>& jguid,
+      jint count,
+      jint date);
+
  private:
   ~PersonalDataManagerAndroid() override;
 
+  // Returns the GUIDs of the |profiles| passed as parameter.
+  base::android::ScopedJavaLocalRef<jobjectArray> GetProfileGUIDs(
+      JNIEnv* env,
+      const std::vector<AutofillProfile*>& profiles);
+
+  // Returns the GUIDs of the |credit_cards| passed as parameter.
+  base::android::ScopedJavaLocalRef<jobjectArray> GetCreditCardGUIDs(
+      JNIEnv* env,
+      const std::vector<CreditCard*>& credit_cards);
+
+  // Gets the labels for the |profiles| passed as paremeters. These labels are

[gone, 2016/05/31 22:39:42]

nit: parameters

[sebsg, 2016/06/01 20:58:24]

Done.

+  // useful for distinguishing the profiles from one another.
+  //
+  // The labels never contain the full name and include at least 2 fields.
+  //
+  // If |address_only| is true, then such fields as phone number and email
+  // address are also omitted, but all fields are included in the label.
+  base::android::ScopedJavaLocalRef<jobjectArray> GetProfileLabels(
+      JNIEnv* env,
+      bool address_only,
+      std::vector<AutofillProfile*> profiles);
+
   // Pointer to the java counterpart.
   JavaObjectWeakGlobalRef weak_java_obj_;
 
   // Pointer to the PersonalDataManager for the main profile.
   PersonalDataManager* personal_data_manager_;
 
   DISALLOW_COPY_AND_ASSIGN(PersonalDataManagerAndroid);
 };
 
 }  // namespace autofill
 
 #endif  // CHROME_BROWSER_AUTOFILL_ANDROID_PERSONAL_DATA_MANAGER_ANDROID_H_