Add chromeos::NetworkStateManager

chromeos/network/network_state.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 CHROMEOS_NETWORK_NETWORK_STATE_H_
+#define CHROMEOS_NETWORK_NETWORK_STATE_H_
+
+#include "chromeos/network/managed_state.h"
+
+namespace chromeos {
+
+// Simple class to provide network state information about a network service.
+// This class should always be passed as a const* and should never be held
+// on to. Store network_state->path() (defined in ManagedState) instead and
+// call NetworkStateHandler::GetNetworkState(path) to retrieve the state for
+// the network.
+class CHROMEOS_EXPORT NetworkState : public ManagedState {
+ public:
+  explicit NetworkState(const std::string& path);
+  virtual ~NetworkState();
+
+  // ManagedState overrides
+  virtual bool PropertyChanged(const std::string& key,
+                               const base::Value& value) OVERRIDE;
+
+  // Accessors
+  const std::string& security() const { return security_; }
+  const std::string& technology() const { return technology_; }
+  const std::string& ip_address() const { return ip_address_; }
+  const std::string& device_path() const { return device_path_; }
+  const std::string& state() const { return state_; }
+  const std::string& error() const { return error_; }
+  const std::string& activation_state() const { return activation_state_; }
+  const std::string& roaming() const { return roaming_; }
+  int signal_strength() const { return signal_strength_; }
+
+  bool IsConnectedState() const;
+  bool IsConnectingState() const;
+
+  // Helpers (used e.g. when a state is cached)

[gauravsh, 2012/11/06 01:56:59]

Are there any places where one might be interested in querying if the state is
failure? Should there be a StateIsFailure helper?

[stevenjb, 2012/11/06 03:17:03]

There is only a single error state "kStateFailure" whereas Shill provides more
granularity for Connected and Connecting states. IsErrorState() may prove useful
but I think I would rather wait to add it until we have a use case.

[gauravsh, 2012/11/06 22:51:41]

Cool, there are a few other error states but not sure how often they are
actually used.

[stevenjb, 2012/11/07 01:38:13]

The only other one I see in service_constants.h is kStateActivationFailure which
is kind of specialized, but may still be worth adding IsErrorState() for. I'll
keep that in mind in the next CL :) If we have other error states we should be
sure to add them to service_constants.h.

+  static bool StateIsConnected(const std::string& state);
+  static bool StateIsConnecting(const std::string& state);
+
+ private:
+  friend class NetworkStateHandler;
+
+  // Called by NetworkStateHandler when the ip config changes.
+  void set_ip_address(const std::string& ip_address) {
+    ip_address_ = ip_address;
+  }
+
+  // Common Network Service properties
+  std::string security_;
+  std::string device_path_;
+  std::string ip_address_;
+  std::string state_;
+  std::string error_;
+  // Wireless properties
+  int signal_strength_;
+  // Cellular properties
+  std::string technology_;
+  std::string activation_state_;
+  std::string roaming_;
+
+  DISALLOW_COPY_AND_ASSIGN(NetworkState);
+};
+
+}  // namespace chromeos
+
+#endif  // CHROMEOS_NETWORK_NETWORK_STATE_H_