/* * Copyright 2019 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #pragma once #include #include #include #include #include #include "common/bind.h" #include "os/handler.h" #include "os/log.h" #include "os/thread.h" namespace bluetooth { class Module; class ModuleRegistry; class ModuleFactory { friend ModuleRegistry; public: ModuleFactory(std::function ctor); private: std::function ctor_; }; class ModuleList { friend ModuleRegistry; friend Module; public: template void add() { list_.push_back(&T::Factory); } private: std::vector list_; }; // Each leaf node module must have a factory like so: // // static const ModuleFactory Factory; // // which will provide a constructor for the module registry to call. // The module registry will also use the factory as the identifier // for that module. class Module { friend ModuleRegistry; public: virtual ~Module() = default; protected: // Populate the provided list with modules that must start before yours virtual void ListDependencies(ModuleList* list) = 0; // You can grab your started dependencies during or after this call // using GetDependency(), or access the module registry via GetModuleRegistry() virtual void Start() = 0; // Release all resources, you're about to be deleted virtual void Stop() = 0; virtual std::string ToString() const; ::bluetooth::os::Handler* GetHandler() const; const ModuleRegistry* GetModuleRegistry() const; template T* GetDependency() const { return static_cast(GetDependency(&T::Factory)); } private: Module* GetDependency(const ModuleFactory* module) const; ::bluetooth::os::Handler* handler_ = nullptr; ModuleList dependencies_; const ModuleRegistry* registry_; }; class ModuleRegistry { friend Module; friend class StackManager; public: template bool IsStarted() const { return IsStarted(&T::Factory); } bool IsStarted(const ModuleFactory* factory) const; // Start all the modules on this list and their dependencies // in dependency order void Start(ModuleList* modules, ::bluetooth::os::Thread* thread); template T* Start(::bluetooth::os::Thread* thread) { return static_cast(Start(&T::Factory, thread)); } Module* Start(const ModuleFactory* id, ::bluetooth::os::Thread* thread); // Stop all running modules in reverse order of start void StopAll(); protected: Module* Get(const ModuleFactory* module) const; void set_registry_and_handler(Module* instance, ::bluetooth::os::Thread* thread) const; os::Handler* GetModuleHandler(const ModuleFactory* module) const; std::map started_modules_; std::vector start_order_; }; class TestModuleRegistry : public ModuleRegistry { public: void InjectTestModule(const ModuleFactory* module, Module* instance) { start_order_.push_back(module); started_modules_[module] = instance; set_registry_and_handler(instance, &test_thread); } Module* GetModuleUnderTest(const ModuleFactory* module) const { return Get(module); } os::Handler* GetTestModuleHandler(const ModuleFactory* module) const { return GetModuleHandler(module); } os::Thread& GetTestThread() { return test_thread; } bool SynchronizeModuleHandler(const ModuleFactory* module, std::chrono::milliseconds timeout) const { std::promise promise; auto future = promise.get_future(); os::Handler* handler = GetTestModuleHandler(module); handler->Post(common::BindOnce(&std::promise::set_value, common::Unretained(&promise))); return future.wait_for(timeout) == std::future_status::ready; } private: os::Thread test_thread{"test_thread", os::Thread::Priority::NORMAL}; }; } // namespace bluetooth