Use upstream libaddressinput in Chrome.

third_party/libaddressinput/chromium/preload_address_validator.h

 // Copyright 2014 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 THIRD_PARTY_LIBADDRESSINPUT_CHROMIUM_PRELOAD_ADDRESS_VALIDATOR_H_
 #define THIRD_PARTY_LIBADDRESSINPUT_CHROMIUM_PRELOAD_ADDRESS_VALIDATOR_H_
 
 #include <cstddef>
 #include <string>
 #include <vector>
 
 #include "base/macros.h"
 #include "base/memory/scoped_ptr.h"
 #include "third_party/libaddressinput/src/cpp/include/libaddressinput/address_field.h"
 #include "third_party/libaddressinput/src/cpp/include/libaddressinput/address_validator.h"
 #include "third_party/libaddressinput/src/cpp/include/libaddressinput/callback.h"
+#include "third_party/libaddressinput/src/cpp/include/libaddressinput/preload_supplier.h"
 
 namespace i18n {
 namespace addressinput {
-
+class AddressNormalizer;
 class Downloader;
-class PreloadSupplier;
 class Storage;
-class Synonyms;
 struct AddressData;
-
-}  // namespace addressinput
-}  // namespace i18n
+struct AddressInputHelper;
+}
+}
 
 namespace autofill {
 
+class LoadRulesDelegate;
 class Suggestions;
 
-// Interface to the libaddressinput AddressValidator for Chromium Autofill.
-class PreloadAddressValidator {
+// Interface to the libaddressinput AddressValidator for Chromium Autofill. The
+// class is named AddressValidator to simplify switching between libaddressinput
+// and this version.
+//
+// It's not possible to name this file address_validator.h because some
+// compilers do not handle multiple files with the same name (although in
+// different directories) gracefully. This class uses preloaded validation rules

[Evan Stade, 2014/06/12 00:18:09]

what? so chrome doesn't load validation rules on demand any more?

I think that's false and "preload" is a bad name.

[please use gerrit instead, 2014/06/13 19:22:09]

Chrome loads all rules for a country when the user switches to that country in
the drop-down. In libaddressinput parlance, that's preloading. We can rename
preload_address_validator.h into something more comprehensible. Do you have
suggestions?

Libaddressinput also provides an alternative: on-demand loading of individual
rules at state, city, and dependent-locality level. This is how libaddresinput
is used internally, on the server side.

[Evan Stade, 2014/06/13 20:07:08]

It does load the rules on demand (saying it doesn't implies to me that it has a
stock set of rules that's never updated). It's just not as lazy as it could be
and doesn't reload for every request. You could just call the file
chromium_address_validator I guess, or rule_caching_address_validator

[please use gerrit instead, 2014/06/16 19:02:24]

Changed to chrome_address_validator to be similar to chrome_storage_impl and
chrome_downloader_impl.

+// instead of loading them on demand, hence the file name
+// preload_address_validator.h.
+class AddressValidator {
  public:
-  typedef ::i18n::addressinput::Callback<std::string, int> Callback;
-
   // The status of address validation.
   enum Status {
     // Address validation completed successfully. Check |problems| to see if any
     // problems were found.
     SUCCESS,
 
     // The validation rules are not available, because LoadRules() was not
     // called or failed. Reload the rules.
     RULES_UNAVAILABLE,
 
     // The validation rules are being loaded. Try again later.
     RULES_NOT_READY
   };
 
   // Takes ownership of |downloader| and |storage|.
-  PreloadAddressValidator(
-      const std::string& validation_data_url,
-      scoped_ptr< ::i18n::addressinput::Downloader> downloader,
-      scoped_ptr< ::i18n::addressinput::Storage> storage);
+  AddressValidator(const std::string& validation_data_url,
+                   scoped_ptr< ::i18n::addressinput::Downloader> downloader,
+                   scoped_ptr< ::i18n::addressinput::Storage> storage,
+                   LoadRulesDelegate* load_rules_delegate);
 
-  virtual ~PreloadAddressValidator();
+  virtual ~AddressValidator();
 
   // Loads the generic validation rules for |region_code| and specific rules
   // for the regions's administrative areas, localities, and dependent
   // localities. A typical data size is 10KB. The largest is 250KB. If a region
   // has language-specific validation rules, then these are also loaded.
   //
   // Example rule:
   // https://i18napis.appspot.com/ssl-aggregate-address/data/US
   //
   // If the rules are already in progress of being loaded, it does nothing.
-  // Calls |loaded| when the loading has finished.
-  virtual void LoadRules(const std::string& region_code,
-                         const Callback& loaded);
+  // Invokes |load_rules_delegate| when the loading has finished.
+  virtual void LoadRules(const std::string& region_code);
 
   // Validates the |address| and populates |problems| with the validation
   // problems, filtered according to the |filter| parameter.
   //
   // If the |filter| is empty, then all discovered validation problems are
   // returned. If the |filter| contains problem elements, then only the problems
   // in the |filter| may be returned.
-  virtual Status Validate(
+  virtual Status ValidateAddress(
       const ::i18n::addressinput::AddressData& address,
       const ::i18n::addressinput::FieldProblemMap* filter,
       ::i18n::addressinput::FieldProblemMap* problems) const;
 
   // Fills in |suggestions| for the partially typed in |user_input|, assuming
   // the user is typing in the |focused_field|. If the number of |suggestions|
   // is over the |suggestion_limit|, then returns no |suggestions| at all.
   //
   // If the |solutions| parameter is NULL, the checks whether the validation
   // rules are available, but does not fill in suggestions.
@@ skipping 25 matching lines @@
   // "texas" changes to "TX". Returns true on success, otherwise leaves
   // |address_data| alone and returns false.
   virtual bool CanonicalizeAdministrativeArea(
       ::i18n::addressinput::AddressData* address) const;
 
  private:
   void Validated(bool success,
                  const ::i18n::addressinput::AddressData&,
                  const ::i18n::addressinput::FieldProblemMap&);
 
+  void RulesLoaded(bool success, const std::string& country_code, const int&);
+
   const scoped_ptr< ::i18n::addressinput::PreloadSupplier> supplier_;
   const scoped_ptr<Suggestions> suggestions_;
-  const scoped_ptr< ::i18n::addressinput::Synonyms> synonyms_;
+  const scoped_ptr< ::i18n::addressinput::AddressNormalizer> normalizer_;
   const scoped_ptr<const ::i18n::addressinput::AddressValidator> validator_;
+  const scoped_ptr<const ::i18n::addressinput::AddressInputHelper>
+      input_helper_;
   const scoped_ptr<const ::i18n::addressinput::AddressValidator::Callback>
       validated_;
+  const scoped_ptr<const ::i18n::addressinput::PreloadSupplier::Callback>
+      rules_loaded_;
+  LoadRulesDelegate* const load_rules_delegate_;  // Not owned.
 
   friend class MockAddressValidator;
-  PreloadAddressValidator();
+  AddressValidator();
 
-  DISALLOW_COPY_AND_ASSIGN(PreloadAddressValidator);
+  DISALLOW_COPY_AND_ASSIGN(AddressValidator);
 };
 
 }  // namespace autofill
 
 #endif  // THIRD_PARTY_LIBADDRESSINPUT_CHROMIUM_PRELOAD_ADDRESS_VALIDATOR_H_