network_activation_handler.h revision 424c4d7b64af9d0d8fd9624f381f469654d5e3d2 
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
15namespace chromeos {
16
17// The NetworkActivationHandler class allows making service specific
18// calls required for activation on mobile networks.
19class 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_
79