1 // 2 // Copyright 2015 Google, Inc. 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 #pragma once 18 19 #include "abstract_message_loop.h" 20 21 namespace ipc { 22 class IPCManager; 23 } // namespace ipc 24 25 namespace bluetooth { 26 27 class CoreStack; 28 class Settings; 29 30 // The Daemon class is a singleton that represents the root of the ownership 31 // hierarchy. The single instance sets up and owns the main event loop, the IPC 32 // handlers, global Settings, and the core Bluetooth stack. 33 class Daemon { 34 public: 35 // Initializes the daemon. This must be called to at the start of the 36 // application to set up the global daemon instance and everything it manages. 37 // Returns false in case of a failure. 38 static bool Initialize(); 39 40 // Cleans up all the resources associated with the global Daemon object. 41 static void ShutDown(); 42 43 // Assigns the global Daemon instance for testing. Should only be called from 44 // test code. 45 static void InitializeForTesting(Daemon* test_daemon); 46 47 // Returns the singleton Daemon instance. All classes can interact with the 48 // Daemon, obtain its resources etc using this getter. 49 static Daemon* Get(); 50 51 // The global Settings object. All classes have direct access to this through 52 // the Daemon object. 53 virtual Settings* GetSettings() const = 0; 54 55 // The main event loop. This should be used for any events and delayed tasks 56 // that should be executed on the daemon's main thread. 57 virtual btbase::AbstractMessageLoop* GetMessageLoop() const = 0; 58 59 // Starts the daemon's main loop. 60 virtual void StartMainLoop() = 0; 61 62 protected: 63 Daemon() = default; 64 Daemon(const Daemon&) = delete; 65 Daemon& operator=(const Daemon&) = delete; 66 67 virtual ~Daemon() = default; 68 69 private: 70 // Internal instance helper called by Initialize(). 71 virtual bool Init() = 0; 72 }; 73 74 } // namespace bluetooth 75