chromeos/network/network_activation_handler.h

   1 // Copyright 2013 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 CHROMEOS_NETWORK_NETWORK_ACTIVATION_HANDLER_H_
   6 #define CHROMEOS_NETWORK_NETWORK_ACTIVATION_HANDLER_H_
   7
   8 #include <string>
   9
  10 #include "base/basictypes.h"
  11 #include "base/memory/weak_ptr.h"
  12 #include "chromeos/chromeos_export.h"
  13 #include "chromeos/network/network_handler_callbacks.h"
  14
  15 namespace chromeos {
  16
  17 // The NetworkActivationHandler class allows making service specific
  18 // calls required for activation on mobile networks.
  19 class CHROMEOS_EXPORT NetworkActivationHandler
  20     : public base::SupportsWeakPtr<NetworkActivationHandler> {
  21  public:
  22   // Constants for |error_name| from |error_callback|.
  23   // TODO(gauravsh): Merge various error constants from Network*Handlers into
  24   // a single place. crbug.com/272554
  25   static const char kErrorNotFound[];
  26   static const char kErrorShillError[];
  27
  28   virtual ~NetworkActivationHandler();
  29
  30   // ActivateNetwork() will start an asynchronous activation attempt.
  31   // |carrier| may be empty or may specify a carrier to activate.
  32   // On success, |success_callback| will be called.
  33   // On failure, |error_callback| will be called with |error_name| one of:
  34   //  kErrorNotFound if no network matching |service_path| is found.
  35   //  kErrorShillError if a DBus or Shill error occurred.
  36   void Activate(const std::string& service_path,
  37                 const std::string& carrier,
  38                 const base::Closure& success_callback,
  39                 const network_handler::ErrorCallback& error_callback);
  40
  41   // CompleteActivation() will start an asynchronous activation completion
  42   // attempt.
  43   // On success, |success_callback| will be called.
  44   // On failure, |error_callback| will be called with |error_name| one of:
  45   //  kErrorNotFound if no network matching |service_path| is found.
  46   //  kErrorShillError if a DBus or Shill error occurred.
  47   void CompleteActivation(const std::string& service_path,
  48                           const base::Closure& success_callback,
  49                           const network_handler::ErrorCallback& error_callback);
  50
  51  private:
  52   friend class NetworkHandler;
  53
  54   NetworkActivationHandler();
  55
  56   // Calls Shill.Service.ActivateCellularModem asynchronously.
  57   void CallShillActivate(const std::string& service_path,
  58                          const std::string& carrier,
  59                          const base::Closure& success_callback,
  60                          const network_handler::ErrorCallback& error_callback);
  61
  62   // Calls Shill.Service.CompleteCellularActivation asynchronously.
  63   void CallShillCompleteActivation(
  64       const std::string& service_path,
  65       const base::Closure& success_callback,
  66       const network_handler::ErrorCallback& error_callback);
  67
  68   // Handle success from Shill.Service.ActivateCellularModem or
  69   // Shill.Service.CompleteCellularActivation.
  70   void HandleShillSuccess(const std::string& service_path,
  71                           const base::Closure& success_callback);
  72
  73   DISALLOW_COPY_AND_ASSIGN(NetworkActivationHandler);
  74 };
  75
  76 }  // namespace chromeos
  77
  78 #endif  // CHROMEOS_NETWORK_NETWORK_ACTIVATION_HANDLER_H_