| // Copyright 2018 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_DBUS_COMPONENT_UPDATER_SERVICE_PROVIDER_H_ |
| #define CHROME_BROWSER_CHROMEOS_DBUS_COMPONENT_UPDATER_SERVICE_PROVIDER_H_ |
| |
| #include <memory> |
| #include <string> |
| |
| #include "base/compiler_specific.h" |
| #include "base/files/file_path.h" |
| #include "base/macros.h" |
| #include "base/memory/ref_counted.h" |
| #include "base/memory/weak_ptr.h" |
| #include "chrome/browser/component_updater/cros_component_installer_chromeos.h" |
| #include "chromeos/dbus/services/cros_dbus_service.h" |
| #include "dbus/exported_object.h" |
| |
| namespace dbus { |
| class MethodCall; |
| } |
| |
| namespace chromeos { |
| |
| // This class exports D-Bus methods that manage components: |
| // |
| // LoadComponent: |
| // % dbus-send --system --type=method_call --print-reply |
| // --dest=org.chromium.ComponentUpdaterService |
| // /org/chromium/ComponentUpdaterService |
| // org.chromium.ComponentUpdaterService.LoadComponent |
| // "string:|component name|" "boolean:|mount|" |
| // |
| // % string "/run/imageloader/|component name|/|version|" |
| // |
| // UnloadComponent: |
| // % dbus-send --system --type=method_call --print-reply |
| // --dest=org.chromium.ComponentUpdaterService |
| // /org/chromium/ComponentUpdaterService |
| // org.chromium.ComponentUpdaterService.UnloadComponent |
| // "string:|component name|" |
| // |
| // % (returns empty response on success and error response on failure) |
| class ComponentUpdaterServiceProvider |
| : public CrosDBusService::ServiceProviderInterface, |
| public component_updater::CrOSComponentManager::Delegate { |
| public: |
| // Delegate interface providing additional resources to |
| // ComponentUpdaterServiceProvider. |
| class Delegate { |
| public: |
| using LoadCallback = base::OnceCallback<void(const base::FilePath&)>; |
| |
| Delegate() {} |
| virtual ~Delegate() {} |
| |
| virtual void LoadComponent(const std::string& name, |
| bool mount, |
| LoadCallback load_callback) = 0; |
| |
| virtual bool UnloadComponent(const std::string& name) = 0; |
| |
| private: |
| DISALLOW_COPY_AND_ASSIGN(Delegate); |
| }; |
| |
| explicit ComponentUpdaterServiceProvider( |
| component_updater::CrOSComponentManager* cros_component_manager); |
| ~ComponentUpdaterServiceProvider() override; |
| |
| // CrosDBusService::ServiceProviderInterface overrides: |
| void Start(scoped_refptr<dbus::ExportedObject> exported_object) override; |
| |
| // component_updater::CrOSComponentManager::Delegate overrides: |
| void EmitInstalledSignal(const std::string& component) override; |
| |
| private: |
| // Called from ExportedObject when LoadComponent() is exported as a D-Bus |
| // method or failed to be exported. |
| void OnExported(const std::string& interface_name, |
| const std::string& method_name, |
| bool success); |
| |
| // Called on UI thread in response to a D-Bus request. |
| void LoadComponent(dbus::MethodCall* method_call, |
| dbus::ExportedObject::ResponseSender response_sender); |
| |
| // Callback executed after component loading operation is done. |
| void OnLoadComponent(dbus::MethodCall* method_call, |
| dbus::ExportedObject::ResponseSender response_sender, |
| component_updater::CrOSComponentManager::Error error, |
| const base::FilePath& result); |
| |
| // Called on UI thread in response to a D-Bus request. |
| void UnloadComponent(dbus::MethodCall* method_call, |
| dbus::ExportedObject::ResponseSender response_sender); |
| |
| // Implements EmitInstalledSignal. |
| void EmitInstalledSignalInternal(const std::string& component); |
| |
| // A reference on ExportedObject for sending signals. |
| scoped_refptr<dbus::ExportedObject> exported_object_; |
| |
| // Weak pointer to CrOSComponentManager to avoid calling BrowserProcess. |
| component_updater::CrOSComponentManager* cros_component_manager_; |
| |
| // Keep this last so that all weak pointers will be invalidated at the |
| // beginning of destruction. |
| base::WeakPtrFactory<ComponentUpdaterServiceProvider> weak_ptr_factory_; |
| |
| DISALLOW_COPY_AND_ASSIGN(ComponentUpdaterServiceProvider); |
| }; |
| |
| } // namespace chromeos |
| |
| #endif // CHROME_BROWSER_CHROMEOS_DBUS_COMPONENT_UPDATER_SERVICE_PROVIDER_H_ |