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