chrome/service/cloud_print/cloud_print_proxy.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CHROME_SERVICE_CLOUD_PRINT_CLOUD_PRINT_PROXY_H_
   6 #define CHROME_SERVICE_CLOUD_PRINT_CLOUD_PRINT_PROXY_H_
   7
   8 #include <list>
   9 #include <string>
  10 #include <vector>
  11
  12 #include "base/basictypes.h"
  13 #include "base/memory/scoped_ptr.h"
  14 #include "base/threading/non_thread_safe.h"
  15 #include "chrome/service/cloud_print/cloud_print_proxy_backend.h"
  16 #include "chrome/service/cloud_print/cloud_print_wipeout.h"
  17
  18 class ServiceProcessPrefs;
  19
  20 namespace cloud_print {
  21
  22 struct CloudPrintProxyInfo;
  23
  24 // CloudPrintProxy is the layer between the service process UI thread
  25 // and the cloud print proxy backend.
  26 class CloudPrintProxy : public CloudPrintProxyFrontend,
  27                         public CloudPrintWipeout::Client,
  28                         public base::NonThreadSafe {
  29  public:
  30   class Client {
  31    public:
  32     virtual ~Client() {}
  33     virtual void OnCloudPrintProxyEnabled(bool persist_state) {}
  34     virtual void OnCloudPrintProxyDisabled(bool persist_state) {}
  35   };
  36   CloudPrintProxy();
  37   ~CloudPrintProxy() override;
  38
  39   // Initializes the object. This should be called every time an object of this
  40   // class is constructed.
  41   void Initialize(ServiceProcessPrefs* service_prefs, Client* client);
  42
  43   // Enables/disables cloud printing for the user
  44   void EnableForUser();
  45   void EnableForUserWithRobot(
  46       const std::string& robot_auth_code,
  47       const std::string& robot_email,
  48       const std::string& user_email,
  49       const base::DictionaryValue& user_settings);
  50   void UnregisterPrintersAndDisableForUser();
  51   void DisableForUser();
  52   // Returns the proxy info.
  53   void GetProxyInfo(CloudPrintProxyInfo* info);
  54   // Return accessible printers.
  55   void GetPrinters(std::vector<std::string>* printers);
  56
  57   const std::string& user_email() const {
  58     return user_email_;
  59   }
  60
  61   // CloudPrintProxyFrontend implementation. Called on UI thread.
  62   void OnAuthenticated(const std::string& robot_oauth_refresh_token,
  63                        const std::string& robot_email,
  64                        const std::string& user_email) override;
  65   void OnAuthenticationFailed() override;
  66   void OnPrintSystemUnavailable() override;
  67   void OnUnregisterPrinters(const std::string& auth_token,
  68                             const std::list<std::string>& printer_ids) override;
  69   void OnXmppPingUpdated(int ping_timeout) override;
  70
  71   // CloudPrintWipeout::Client implementation.
  72   void OnUnregisterPrintersComplete() override;
  73
  74  protected:
  75   void ShutdownBackend();
  76   bool CreateBackend();
  77
  78   // Our asynchronous backend to communicate with sync components living on
  79   // other threads.
  80   scoped_ptr<CloudPrintProxyBackend> backend_;
  81   // This class does not own this. It is guaranteed to remain valid for the
  82   // lifetime of this class.
  83   ServiceProcessPrefs* service_prefs_;
  84   // This class does not own this. If non-NULL, It is guaranteed to remain
  85   // valid for the lifetime of this class.
  86   Client* client_;
  87   // The email address of the account used to authenticate to the Cloud Print
  88   // service.
  89   std::string user_email_;
  90   // This is set to true when the Cloud Print proxy is enabled and after
  91   // successful authentication with the Cloud Print service.
  92   bool enabled_;
  93   // This is a cleanup class for unregistering printers on proxy disable.
  94   scoped_ptr<CloudPrintWipeout> wipeout_;
  95
  96   DISALLOW_COPY_AND_ASSIGN(CloudPrintProxy);
  97 };
  98
  99 }  // namespace cloud_print
 100
 101 #endif  // CHROME_SERVICE_CLOUD_PRINT_CLOUD_PRINT_PROXY_H_