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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
// 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 CHROME_BROWSER_CHROMEOS_CROS_NETWORK_PARSER_H_
#define CHROME_BROWSER_CHROMEOS_CROS_NETWORK_PARSER_H_
#include <map>
#include <string>
#include "chrome/browser/chromeos/cros/enum_mapper.h"
#include "chrome/browser/chromeos/cros/network_library.h"
namespace base {
class DictionaryValue;
class Value;
}
namespace chromeos {
class NetworkDevice;
// This takes a Value of a particular form, and maps the keys in the dictionary
// to a NetworkDevice object to initialize it properly. Subclasses of this can
// then customize its methods to parse either Shill data or network setup
// information obtained from policy or setup file import depending on the
// EnumMapper supplied.
class NetworkDeviceParser {
public:
virtual ~NetworkDeviceParser();
virtual NetworkDevice* CreateDeviceFromInfo(
const std::string& device_path,
const base::DictionaryValue& info);
virtual bool UpdateDeviceFromInfo(const base::DictionaryValue& info,
NetworkDevice* device);
virtual bool UpdateStatus(const std::string& key,
const base::Value& value,
NetworkDevice* device,
PropertyIndex* index);
protected:
// The NetworkDeviceParser does not take ownership of the |mapper|.
explicit NetworkDeviceParser(const EnumMapper<PropertyIndex>* mapper);
// Creates new NetworkDevice based on device_path.
// Subclasses should override this method and set the correct parser for this
// network device if appropriate.
virtual NetworkDevice* CreateNewNetworkDevice(const std::string& device_path);
virtual bool ParseValue(PropertyIndex index,
const base::Value& value,
NetworkDevice* device) = 0;
virtual ConnectionType ParseType(const std::string& type) = 0;
const EnumMapper<PropertyIndex>& mapper() const {
return *mapper_;
}
private:
const EnumMapper<PropertyIndex>* mapper_;
DISALLOW_COPY_AND_ASSIGN(NetworkDeviceParser);
};
// This takes a Value of a particular form, and uses the keys in the
// dictionary to create Network (WiFiNetwork, EthernetNetwork, etc.)
// objects and initialize them properly. Subclasses of this can then
// customize its methods to parse other forms of input dictionaries.
class NetworkParser {
public:
virtual ~NetworkParser();
// Called when a new network is encountered. In addition to setting the
// members on the Network object, the Network's property_map_ variable
// will include all the property and corresponding value in |info|.
// Returns NULL upon failure.
virtual Network* CreateNetworkFromInfo(const std::string& service_path,
const base::DictionaryValue& info);
// Called when an existing network is has new information that needs
// to be updated. Network's property_map_ variable will be updated.
// Returns false upon failure.
virtual bool UpdateNetworkFromInfo(const base::DictionaryValue& info,
Network* network);
// Called when an individual attribute of an existing network has
// changed. |index| is a return value that supplies the appropriate
// property index for the given key. |index| is filled in even if
// the update fails. Network's property_map_ variable will be updated.
// Returns false upon failure.
virtual bool UpdateStatus(const std::string& key,
const base::Value& value,
Network* network,
PropertyIndex* index);
protected:
// The NetworkParser does not take ownership of the |mapper|.
explicit NetworkParser(const EnumMapper<PropertyIndex>* mapper);
// Creates new Network based on type and service_path.
// Subclasses should override this method and set the correct parser for this
// network if appropriate.
virtual Network* CreateNewNetwork(ConnectionType type,
const std::string& service_path);
// Parses the value and sets the appropriate field on Network.
virtual bool ParseValue(PropertyIndex index,
const base::Value& value,
Network* network);
virtual ConnectionType ParseType(const std::string& type) = 0;
virtual ConnectionType ParseTypeFromDictionary(
const base::DictionaryValue& info) = 0;
const EnumMapper<PropertyIndex>& mapper() const {
return *mapper_;
}
private:
const EnumMapper<PropertyIndex>* mapper_;
DISALLOW_COPY_AND_ASSIGN(NetworkParser);
};
} // namespace chromeos
#endif // CHROME_BROWSER_CHROMEOS_CROS_NETWORK_PARSER_H_
|