[Payments] Normalize addresses before passing them to merchants.

chrome/android/java/src/org/chromium/chrome/browser/autofill/PersonalDataManager.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.autofill;
 
 import android.content.Context;
 
 import org.chromium.base.ThreadUtils;
 import org.chromium.base.VisibleForTesting;
@@ skipping 44 matching lines @@
         void onFullCardDetails(CreditCard card, String cvc);
 
         /**
          * Called when user did not provide full card details.
          */
         @CalledByNative("FullCardRequestDelegate")
         void onFullCardError();
     }
 
     /**
+     * Callback for normalized addresses.
+     */
+    public interface NormalizedAddressRequestDelegate {
+        /**
+         * Called when the address has been sucessfully normalized.
+         *
+         * @param profile The profile with the normalized address.
+         */
+        @CalledByNative("NormalizedAddressRequestDelegate")
+        void onAddressNormalized(AutofillProfile profile);
+    }
+
+    /**
      * Autofill address information.
      */
     public static class AutofillProfile {
         private String mGUID;
         private String mOrigin;
         private boolean mIsLocal;
         private String mFullName;
         private String mCompanyName;
         private String mStreetAddress;
         private String mRegion;
@@ skipping 392 matching lines @@
     private static PersonalDataManager sManager;
 
     public static PersonalDataManager getInstance() {
         ThreadUtils.assertOnUiThread();
         if (sManager == null) {
             sManager = new PersonalDataManager();
         }
         return sManager;
     }
 
+    private static int sNormalizationTimeoutMs = 5000;
+
     private final long mPersonalDataManagerAndroid;
     private final List<PersonalDataManagerObserver> mDataObservers =
             new ArrayList<PersonalDataManagerObserver>();
 
     private PersonalDataManager() {
         // Note that this technically leaks the native object, however, PersonalDataManager
         // is a singleton that lives forever and there's no clean shutdown of Chrome on Android
         mPersonalDataManagerAndroid = nativeInit();
     }
 
@@ skipping 224 matching lines @@
         return nativeGetCreditCardUseDateForTesting(mPersonalDataManagerAndroid, guid);
     }
 
     @VisibleForTesting
     long getCurrentDateForTesting() {
         ThreadUtils.assertOnUiThread();
         return nativeGetCurrentDateForTesting(mPersonalDataManagerAndroid);
     }
 
     /**
+     * Starts loading the address validation rules for the specified {@code regionCode}.
+     *
+     * @param regionCode The code of the region for which to load the rules.
+     */
+    public void loadRulesForRegion(String regionCode) {
+        ThreadUtils.assertOnUiThread();
+        nativeLoadRulesForRegion(mPersonalDataManagerAndroid, regionCode);
+    }
+
+    /**
+     * Normalizes the address of the profile associated with the {@code guid} if the rules
+     * associated with the {@code regionCode} are done loading. Otherwise sets up the callback to
+     * start normalizing the address when the rules are loaded. The normalized profile will be sent
+     * to the {@code delegate}.
+     *
+     * @param guid The GUID of the profile to normalize.
+     * @param regionCode The region code indicating which rules to use for normalization.
+     * @param delegate The object requesting the normalization.
+     *
+     * @return Whether the normalization will happen asynchronously.
+     */
+    public boolean normalizeAddress(
+            String guid, String regionCode, NormalizedAddressRequestDelegate delegate) {
+        ThreadUtils.assertOnUiThread();
+        return nativeStartAddressNormalization(
+                mPersonalDataManagerAndroid, guid, regionCode, delegate);
+    }
+
+    /** Cancels the pending address normalization. */
+    public void cancelPendingAddressNormalization() {
+        ThreadUtils.assertOnUiThread();
+        nativeCancelPendingAddressNormalization(mPersonalDataManagerAndroid);
+    }
+
+    /**
      * @return Whether the Autofill feature is enabled.
      */
     public static boolean isAutofillEnabled() {
         return nativeIsAutofillEnabled();
     }
 
     /**
      * Enables or disables the Autofill feature.
      * @param enable True to disable Autofill, false otherwise.
      */
@@ skipping 16 matching lines @@
     }
 
     /**
      * Enables or disables the Payments integration.
      * @param enable True to enable Payments data import.
      */
     public static void setPaymentsIntegrationEnabled(boolean enable) {
         nativeSetPaymentsIntegrationEnabled(enable);
     }
 
+    /**
+     * @return The timeout value for normalization.
+     */
+    public static int getNormalizationTimeoutMS() {
+        return sNormalizationTimeoutMs;
+    }
+
+    @VisibleForTesting
+    public static void setNormalizationTimeoutForTesting(int timeout) {
+        sNormalizationTimeoutMs = timeout;
+    }
+
     private native long nativeInit();
     private native boolean nativeIsDataLoaded(long nativePersonalDataManagerAndroid);
     private native String[] nativeGetProfileGUIDsForSettings(long nativePersonalDataManagerAndroid);
     private native String[] nativeGetProfileGUIDsToSuggest(long nativePersonalDataManagerAndroid);
     private native String[] nativeGetProfileLabelsForSettings(
             long nativePersonalDataManagerAndroid);
     private native String[] nativeGetProfileLabelsToSuggest(long nativePersonalDataManagerAndroid,
             boolean includeName);
     private native AutofillProfile nativeGetProfileByGUID(long nativePersonalDataManagerAndroid,
             String guid);
@@ skipping 32 matching lines @@
             long nativePersonalDataManagerAndroid, String guid, int count, long date);
     private native int nativeGetCreditCardUseCountForTesting(long nativePersonalDataManagerAndroid,
             String guid);
     private native long nativeGetCreditCardUseDateForTesting(long nativePersonalDataManagerAndroid,
             String guid);
     private native long nativeGetCurrentDateForTesting(long nativePersonalDataManagerAndroid);
     private native void nativeClearUnmaskedCache(
             long nativePersonalDataManagerAndroid, String guid);
     private native void nativeGetFullCardForPaymentRequest(long nativePersonalDataManagerAndroid,
             WebContents webContents, CreditCard card, FullCardRequestDelegate delegate);
+    private native void nativeLoadRulesForRegion(
+            long nativePersonalDataManagerAndroid, String regionCode);
+    private native boolean nativeStartAddressNormalization(long nativePersonalDataManagerAndroid,
+            String guid, String regionCode, NormalizedAddressRequestDelegate delegate);
+    private native void nativeCancelPendingAddressNormalization(
+            long nativePersonalDataManagerAndroid);
     private static native boolean nativeIsAutofillEnabled();
     private static native void nativeSetAutofillEnabled(boolean enable);
     private static native boolean nativeIsAutofillManaged();
     private static native boolean nativeIsPaymentsIntegrationEnabled();
     private static native void nativeSetPaymentsIntegrationEnabled(boolean enable);
     private static native String nativeToCountryCode(String countryName);
 }