/* ============================================================================== This file is part of the JUCE library. Copyright (c) 2016 - ROLI Ltd. Permission is granted to use this software under the terms of the ISC license http://www.isc.org/downloads/software-support-policy/isc-license/ Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. ----------------------------------------------------------------------------- To release a closed-source product which uses other parts of JUCE not licensed under the ISC terms, commercial licenses are available: visit www.juce.com for more information. ============================================================================== */ MessageManager::MessageManager() noexcept : quitMessagePosted (false), quitMessageReceived (false), messageThreadId (Thread::getCurrentThreadId()), threadWithLock (0) { if (JUCEApplicationBase::isStandaloneApp()) Thread::setCurrentThreadName ("Juce Message Thread"); } MessageManager::~MessageManager() noexcept { broadcaster = nullptr; doPlatformSpecificShutdown(); jassert (instance == this); instance = nullptr; // do this last in case this instance is still needed by doPlatformSpecificShutdown() } MessageManager* MessageManager::instance = nullptr; MessageManager* MessageManager::getInstance() { if (instance == nullptr) { instance = new MessageManager(); doPlatformSpecificInitialisation(); } return instance; } MessageManager* MessageManager::getInstanceWithoutCreating() noexcept { return instance; } void MessageManager::deleteInstance() { deleteAndZero (instance); } //============================================================================== bool MessageManager::MessageBase::post() { MessageManager* const mm = MessageManager::instance; if (mm == nullptr || mm->quitMessagePosted || ! postMessageToSystemQueue (this)) { Ptr deleter (this); // (this will delete messages that were just created with a 0 ref count) return false; } return true; } //============================================================================== #if JUCE_MODAL_LOOPS_PERMITTED && ! (JUCE_MAC || JUCE_IOS) bool MessageManager::runDispatchLoopUntil (int millisecondsToRunFor) { jassert (isThisTheMessageThread()); // must only be called by the message thread const int64 endTime = Time::currentTimeMillis() + millisecondsToRunFor; while (! quitMessageReceived) { JUCE_TRY { if (! dispatchNextMessageOnSystemQueue (millisecondsToRunFor >= 0)) Thread::sleep (1); } JUCE_CATCH_EXCEPTION if (millisecondsToRunFor >= 0 && Time::currentTimeMillis() >= endTime) break; } return ! quitMessageReceived; } #endif #if ! (JUCE_MAC || JUCE_IOS || JUCE_ANDROID) class MessageManager::QuitMessage : public MessageManager::MessageBase { public: QuitMessage() {} void messageCallback() override { if (MessageManager* const mm = MessageManager::instance) mm->quitMessageReceived = true; } JUCE_DECLARE_NON_COPYABLE (QuitMessage) }; void MessageManager::runDispatchLoop() { jassert (isThisTheMessageThread()); // must only be called by the message thread while (! quitMessageReceived) { JUCE_TRY { if (! dispatchNextMessageOnSystemQueue (false)) Thread::sleep (1); } JUCE_CATCH_EXCEPTION } } void MessageManager::stopDispatchLoop() { (new QuitMessage())->post(); quitMessagePosted = true; } #endif //============================================================================== #if JUCE_COMPILER_SUPPORTS_LAMBDAS struct AsyncFunction : private MessageManager::MessageBase { AsyncFunction (std::function f) : fn (f) { post(); } private: std::function fn; void messageCallback() override { fn(); } JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (AsyncFunction) }; void MessageManager::callAsync (std::function f) { new AsyncFunction (f); } #endif //============================================================================== class AsyncFunctionCallback : public MessageManager::MessageBase { public: AsyncFunctionCallback (MessageCallbackFunction* const f, void* const param) : result (nullptr), func (f), parameter (param) {} void messageCallback() override { result = (*func) (parameter); finished.signal(); } WaitableEvent finished; void* volatile result; private: MessageCallbackFunction* const func; void* const parameter; JUCE_DECLARE_NON_COPYABLE (AsyncFunctionCallback) }; void* MessageManager::callFunctionOnMessageThread (MessageCallbackFunction* const func, void* const parameter) { if (isThisTheMessageThread()) return func (parameter); // If this thread has the message manager locked, then this will deadlock! jassert (! currentThreadHasLockedMessageManager()); const ReferenceCountedObjectPtr message (new AsyncFunctionCallback (func, parameter)); if (message->post()) { message->finished.wait(); return message->result; } jassertfalse; // the OS message queue failed to send the message! return nullptr; } //============================================================================== void MessageManager::deliverBroadcastMessage (const String& value) { if (broadcaster != nullptr) broadcaster->sendActionMessage (value); } void MessageManager::registerBroadcastListener (ActionListener* const listener) { if (broadcaster == nullptr) broadcaster = new ActionBroadcaster(); broadcaster->addActionListener (listener); } void MessageManager::deregisterBroadcastListener (ActionListener* const listener) { if (broadcaster != nullptr) broadcaster->removeActionListener (listener); } //============================================================================== bool MessageManager::isThisTheMessageThread() const noexcept { return Thread::getCurrentThreadId() == messageThreadId; } void MessageManager::setCurrentThreadAsMessageThread() { const Thread::ThreadID thisThread = Thread::getCurrentThreadId(); if (messageThreadId != thisThread) { messageThreadId = thisThread; // This is needed on windows to make sure the message window is created by this thread doPlatformSpecificShutdown(); doPlatformSpecificInitialisation(); } } bool MessageManager::currentThreadHasLockedMessageManager() const noexcept { const Thread::ThreadID thisThread = Thread::getCurrentThreadId(); return thisThread == messageThreadId || thisThread == threadWithLock; } //============================================================================== //============================================================================== /* The only safe way to lock the message thread while another thread does some work is by posting a special message, whose purpose is to tie up the event loop until the other thread has finished its business. Any other approach can get horribly deadlocked if the OS uses its own hidden locks which get locked before making an event callback, because if the same OS lock gets indirectly accessed from another thread inside a MM lock, you're screwed. (this is exactly what happens in Cocoa). */ class MessageManagerLock::BlockingMessage : public MessageManager::MessageBase { public: BlockingMessage() noexcept {} void messageCallback() override { lockedEvent.signal(); releaseEvent.wait(); } WaitableEvent lockedEvent, releaseEvent; JUCE_DECLARE_NON_COPYABLE (BlockingMessage) }; //============================================================================== MessageManagerLock::MessageManagerLock (Thread* const threadToCheck) : blockingMessage(), locked (attemptLock (threadToCheck, nullptr)) { } MessageManagerLock::MessageManagerLock (ThreadPoolJob* const jobToCheckForExitSignal) : blockingMessage(), locked (attemptLock (nullptr, jobToCheckForExitSignal)) { } bool MessageManagerLock::attemptLock (Thread* const threadToCheck, ThreadPoolJob* const job) { MessageManager* const mm = MessageManager::instance; if (mm == nullptr) return false; if (mm->currentThreadHasLockedMessageManager()) return true; if (threadToCheck == nullptr && job == nullptr) { mm->lockingLock.enter(); } else { while (! mm->lockingLock.tryEnter()) { if ((threadToCheck != nullptr && threadToCheck->threadShouldExit()) || (job != nullptr && job->shouldExit())) return false; Thread::yield(); } } blockingMessage = new BlockingMessage(); if (! blockingMessage->post()) { blockingMessage = nullptr; return false; } while (! blockingMessage->lockedEvent.wait (20)) { if ((threadToCheck != nullptr && threadToCheck->threadShouldExit()) || (job != nullptr && job->shouldExit())) { blockingMessage->releaseEvent.signal(); blockingMessage = nullptr; mm->lockingLock.exit(); return false; } } jassert (mm->threadWithLock == 0); mm->threadWithLock = Thread::getCurrentThreadId(); return true; } MessageManagerLock::~MessageManagerLock() noexcept { if (blockingMessage != nullptr) { MessageManager* const mm = MessageManager::instance; jassert (mm == nullptr || mm->currentThreadHasLockedMessageManager()); blockingMessage->releaseEvent.signal(); blockingMessage = nullptr; if (mm != nullptr) { mm->threadWithLock = 0; mm->lockingLock.exit(); } } } //============================================================================== JUCE_API void JUCE_CALLTYPE initialiseJuce_GUI(); JUCE_API void JUCE_CALLTYPE initialiseJuce_GUI() { JUCE_AUTORELEASEPOOL { MessageManager::getInstance(); } } JUCE_API void JUCE_CALLTYPE shutdownJuce_GUI(); JUCE_API void JUCE_CALLTYPE shutdownJuce_GUI() { JUCE_AUTORELEASEPOOL { DeletedAtShutdown::deleteAll(); MessageManager::deleteInstance(); } } static int numScopedInitInstances = 0; ScopedJuceInitialiser_GUI::ScopedJuceInitialiser_GUI() { if (numScopedInitInstances++ == 0) initialiseJuce_GUI(); } ScopedJuceInitialiser_GUI::~ScopedJuceInitialiser_GUI() { if (--numScopedInitInstances == 0) shutdownJuce_GUI(); }