abstract_table_item.h

#pragma once
 
// Application headers
namespace ehm_dal::column_data {
class ColumnData;
}
namespace ehm_dal::database {
class DatabaseVersion;
}
namespace ehm_dal::tables {
enum class TableIndex : char;
}
 
// Qt headers
class QDataStream;
class QModelIndex;
#include <QString>
#include <QVariant>
#include <type_traits>
 
namespace ehm_dal::schema {
 
template<typename T>
concept IntegralNumber = std::is_integral<T>::value;
 
// -- Table item/record --- //
class AbstractTableItem
{
public:
    AbstractTableItem();
    virtual ~AbstractTableItem();
 
    // Child data
    virtual void addChildItem(std::shared_ptr<AbstractTableItem> item,
                              const ehm_dal::tables::TableIndex child_table);
    virtual QVariant childData(const QModelIndex &index,
                               qint32 role,
                               ehm_dal::column_data::ColumnData *column_data,
                               const ehm_dal::tables::TableIndex child_table) const;
    virtual qint32 childItemId(const ehm_dal::tables::TableIndex child_table) const;
    virtual qint32 childRowCount(const ehm_dal::tables::TableIndex child_table) const;
    virtual bool setChildData(const QModelIndex &index,
                              const QVariant &value,
                              const qint32 role,
                              std::vector<qint32> &modified_columns,
                              ehm_dal::column_data::ColumnData *column_data,
                              const ehm_dal::tables::TableIndex child_table);
 
    // File i/o
    virtual bool read(QDataStream &in, ehm_dal::database::DatabaseVersion &version);
    virtual bool write(QDataStream &out, ehm_dal::database::DatabaseVersion &version);
 
    // Get data - item attributes
    inline qint32 id() const { return id_; }
    QVariant id(const qint32 role);
    virtual QString text() const = 0;
    Q_DECL_DEPRECATED QString displayText() const { return text(); } // TODO to be deprecated
    virtual qint32 uid() const;
 
    // Get data
    QVariant data(const qint32 column,
                  qint32 role,
                  ehm_dal::column_data::ColumnData *column_data) const;
    virtual QVariant data(const QModelIndex &index,
                          qint32 role,
                          ehm_dal::column_data::ColumnData *column_data) const;
 
    // Identifier
    virtual QString identifier() const;
    virtual QStringList identifierList() const;
    // TODO implement
    /*QString personIdentifier(const QString &first_name,
                             const QString &second_name,
                             const Date &date_of_birth) const;
    QStringList personIdentifierList(const QString &first_name,
                                     const QString &second_name,
                                     const Date &date_of_birth,
                                     const Year &year_of_birth) const;*/
 
    // Initialisation
    inline virtual bool init() = 0;
    bool alloc(const qint32 new_id);
 
    // Parent data
    virtual qint32 parentItemId() const;
 
    // Set data
    bool setData(const qint32 column,
                 const QVariant &value,
                 qint32 role,
                 std::vector<qint32> &modified_columns,
                 ehm_dal::column_data::ColumnData *column_data);
    virtual bool setData(const QModelIndex &index,
                         const QVariant &value,
                         qint32 role,
                         std::vector<qint32> &modified_columns,
                         ehm_dal::column_data::ColumnData *column_data);
 
    // Validation
    virtual void fixErrors() { return; }
 
protected:
    // Item attributes
    qint32 id_; // Record id
 
    // Get data
    inline virtual bool deletable() const { return false; }
    template<IntegralNumber T>
    QVariant fromHexVector(const std::vector<T> &raw_data, const qint32 role) const;
    QVariant fromValue(const QVariant &value, const qint32 role) const;
 
    // Operator overloading (Data stream)
    // This is solely for the purposes of reading/writing the record id for child items
    friend QDataStream &operator>>(QDataStream &in, AbstractTableItem &data);
    friend QDataStream &operator<<(QDataStream &out, const AbstractTableItem &data);
 
private:
    // Get data
    virtual QVariant internalData(const qint32 column, const qint32 role) const = 0;
 
    // Set data
    virtual bool setInternalData(const qint32 column,
                                 const QVariant &value,
                                 const qint32 role,
                                 std::vector<qint32> &modified_columns);
};
 
// File i/o
QDataStream &operator>>(QDataStream &in, ehm_dal::schema::AbstractTableItem &data);
QDataStream &operator<<(QDataStream &out, const ehm_dal::schema::AbstractTableItem &data);
 
// --- Get vector of numbers as a string --- //
template<IntegralNumber T>
QVariant AbstractTableItem::fromHexVector(const std::vector<T> &raw_data, const qint32 role) const
{
    if (role != Qt::DisplayRole)
        return QVariant();
 
    QStringList buffer;
    for (const auto &itr : raw_data)
        buffer << QString("%1").arg(static_cast<quint8>(itr), 2, 16, QLatin1Char('0'));
 
    return buffer.join(QStringLiteral(" "));
}
 
} // namespace ehm_dal::schema