event_broadcaster.hpp

Go to the documentation of this file.

#ifndef SBL_CORE_PATTERNS_EVENTS_EVENT_BROADCASTER_HPP_
#define SBL_CORE_PATTERNS_EVENTS_EVENT_BROADCASTER_HPP_
 
/**
 * @file event_broadcaster.hpp
 * @brief Generic event broadcasting for coordinating multiple outputs
 * @ingroup patterns
 * 
 * Template-based event coordination without domain-specific logic.
 * Manages multiple output devices that respond to events.
 */
 
namespace sbl {
namespace core {
namespace patterns {
namespace events {
 
/**
 * @brief Generic event broadcaster for two outputs
 * 
 * Simplified broadcaster for two output types, avoiding complex
 * variadic template constructs. Applications can compose multiple
 * broadcasters if more outputs are needed.
 * 
 * @tparam Output1Type First output device type
 * @tparam Output2Type Second output device type
 */
template<typename Output1Type, typename Output2Type>
class EventBroadcaster {
public:
    /**
     * @brief Construct event broadcaster with two outputs
     * @param output1 Reference to first output device
     * @param output2 Reference to second output device
     */
    EventBroadcaster(Output1Type& output1, Output2Type& output2) 
        : output1_(output1), output2_(output2) {}
    
    /**
     * @brief Trigger all outputs
     */
    void trigger() {
        triggerOutput(output1_);
        triggerOutput(output2_);
    }
    
    /**
     * @brief Update all outputs
     */
    void update() {
        output1_.update();
        output2_.update();
    }
 
private:
    Output1Type& output1_;
    Output2Type& output2_;
    
    // Use flash() method for LED-like outputs
    template<typename T>
    void triggerOutput(T& output) {
        output.flash();
    }
};
 
/**
 * @brief Specialized broadcaster for FlashLed and Trigger types
 * 
 * Template specialization that calls appropriate methods:
 * - flash() for FlashLed
 * - fire() for Trigger
 */
template<typename FlashLedType, typename TriggerType>
class FlashLedTriggerBroadcaster {
public:
    FlashLedTriggerBroadcaster(FlashLedType& flashLed, TriggerType& trigger)
        : flashLed_(flashLed), trigger_(trigger) {}
    
    void trigger() {
        flashLed_.flash();
        trigger_.fire();
    }
    
    void update() {
        flashLed_.update();
        trigger_.update();
    }
 
private:
    FlashLedType& flashLed_;
    TriggerType& trigger_;
};
 
} // namespace events
} // namespace patterns
} // namespace core
} // namespace sbl
 
#endif // SBL_CORE_PATTERNS_EVENTS_EVENT_BROADCASTER_HPP_