1 //
2 // Copyright (C) 2015 The Android Open Source Project
3 //
4 // Licensed under the Apache License, Version 2.0 (the "License");
5 // you may not use this file except in compliance with the License.
6 // You may obtain a copy of the License at
7 //
8 //      http://www.apache.org/licenses/LICENSE-2.0
9 //
10 // Unless required by applicable law or agreed to in writing, software
11 // distributed under the License is distributed on an "AS IS" BASIS,
12 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 // See the License for the specific language governing permissions and
14 // limitations under the License.
15 //
16 
17 #ifndef UPDATE_ENGINE_SHILL_PROXY_INTERFACE_H_
18 #define UPDATE_ENGINE_SHILL_PROXY_INTERFACE_H_
19 
20 #include <memory>
21 #include <string>
22 
23 #include <base/macros.h>
24 #include <dbus/object_path.h>
25 #include <shill/dbus-proxies.h>
26 
27 namespace chromeos_update_engine {
28 
29 // This class handles the DBus connection with shill daemon. The DBus interface
30 // with shill requires to monitor or request the current service by interacting
31 // with the org::chromium::flimflam::ManagerProxy and then request or monitor
32 // properties on the selected org::chromium::flimflam::ServiceProxy. This class
33 // provides a mockable way to access that.
34 class ShillProxyInterface {
35  public:
36   virtual ~ShillProxyInterface() = default;
37 
38   // Return the ManagerProxy instance of the shill daemon. The instance is owned
39   // by this ShillProxyInterface instance.
40   virtual org::chromium::flimflam::ManagerProxyInterface* GetManagerProxy() = 0;
41 
42   // Return a ServiceProxy for the given path. The ownership of the returned
43   // instance is transferred to the caller.
44   virtual std::unique_ptr<org::chromium::flimflam::ServiceProxyInterface>
45   GetServiceForPath(const dbus::ObjectPath& path) = 0;
46 
47  protected:
48   ShillProxyInterface() = default;
49 
50  private:
51   DISALLOW_COPY_AND_ASSIGN(ShillProxyInterface);
52 };
53 
54 }  // namespace chromeos_update_engine
55 
56 #endif  // UPDATE_ENGINE_SHILL_PROXY_INTERFACE_H_
57