Revert 282408 "Use upstream libaddressinput in Chrome."

trunk/src/third_party/libaddressinput/chromium/chrome_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_CHROME_ADDRESS_VALIDATOR_H_
-#define THIRD_PARTY_LIBADDRESSINPUT_CHROMIUM_CHROME_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 Storage;
-struct AddressData;
-}
-}
-
-namespace autofill {
-
-class InputSuggester;
-
-// The object to be notified when loading of address validation rules is
-// finished.
-class LoadRulesListener {
- public:
-  virtual ~LoadRulesListener() {}
-
-  // Called when the validation rules for the |country_code| have been loaded.
-  // The validation rules include the generic rules for the |country_code| and
-  // specific rules for the country's administrative areas, localities, and
-  // dependent localities. If a country has language-specific validation rules,
-  // then these are also loaded.
-  //
-  // The |success| parameter is true when the rules were loaded successfully.
-  virtual void OnAddressValidationRulesLoaded(const std::string& country_code,
-                                              bool success) = 0;
-};
-
-// 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 is a shim between upstream
-// libaddressinput API and the API that Chrome expects, hence the file name
-// chrome_address_validator.h.
-class AddressValidator {
- public:
-  // 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|.
-  AddressValidator(const std::string& validation_data_url,
-                   scoped_ptr< ::i18n::addressinput::Downloader> downloader,
-                   scoped_ptr< ::i18n::addressinput::Storage> storage,
-                   LoadRulesListener* load_rules_listener);
-
-  virtual ~AddressValidator();
-
-  // Loads the generic validation rules for |region_code| and specific rules
-  // for the region'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.
-  // Invokes |load_rules_listener| 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 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.
-  //
-  // Sample user input 1:
-  //   country code = "US"
-  //   postal code = "90066"
-  //   focused field = POSTAL_CODE
-  //   suggestions limit = 1
-  // Suggestion:
-  //   [{administrative_area: "CA"}]
-  //
-  // Sample user input 2:
-  //   country code = "CN"
-  //   dependent locality = "Zongyang"
-  //   focused field = DEPENDENT_LOCALITY
-  //   suggestions limit = 10
-  // Suggestion:
-  //   [{dependent_locality: "Zongyang Xian",
-  //     locality: "Anqing Shi",
-  //     administrative_area: "Anhui Sheng"}]
-  virtual Status GetSuggestions(
-      const ::i18n::addressinput::AddressData& user_input,
-      ::i18n::addressinput::AddressField focused_field,
-      size_t suggestion_limit,
-      std::vector< ::i18n::addressinput::AddressData>* suggestions) const;
-
-  // Canonicalizes the administrative area in |address_data|. For example,
-  // "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:
-  friend class MockAddressValidator;
-
-  // Constructor used only for MockAddressValidator.
-  AddressValidator();
-
-  // Verifies that |validator_| succeeded. Invoked by |validated_| callback.
-  void Validated(bool success,
-                 const ::i18n::addressinput::AddressData&,
-                 const ::i18n::addressinput::FieldProblemMap&);
-
-  // Invokes the |load_rules_listener_|, if it's not NULL. Called by
-  // |rules_loaded_| callback.
-  void RulesLoaded(bool success, const std::string& country_code, int);
-
-  // Loads and stores aggregate rules at COUNTRY level.
-  const scoped_ptr< ::i18n::addressinput::PreloadSupplier> supplier_;
-
-  // Suggests addresses based on user input.
-  const scoped_ptr<InputSuggester> input_suggester_;
-
-  // Normalizes addresses into a canonical form.
-  const scoped_ptr< ::i18n::addressinput::AddressNormalizer> normalizer_;
-
-  // Validates addresses.
-  const scoped_ptr<const ::i18n::addressinput::AddressValidator> validator_;
-
-  // The callback that |validator_| invokes when it finished validating an
-  // address.
-  const scoped_ptr<const ::i18n::addressinput::AddressValidator::Callback>
-      validated_;
-
-  // The callback that |supplier_| invokes when it finished loading rules.
-  const scoped_ptr<const ::i18n::addressinput::PreloadSupplier::Callback>
-      rules_loaded_;
-
-  // Not owned delegate to invoke when |suppler_| finished loading rules. Can be
-  // NULL.
-  LoadRulesListener* const load_rules_listener_;
-
-  DISALLOW_COPY_AND_ASSIGN(AddressValidator);
-};
-
-}  // namespace autofill
-
-#endif  // THIRD_PARTY_LIBADDRESSINPUT_CHROMIUM_CHROME_ADDRESS_VALIDATOR_H_