| // 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 CHROMEOS_DBUS_SHILL_CLIENT_HELPER_H_ |
| #define CHROMEOS_DBUS_SHILL_CLIENT_HELPER_H_ |
| |
| #include <string> |
| |
| #include "base/basictypes.h" |
| #include "base/callback.h" |
| #include "base/memory/scoped_ptr.h" |
| #include "base/memory/weak_ptr.h" |
| #include "base/observer_list.h" |
| #include "base/values.h" |
| #include "chromeos/dbus/dbus_method_call_status.h" |
| #include "chromeos/dbus/shill_property_changed_observer.h" |
| |
| namespace base { |
| |
| class Value; |
| class DictionaryValue; |
| |
| } // namespace base |
| |
| namespace dbus { |
| |
| class Bus; |
| class ErrorResponse; |
| class MessageWriter; |
| class MethodCall; |
| class ObjectPath; |
| class ObjectProxy; |
| class Response; |
| class Signal; |
| |
| } // namespace dbus |
| |
| namespace chromeos { |
| |
| // A class to help implement Shill clients. |
| class ShillClientHelper { |
| public: |
| // A callback to handle PropertyChanged signals. |
| typedef base::Callback<void(const std::string& name, |
| const base::Value& value)> PropertyChangedHandler; |
| |
| // A callback to handle responses for methods with DictionaryValue results. |
| typedef base::Callback<void( |
| DBusMethodCallStatus call_status, |
| const base::DictionaryValue& result)> DictionaryValueCallback; |
| |
| // A callback to handle responses for methods with DictionaryValue results. |
| // This is used by CallDictionaryValueMethodWithErrorCallback. |
| typedef base::Callback<void(const base::DictionaryValue& result)> |
| DictionaryValueCallbackWithoutStatus; |
| |
| // A callback to handle responses of methods returning a ListValue. |
| typedef base::Callback<void(const base::ListValue& result)> ListValueCallback; |
| |
| // A callback to handle errors for method call. |
| typedef base::Callback<void(const std::string& error_name, |
| const std::string& error_message)> ErrorCallback; |
| |
| // A callback that handles responses for methods with string results. |
| typedef base::Callback<void(const std::string& result)> StringCallback; |
| |
| // A callback that handles responses for methods with boolean results. |
| typedef base::Callback<void(bool result)> BooleanCallback; |
| |
| |
| ShillClientHelper(dbus::Bus* bus, dbus::ObjectProxy* proxy); |
| |
| virtual ~ShillClientHelper(); |
| |
| // Adds an |observer| of the PropertyChanged signal. |
| void AddPropertyChangedObserver(ShillPropertyChangedObserver* observer); |
| |
| // Removes an |observer| of the PropertyChanged signal. |
| void RemovePropertyChangedObserver(ShillPropertyChangedObserver* observer); |
| |
| // Starts monitoring PropertyChanged signal. If there aren't observers for the |
| // PropertyChanged signal, the actual monitoring will be delayed until the |
| // first observer is added. |
| void MonitorPropertyChanged(const std::string& interface_name); |
| |
| // Calls a method without results. |
| void CallVoidMethod(dbus::MethodCall* method_call, |
| const VoidDBusMethodCallback& callback); |
| |
| // Calls a method with an object path result. |
| void CallObjectPathMethod(dbus::MethodCall* method_call, |
| const ObjectPathDBusMethodCallback& callback); |
| |
| // Calls a method with an object path result where there is an error callback. |
| void CallObjectPathMethodWithErrorCallback( |
| dbus::MethodCall* method_call, |
| const ObjectPathCallback& callback, |
| const ErrorCallback& error_callback); |
| |
| // Calls a method with a dictionary value result. |
| void CallDictionaryValueMethod(dbus::MethodCall* method_call, |
| const DictionaryValueCallback& callback); |
| |
| // Calls a method without results with error callback. |
| void CallVoidMethodWithErrorCallback(dbus::MethodCall* method_call, |
| const base::Closure& callback, |
| const ErrorCallback& error_callback); |
| |
| // Calls a method with a boolean result with error callback. |
| void CallBooleanMethodWithErrorCallback( |
| dbus::MethodCall* method_call, |
| const BooleanCallback& callback, |
| const ErrorCallback& error_callback); |
| |
| // Calls a method with a string result with error callback. |
| void CallStringMethodWithErrorCallback(dbus::MethodCall* method_call, |
| const StringCallback& callback, |
| const ErrorCallback& error_callback); |
| |
| |
| // Calls a method with a dictionary value result with error callback. |
| void CallDictionaryValueMethodWithErrorCallback( |
| dbus::MethodCall* method_call, |
| const DictionaryValueCallbackWithoutStatus& callback, |
| const ErrorCallback& error_callback); |
| |
| // Calls a method with a boolean array result with error callback. |
| void CallListValueMethodWithErrorCallback( |
| dbus::MethodCall* method_call, |
| const ListValueCallback& callback, |
| const ErrorCallback& error_callback); |
| |
| // Appends the value (basic types and string-to-string dictionary) to the |
| // writer as a variant. |
| static void AppendValueDataAsVariant(dbus::MessageWriter* writer, |
| const base::Value& value); |
| |
| // Appends a string-to-variant dictionary to the writer. |
| static void AppendServicePropertiesDictionary( |
| dbus::MessageWriter* writer, |
| const base::DictionaryValue& dictionary); |
| |
| private: |
| // Starts monitoring PropertyChanged signal. |
| void MonitorPropertyChangedInternal(const std::string& interface_name); |
| |
| // Handles the result of signal connection setup. |
| void OnSignalConnected(const std::string& interface, |
| const std::string& signal, |
| bool success); |
| |
| // Handles PropertyChanged signal. |
| void OnPropertyChanged(dbus::Signal* signal); |
| |
| dbus::ObjectProxy* proxy_; |
| PropertyChangedHandler property_changed_handler_; |
| ObserverList<ShillPropertyChangedObserver, true /* check_empty */> |
| observer_list_; |
| std::vector<std::string> interfaces_to_be_monitored_; |
| |
| // Note: This should remain the last member so it'll be destroyed and |
| // invalidate its weak pointers before any other members are destroyed. |
| base::WeakPtrFactory<ShillClientHelper> weak_ptr_factory_; |
| |
| DISALLOW_COPY_AND_ASSIGN(ShillClientHelper); |
| }; |
| |
| } // namespace chromeos |
| |
| #endif // CHROMEOS_DBUS_SHILL_CLIENT_HELPER_H_ |