Merge to M51: Cloud Print Proxy: Delete print jobs.

chrome/service/cloud_print/printer_job_handler.h

 // Copyright (c) 2012 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 CHROME_SERVICE_CLOUD_PRINT_PRINTER_JOB_HANDLER_H_
 #define CHROME_SERVICE_CLOUD_PRINT_PRINTER_JOB_HANDLER_H_
 
 #include <list>
 #include <string>
 #include <vector>
@@ skipping 75 matching lines @@
     std::string printer_id;
     std::string caps_hash;
     std::string tags_hash;
     int current_xmpp_timeout;
     int pending_xmpp_timeout;
 
     PrinterInfoFromCloud();
     PrinterInfoFromCloud(const PrinterInfoFromCloud& other);
   };
 
-  // Begin public interface
+  static void ReportsStats();
+
   PrinterJobHandler(const printing::PrinterBasicInfo& printer_info,
                     const PrinterInfoFromCloud& printer_info_from_server,
                     const GURL& cloud_print_server_url,
                     PrintSystem* print_system,
                     Delegate* delegate);
 
   bool Initialize();
 
   std::string GetPrinterName() const;
 
   // Requests a job check. |reason| is the reason for fetching the job. Used
   // for logging and diagnostc purposes.
   void CheckForJobs(const std::string& reason);
 
   // Shutdown everything (the process is exiting).
   void Shutdown();
 
   base::TimeTicks last_job_fetch_time() const { return last_job_fetch_time_; }
-  // End public interface
-
-  // Begin Delegate implementations
 
   // CloudPrintURLFetcher::Delegate implementation.
   CloudPrintURLFetcher::ResponseAction HandleRawResponse(
       const net::URLFetcher* source,
       const GURL& url,
       const net::URLRequestStatus& status,
       int response_code,
       const net::ResponseCookies& cookies,
       const std::string& data) override;
   CloudPrintURLFetcher::ResponseAction HandleRawData(
@@ skipping 12 matching lines @@
   // JobStatusUpdater::Delegate implementation
   bool OnJobCompleted(JobStatusUpdater* updater) override;
   void OnAuthError() override;
 
   // PrinterWatcherDelegate implementation
   void OnPrinterDeleted() override;
   void OnPrinterChanged() override;
   void OnJobChanged() override;
 
   // JobSpoolerDelegate implementation.
-  // Called on print_thread_.
+  // Called on |print_thread_|.
   void OnJobSpoolSucceeded(const PlatformJobId& job_id) override;
   void OnJobSpoolFailed() override;
 
-  // End Delegate implementations
-
-  static void ReportsStats();
-
  private:
   friend class base::RefCountedThreadSafe<PrinterJobHandler>;
 
   enum PrintJobError {
     JOB_SUCCESS,
     JOB_DOWNLOAD_FAILED,
     JOB_VALIDATE_TICKET_FAILED,
     JOB_FAILED,
     JOB_MAX,
   };
 
   // Prototype for a JSON data handler.
   typedef CloudPrintURLFetcher::ResponseAction
       (PrinterJobHandler::*JSONDataHandler)(const net::URLFetcher* source,
                                             const GURL& url,
                                             base::DictionaryValue* json_data,
                                             bool succeeded);
   // Prototype for a data handler.
-  typedef CloudPrintURLFetcher::ResponseAction
-      (PrinterJobHandler::*DataHandler)(const net::URLFetcher* source,
-                                        const GURL& url,
-                                        const std::string& data);
+  typedef CloudPrintURLFetcher::ResponseAction (
+      PrinterJobHandler::*DataHandler)(const net::URLFetcher* source,
+                                       const GURL& url,
+                                       const std::string& data);
 
   ~PrinterJobHandler() override;
 
   // Begin request handlers for each state in the state machine
   CloudPrintURLFetcher::ResponseAction HandlePrinterUpdateResponse(
       const net::URLFetcher* source,
       const GURL& url,
       base::DictionaryValue* json_data,
       bool succeeded);
 
@@ skipping 49 matching lines @@
 
   void JobFailed(PrintJobError error);
   void JobSpooled(PlatformJobId local_job_id);
   // Returns false if printer info is up to date and no updating is needed.
   bool UpdatePrinterInfo();
   bool HavePendingTasks();
   void ValidatePrintTicketFailed();
 
   // Callback that asynchronously receives printer caps and defaults.
   void OnReceivePrinterCaps(
-    bool succeeded,
-    const std::string& printer_name,
-    const printing::PrinterCapsAndDefaults& caps_and_defaults);
+      bool succeeded,
+      const std::string& printer_name,
+      const printing::PrinterCapsAndDefaults& caps_and_defaults);
 
-  // Called on print_thread_.
+  // Called on |print_thread_|. It is not safe to access any members other than
+  // |job_handler_task_runner_|, |job_spooler_| and |print_system_|.
   void DoPrint(const JobDetails& job_details,
                const std::string& printer_name);
 
+  bool CurrentlyOnPrintThread() const;
+
   scoped_refptr<CloudPrintURLFetcher> request_;
   scoped_refptr<PrintSystem> print_system_;
   printing::PrinterBasicInfo printer_info_;
   PrinterInfoFromCloud printer_info_cloud_;
   GURL cloud_print_server_url_;
   std::string print_data_url_;
   JobDetails job_details_;
-  Delegate* delegate_;
+  Delegate* const delegate_;
+
   // Once the job has been spooled to the local spooler, this specifies the
   // job id of the job on the local spooler.
   PlatformJobId local_job_id_;
 
   // The next response handler can either be a JSONDataHandler or a
   // DataHandler (depending on the current request being made).
   JSONDataHandler next_json_data_handler_;
   DataHandler next_data_handler_;
   // The thread on which the actual print operation happens
   base::Thread print_thread_;
@@ skipping 37 matching lines @@
 
 // This typedef is to workaround the issue with certain versions of
 // Visual Studio where it gets confused between multiple Delegate
 // classes and gives a C2500 error. (I saw this error on the try bots -
 // the workaround was not needed for my machine).
 typedef PrinterJobHandler::Delegate PrinterJobHandlerDelegate;
 
 }  // namespace cloud_print
 
 #endif  // CHROME_SERVICE_CLOUD_PRINT_PRINTER_JOB_HANDLER_H_