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
27namespace 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.
34class 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