1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
// Copyright 2012 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROMEOS_ASH_COMPONENTS_NETWORK_NETWORK_STATE_HANDLER_OBSERVER_H_
#define CHROMEOS_ASH_COMPONENTS_NETWORK_NETWORK_STATE_HANDLER_OBSERVER_H_
#include <string>
#include <vector>
#include "base/component_export.h"
#include "base/scoped_observation.h"
#include "chromeos/ash/components/network/network_state.h"
#include "chromeos/ash/components/network/network_type_pattern.h"
namespace ash {
class DeviceState;
class NetworkStateHandler;
// Observer class for all network state changes, including changes to
// active (connecting or connected) services.
class COMPONENT_EXPORT(CHROMEOS_NETWORK) NetworkStateHandlerObserver {
public:
NetworkStateHandlerObserver();
NetworkStateHandlerObserver(const NetworkStateHandlerObserver&) = delete;
NetworkStateHandlerObserver& operator=(const NetworkStateHandlerObserver&) =
delete;
virtual ~NetworkStateHandlerObserver();
// The list of networks changed.
virtual void NetworkListChanged();
// The list of devices changed. Use DevicePropertiesUpdated to be notified
// when a Device property changes.
virtual void DeviceListChanged();
// The default network changed (includes VPNs) or one of its properties
// changed. This won't be called if the WiFi signal strength property
// changes. If interested in those events, use NetworkPropertiesUpdated()
// below.
// |network| will be null if there is no longer a default network.
virtual void DefaultNetworkChanged(const NetworkState* network);
// The portal state or the proxy configuration of the default network changed.
// Note: |default_network| may be null if there is no default network, in
// which case |portal_state| will always be kUnknown.
virtual void PortalStateChanged(const NetworkState* default_network,
NetworkState::PortalState portal_state);
// The connection state of |network| changed.
virtual void NetworkConnectionStateChanged(const NetworkState* network);
// Triggered when the connection state of any current or previously active
// (connected or connecting) network changes. Includes significant changes to
// the signal strength. Provides the current list of active networks, which
// may include a VPN.
virtual void ActiveNetworksChanged(
const std::vector<const NetworkState*>& active_networks);
// One or more properties of |network| have been updated. Note: this will get
// called in *addition* to NetworkConnectionStateChanged() when the
// connection state property changes. Use this to track properties like
// wifi strength.
virtual void NetworkPropertiesUpdated(const NetworkState* network);
// One or more properties of |device| have been updated.
virtual void DevicePropertiesUpdated(const DeviceState* device);
// A scan for a given network type has been requested.
virtual void ScanRequested(const NetworkTypePattern& type);
// A scan for |device| started.
virtual void ScanStarted(const DeviceState* device);
// A scan for |device| completed.
virtual void ScanCompleted(const DeviceState* device);
// A network has updated its identifiers (path and GUID).
virtual void NetworkIdentifierTransitioned(
const std::string& old_service_path,
const std::string& new_service_path,
const std::string& old_guid,
const std::string& new_guid);
// The DHCP Hostname changed.
virtual void HostnameChanged(const std::string& hostname);
// Called just before NetworkStateHandler is destroyed so that observers
// can safely stop observing.
virtual void OnShuttingDown();
};
using NetworkStateHandlerScopedObservation =
base::ScopedObservation<NetworkStateHandler, NetworkStateHandlerObserver>;
} // namespace ash
#endif // CHROMEOS_ASH_COMPONENTS_NETWORK_NETWORK_STATE_HANDLER_OBSERVER_H_
|
