ObservableCardReader.hpp

Go to the documentation of this file.

/******************************************************************************
 * Copyright (c) 2025 Calypso Networks Association https://calypsonet.org/    *
 *                                                                            *
 * See the NOTICE file(s) distributed with this work for additional           *
 * information regarding copyright ownership.                                 *
 *                                                                            *
 * This program and the accompanying materials are made available under the   *
 * terms of the MIT License which is available at                             *
 * https://opensource.org/licenses/MIT                                        *
 *                                                                            *
 * SPDX-License-Identifier: MIT                                               *
 ******************************************************************************/
 
#pragma once
 
#include <memory>
 
#include "keypop/reader/CardReader.hpp"
#include "keypop/reader/spi/CardReaderObservationExceptionHandlerSpi.hpp"
#include "keypop/reader/spi/CardReaderObserverSpi.hpp"
 
namespace keypop {
namespace reader {
 
using keypop::reader::spi::CardReaderObservationExceptionHandlerSpi;
using keypop::reader::spi::CardReaderObserverSpi;
 
class ObservableCardReader : virtual public CardReader {
public:
    enum DetectionMode {
        REPEATING,
 
        SINGLESHOT
    };
 
    enum NotificationMode {
        ALWAYS,
        MATCHED_ONLY
    };
 
    virtual void setReaderObservationExceptionHandler(
        std::shared_ptr<CardReaderObservationExceptionHandlerSpi>
            exceptionHandler) = 0;
 
    virtual void addObserver(std::shared_ptr<CardReaderObserverSpi> observer)
        = 0;
 
    virtual void
    removeObserver(const std::shared_ptr<CardReaderObserverSpi> observer) = 0;
 
    virtual void clearObservers() = 0;
 
    virtual int countObservers() const = 0;
 
    virtual void startCardDetection(const DetectionMode detectionMode) = 0;
 
    virtual void stopCardDetection() = 0;
 
    virtual void finalizeCardProcessing() = 0;
};
 
} /* namespace reader */
} /* namespace keypop */