cafSignal.h

//##################################################################################################
//
//   Custom Visualization Core library
//   Copyright (C) 2020- Ceetron Solutions AS
//
//   This library may be used under the terms of either the GNU General Public License or
//   the GNU Lesser General Public License as follows:
//
//   GNU General Public License Usage
//   This library is free software: you can redistribute it and/or modify
//   it under the terms of the GNU General Public License as published by
//   the Free Software Foundation, either version 3 of the License, or
//   (at your option) any later version.
//
//   This library is distributed in the hope that it will be useful, but WITHOUT ANY
//   WARRANTY; without even the implied warranty of MERCHANTABILITY or
//   FITNESS FOR A PARTICULAR PURPOSE.
//
//   See the GNU General Public License at <<http://www.gnu.org/licenses/gpl.html>>
//   for more details.
//
//   GNU Lesser General Public License Usage
//   This library is free software; you can redistribute it and/or modify
//   it under the terms of the GNU Lesser General Public License as published by
//   the Free Software Foundation; either version 2.1 of the License, or
//   (at your option) any later version.
//
//   This library is distributed in the hope that it will be useful, but WITHOUT ANY
//   WARRANTY; without even the implied warranty of MERCHANTABILITY or
//   FITNESS FOR A PARTICULAR PURPOSE.
//
//   See the GNU Lesser General Public License at <<http://www.gnu.org/licenses/lgpl-2.1.html>>
//   for more details.
//
//##################################################################################################
#pragma once
 
#include "cafAssert.h"
 
#include <functional>
#include <list>
#include <map>
#include <string>
#include <type_traits>
 
namespace caffa
{
class SignalEmitter;
class SignalObserver;
 
class AbstractSignal
{
public:
    virtual ~AbstractSignal() noexcept                  = default;
    virtual void disconnect( SignalObserver* observer ) = 0;
};
 
//==================================================================================================
//==================================================================================================
class SignalEmitter
{
public:
    SignalEmitter();
    virtual ~SignalEmitter() noexcept;
 
    void                       addEmittedSignal( AbstractSignal* signalToAdd ) const;
    std::list<AbstractSignal*> emittedSignals() const;
 
private:
    mutable std::list<AbstractSignal*> m_signals;
};
 
//==================================================================================================
//==================================================================================================
class SignalObserver
{
public:
    SignalObserver();
    virtual ~SignalObserver() noexcept;
    std::list<AbstractSignal*> observedSignals() const;
    void                       addObservedSignal( AbstractSignal* signalToAdd ) const;
    void                       removeObservedSignal( AbstractSignal* signalToRemove ) const noexcept;
 
private:
    void disconnectAllSignals() noexcept;
 
private:
    mutable std::list<AbstractSignal*> m_signals;
};
 
//==================================================================================================
//==================================================================================================
template <typename... Args>
class Signal : public AbstractSignal
{
public:
    using MemberCallback              = std::function<void( const SignalEmitter*, Args... args )>;
    using MemberCallbackAndActiveFlag = std::pair<MemberCallback, bool>;
 
public:
    Signal( const SignalEmitter* emitter )
        : m_emitter( emitter )
    {
        m_emitter->addEmittedSignal( this );
    }
 
    virtual ~Signal()
    {
        for ( auto observerCallbackPair : m_observerCallbacks )
        {
            observerCallbackPair.first->removeObservedSignal( this );
        }
    }
 
    template <typename ClassType>
    void connect( ClassType* observer, void ( ClassType::*method )( const SignalEmitter*, Args... args ) )
    {
        MemberCallback lambda = [=]( const SignalEmitter* emitter, Args... args )
        {
            // Call method
            ( observer->*method )( emitter, args... );
        };
        connect( observer, lambda );
    }
 
    template <typename ClassType>
    void connect( ClassType* observer, const MemberCallback& callback )
    {
        static_assert( std::is_convertible<ClassType*, SignalObserver*>::value,
                       "Only classes that inherit SignalObserver can connect as an observer of a Signal." );
        m_observerCallbacks[observer] = std::make_pair( callback, true );
        observer->addObservedSignal( this );
    }
 
    // Disconnect an observer from the signal. Do this only when the relationship between the
    // observer and emitter is severed but the object kept alive.
    // There's no need to do this when deleting the observer.
    void disconnect( SignalObserver* observer ) noexcept override
    {
        // This does not throw, since std::map::erase only throws if the comparison operator throws
        // and we're just comparing pointers.
        m_observerCallbacks.erase( observer );
        observer->removeObservedSignal( this );
    }
 
    void send( Args... args ) const
    {
        auto observerCallBacksCopy = m_observerCallbacks;
        for ( auto observerCallbackPair : observerCallBacksCopy )
        {
            if ( observerCallbackPair.second.second )
            {
                observerCallbackPair.second.first( m_emitter, args... );
            }
        }
    }
 
    void block( SignalObserver* observer )
    {
        auto it = m_observerCallbacks.find( observer );
        CAFFA_ASSERT( it != m_observerCallbacks.end() );
        it->second.second = false;
    }
 
    void unblock( SignalObserver* observer )
    {
        auto it = m_observerCallbacks.find( observer );
        CAFFA_ASSERT( it != m_observerCallbacks.end() );
        it->second.second = true;
    }
    size_t observerCount() const { return m_observerCallbacks.size(); }
 
    bool connected( const SignalObserver* observer ) const
    {
        for ( const auto& observerPair : m_observerCallbacks )
        {
            if ( observerPair.first == observer ) return true;
        }
        return false;
    }
 
private:
    Signal( const Signal& rhs )            = delete;
    Signal& operator=( const Signal& rhs ) = delete;
 
private:
    std::map<SignalObserver*, MemberCallbackAndActiveFlag> m_observerCallbacks;
    const SignalEmitter*                                   m_emitter;
};
} // namespace caffa