Add PPDProvider barebones implementation and associated cache skeleton.

chromeos/printing/printer_configuration.h

 // Copyright 2016 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 CHROMEOS_PRINTING_PRINTER_CONFIGURATION_H_
 #define CHROMEOS_PRINTING_PRINTER_CONFIGURATION_H_
 
 #include <memory>
 #include <string>
 
 #include "base/macros.h"
 #include "chromeos/chromeos_export.h"
 
 namespace chromeos {
 
 class CHROMEOS_EXPORT Printer {
  public:
-  // Represents a Postscript Printer Description with which the printer was
-  // setup.
-  struct PPDFile {
-    // Identifier from the quirks server. -1 otherwise.
-    int id = -1;
+  // Information needed to find the PPD file for this printer.

[Lei Zhang, 2016/10/17 17:54:07]

Why is this still here? Didn't these changes land in
https://codereview.chromium.org/2408293002/ already? Please rebased.

[Carlson, 2016/10/18 19:05:01]

Done.

+  //
+  // If you add fields to this struct, you almost certainly will
+  // want to update PpdResolver and PpdCache::GetCachePath.
+  //
+  // At resolution time, we look for a cached PPD that used the same
+  // PpdReference before.
+  //
+  // If one is not found and user_supplied_ppd_url is set, we'll fail
+  // out with NOT FOUND
+  //
+  // Otherwise, we'll hit QuirksServer to see if we can resolve a Ppd
+  // using manufacturer/model
+  struct PpdReference {
+    // If non-empty, this is the url of a specific PPD the user has specified
+    // for use with this printer.
+    std::string user_supplied_ppd_url;
 
-    std::string file_name;
-
-    // If there is a file with a later version on the quirks server, that file
-    // should be used. The default value is 0.
-    int version_number = 0;
-
-    // This will be true if the file was retrived from the quirks server.
-    // Otherwise, the file was saved to disk by the user.
-    bool from_quirks_server = false;
+    // The *effective* manufacturer and model of this printer, in other words,
+    // the manufacturer and model of the printer for which we grab a PPD.  This
+    // doesn’t have to (but can) be the actual manufacturer/model of the
+    // printer.  We should always try to fill these fields in, even if we don’t
+    // think they’ll be needed, as they provide a fallback mechanism for
+    // finding a PPD.
+    std::string effective_manufacturer;
+    std::string effective_model;
   };
 
   // Constructs a printer object that is completely empty.
   Printer();
 
   // Constructs a printer object with an id.
   explicit Printer(const std::string& id);
 
   // Copy constructor and assignment.
   explicit Printer(const Printer& printer);
@@ skipping 18 matching lines @@
   void set_manufacturer(const std::string& manufacturer) {
     manufacturer_ = manufacturer;
   }
 
   const std::string& model() const { return model_; }
   void set_model(const std::string& model) { model_ = model; }
 
   const std::string& uri() const { return uri_; }
   void set_uri(const std::string& uri) { uri_ = uri; }
 
-  const PPDFile& ppd() const { return ppd_; }
-  void SetPPD(std::unique_ptr<PPDFile> ppd);
+  const PpdReference& ppd_reference() const { return ppd_reference_; }
+  PpdReference* mutable_ppd_reference() { return &ppd_reference_; }
 
   const std::string& uuid() const { return uuid_; }
   void set_uuid(const std::string& uuid) { uuid_ = uuid; }
 
  private:
   // Globally unique identifier. Empty indicates a new printer.
   std::string id_;
 
   // User defined string for printer identification.
   std::string display_name_;
 
   // User defined string for additional printer information.
   std::string description_;
 
   // The manufacturer of the printer, e.g. HP
   std::string manufacturer_;
 
   // The model of the printer, e.g. OfficeJet 415
   std::string model_;
 
   // The full path for the printer. Suitable for configuration in CUPS.
   // Contains protocol, hostname, port, and queue.
   std::string uri_;
 
-  // The associated postscript printer description.
-  PPDFile ppd_;
+  // How to find the associated postscript printer description.
+  PpdReference ppd_reference_;
 
   // The UUID from an autoconf protocol for deduplication. Could be empty.
   std::string uuid_;
 };
 
 }  // namespace chromeos
 
 #endif  // CHROMEOS_PRINTING_PRINTER_CONFIGURATION_H_