chromeos: Remove unused AP manager D-Bus client library

chromeos/dbus/ap_manager_client.h

-// Copyright 2015 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_DBUS_AP_MANAGER_CLIENT_H_
-#define CHROMEOS_DBUS_AP_MANAGER_CLIENT_H_
-
-#include <stdint.h>
-
-#include <map>
-#include <string>
-#include <vector>
-
-#include "base/callback.h"
-#include "base/macros.h"
-#include "base/values.h"
-#include "chromeos/chromeos_export.h"
-#include "chromeos/dbus/dbus_client.h"
-#include "chromeos/dbus/dbus_method_call_status.h"
-#include "dbus/object_path.h"
-#include "dbus/property.h"
-
-namespace chromeos {
-
-// ApManagerClient is used to communicate with the
-// WiFi AP Manager service.  All methods should be called from
-// the origin thread which initializes the DBusThreadManager instance.
-class CHROMEOS_EXPORT ApManagerClient : public DBusClient {
- public:
-  // Structure of properties associated with a WiFi service AP configuration.
-  // These properties must be set before Start is called.
-  class ConfigProperties : public dbus::PropertySet {
-   public:
-    ConfigProperties(dbus::ObjectProxy* object_proxy,
-                     const std::string& interface_name,
-                     const PropertyChangedCallback& callback);
-    ~ConfigProperties() override;
-
-    // Name of network [required].
-    const std::string& ssid() const { return ssid_.value(); }
-    void set_ssid(const std::string& ssid, SetCallback callback) {
-      ssid_.Set(ssid, callback);
-    }
-
-    // Interface name [optional].
-    const std::string& interface_name() const {
-      return interface_name_.value();
-    }
-    void set_interface_name(const std::string& name, SetCallback callback) {
-      interface_name_.Set(name, callback);
-    }
-
-    // Security Mode; "RSN", "None" [optional].
-    const std::string& security_mode() const { return security_mode_.value(); }
-    void set_security_mode(const std::string& mode, SetCallback callback) {
-      security_mode_.Set(mode, callback);
-    }
-
-    // Passphrase; [required] when security is not "None".
-    const std::string& passphrase() const { return passphrase_.value(); }
-    void set_passphrase(const std::string& passphrase, SetCallback callback) {
-      passphrase_.Set(passphrase, callback);
-    }
-
-    // HwMode, "802.11a", "802.11b". Default: "802.11g" [optional].
-    const std::string& hw_mode() const { return hw_mode_.value(); }
-    void set_hw_mode(const std::string& mode, SetCallback callback) {
-      hw_mode_.Set(mode, callback);
-    }
-
-    // Operation mode, "Bridge" or "Server". Default "Server". [optional].
-    const std::string& operation_mode() const {
-      return operation_mode_.value();
-    }
-    void set_operation_mode(const std::string& mode, SetCallback callback) {
-      operation_mode_.Set(mode, callback);
-    }
-
-    // Operating channel. Default '6' [optional].
-    uint16_t channel() const { return channel_.value(); }
-    void set_channel(uint16_t channel, SetCallback callback) {
-      channel_.Set(channel, callback);
-    }
-
-    // Hidden network. Default "false". [optional].
-    bool hidden_network() const { return hidden_network_.value(); }
-    void set_hidden_network(bool hidden, SetCallback callback) {
-      hidden_network_.Set(hidden, callback);
-    }
-
-    // Bridge interface. [required] if Bridge operation mode set.
-    const std::string& bridge_interface() const {
-      return bridge_interface_.value();
-    }
-    void set_bridge_interface(const std::string& interface,
-                              SetCallback callback) {
-      bridge_interface_.Set(interface, callback);
-    }
-
-    // The value of x in the following equation; "192.168.x.254".
-    // This will be the server's IP address. [required] only if
-    // operation mode set to "Server".
-    uint16_t server_address_index() const {
-      return server_address_index_.value();
-    }
-    void set_server_address_index(uint16_t index, SetCallback callback) {
-      server_address_index_.Set(index, callback);
-    }
-
-   private:
-    dbus::Property<std::string> ssid_;
-    dbus::Property<std::string> interface_name_;
-    dbus::Property<std::string> security_mode_;
-    dbus::Property<std::string> passphrase_;
-    dbus::Property<std::string> hw_mode_;
-    dbus::Property<std::string> operation_mode_;
-    dbus::Property<uint16_t> channel_;
-    dbus::Property<bool> hidden_network_;
-    dbus::Property<std::string> bridge_interface_;
-    dbus::Property<uint16_t> server_address_index_;
-
-    DISALLOW_COPY_AND_ASSIGN(ConfigProperties);
-  };
-
-  // Structure of properties associated with a WiFi service AP device.
-  class DeviceProperties : public dbus::PropertySet {
-   public:
-    DeviceProperties(dbus::ObjectProxy* object_proxy,
-                     const std::string& interface_name,
-                     const PropertyChangedCallback& callback);
-    ~DeviceProperties() override;
-
-    // Name of the WiFi device.
-    const std::string& device_name() const { return device_name_.value(); }
-
-    // Flag indicating if this device is currently in-use by apmanager.
-    bool in_use() const { return in_used_.value(); }
-
-    // Name of the WiFi interface on the device that’s preferred for starting an
-    // AP serivce.
-    const std::string& preferred_ap_interface() const {
-      return preferred_ap_interface_.value();
-    }
-
-   private:
-    dbus::Property<std::string> device_name_;
-    dbus::Property<bool> in_used_;
-    dbus::Property<std::string> preferred_ap_interface_;
-
-    DISALLOW_COPY_AND_ASSIGN(DeviceProperties);
-  };
-
-  // Structure of properties associated with a WiFi service AP service.
-  class ServiceProperties : public dbus::PropertySet {
-   public:
-    ServiceProperties(dbus::ObjectProxy* object_proxy,
-                      const std::string& interface_name,
-                      const PropertyChangedCallback& callback);
-    ~ServiceProperties() override;
-
-    // DBus path of the config for this service.
-    const dbus::ObjectPath& config_path() const { return config_.value(); }
-
-    // Current state of service. ["Idle", "Starting", "Started", "Failed"].
-    const std::string& state() const { return state_.value(); }
-
-   private:
-    dbus::Property<dbus::ObjectPath> config_;
-    dbus::Property<std::string> state_;
-
-    DISALLOW_COPY_AND_ASSIGN(ServiceProperties);
-  };
-
-  // Interface for observing changes from a apmanager daemon.
-  class Observer {
-   public:
-    virtual ~Observer();
-
-    // Called when the manager has been added.
-    virtual void ManagerAdded();
-
-    // Called when the manager has been removed.
-    virtual void ManagerRemoved();
-
-    // Called when the config with object path |object_path| is added to the
-    // system.
-    virtual void ConfigAdded(const dbus::ObjectPath& object_path);
-
-    // Called when the config with object path |object_path| is removed from
-    // the system.
-    virtual void ConfigRemoved(const dbus::ObjectPath& object_path);
-
-    // Called when the device with object path |object_path| is added to the
-    // system.
-    virtual void DeviceAdded(const dbus::ObjectPath& object_path);
-
-    // Called when the device with object path |object_path| is removed from
-    // the system.
-    virtual void DeviceRemoved(const dbus::ObjectPath& object_path);
-
-    // Called when the device with object path |object_path| is added to the
-    // system.
-    virtual void ServiceAdded(const dbus::ObjectPath& object_path);
-
-    // Called when the device with object path |object_path| is removed from
-    // the system.
-    virtual void ServiceRemoved(const dbus::ObjectPath& object_path);
-
-    // Called when the adapter with object path |object_path| has a
-    // change in value of the property named |property_name|.
-    virtual void ConfigPropertyChanged(const dbus::ObjectPath& object_path,
-                                       const std::string& property_name);
-
-    // Called when the adapter with object path |object_path| has a
-    // change in value of the property named |property_name|.
-    virtual void DevicePropertyChanged(const dbus::ObjectPath& object_path,
-                                       const std::string& property_name);
-
-    // Called when the adapter with object path |object_path| has a
-    // change in value of the property named |property_name|.
-    virtual void ServicePropertyChanged(const dbus::ObjectPath& object_path,
-                                        const std::string& property_name);
-  };
-
-  ~ApManagerClient() override;
-
-  // Factory function, creates a new instance which is owned by the caller.
-  // For normal usage, access the singleton via DBusThreadManager::Get().
-  static ApManagerClient* Create();
-
-  // Adds and removes observers for events on all apmanager
-  // events. Check the |object_path| parameter of observer methods to
-  // determine which group is issuing the event.
-  virtual void AddObserver(Observer* observer) = 0;
-  virtual void RemoveObserver(Observer* observer) = 0;
-
-  // Calls CreateService method.
-  // |callback| is called with its |call_status| argument set to
-  // DBUS_METHOD_CALL_SUCCESS if the method call succeeds. Otherwise,
-  // |callback| is called with |call_status| set to DBUS_METHOD_CALL_FAILURE.
-  virtual void CreateService(const ObjectPathDBusMethodCallback& callback) = 0;
-
-  // Calls RemoveService method.
-  // |callback| is called with its |call_status| argument set to
-  // DBUS_METHOD_CALL_SUCCESS if the method call succeeds. Otherwise,
-  // |callback| is called with |call_status| set to DBUS_METHOD_CALL_FAILURE.
-  virtual void RemoveService(const dbus::ObjectPath& object_path,
-                             const VoidDBusMethodCallback& callback) = 0;
-
-  // Calls Service::Start method.
-  // |callback| is called with its |call_status| argument set to
-  // DBUS_METHOD_CALL_SUCCESS if the method call succeeds. Otherwise,
-  // |callback| is called with |call_status| set to DBUS_METHOD_CALL_FAILURE.
-  virtual void StartService(const dbus::ObjectPath& object_path,
-                            const VoidDBusMethodCallback& callback) = 0;
-
-  // Calls Service::Stop method.
-  // |callback| is called with its |call_status| argument set to
-  // DBUS_METHOD_CALL_SUCCESS if the method call succeeds. Otherwise,
-  // |callback| is called with |call_status| set to DBUS_METHOD_CALL_FAILURE.
-  virtual void StopService(const dbus::ObjectPath& object_path,
-                           const VoidDBusMethodCallback& callback) = 0;
-
-  // Obtains the properties for the config with object path |object_path|,
-  // any values should be copied if needed.
-  virtual ConfigProperties* GetConfigProperties(
-      const dbus::ObjectPath& object_path) = 0;
-
-  // Obtains the properties for the device with object path |object_path|,
-  // any values should be copied if needed.
-  virtual const DeviceProperties* GetDeviceProperties(
-      const dbus::ObjectPath& object_path) = 0;
-
-  // Obtains the properties for the device with object path |object_path|,
-  // any values should be copied if needed.
-  virtual const ServiceProperties* GetServiceProperties(
-      const dbus::ObjectPath& object_path) = 0;
-
- protected:
-  // Create() should be used instead.
-  ApManagerClient();
-
- private:
-  DISALLOW_COPY_AND_ASSIGN(ApManagerClient);
-};
-
-}  // namespace chromeos
-
-#endif  // CHROMEOS_DBUS_AP_MANAGER_CLIENT_H_