// Copyright (C) 2014 Google Inc. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. #ifndef I18N_ADDRESSINPUT_ONDEMAND_SUPPLIER_H_ #define I18N_ADDRESSINPUT_ONDEMAND_SUPPLIER_H_ #include <libaddressinput/callback.h> #include <libaddressinput/supplier.h> #include <map> #include <memory> #include <string> namespace i18n { namespace addressinput { class LookupKey; class Retriever; class Rule; class Source; class Storage; // An implementation of the Supplier interface that owns a Retriever object, // through which it loads address metadata as needed, creating Rule objects and // caching these. // // When using an OndemandSupplier, address validation will benefit from address // metadata server synonym resolution, because the server will be contacted for // every new LookupKey (ie. every LookupKey that isn't on canonical form and // isn't already cached). // // The maximum size of this cache is naturally limited to the amount of data // available from the data server. (Currently this is less than 12,000 items of // in total less than 2 MB of JSON data.) class OndemandSupplier : public Supplier { … }; } // namespace addressinput } // namespace i18n #endif // I18N_ADDRESSINPUT_ONDEMAND_SUPPLIER_H_