BaseModel Class Reference

#include <Fuoten/Models/BaseModel>

Inheritance diagram for BaseModel:

Properties
double	doubleParentId
bool	inOperation
int	limit
bool	loaded
qint64	parentId
Fuoten::FuotenEnums::SortingRole	sortingRole
Qt::SortOrder	sortOrder
Fuoten::AbstractStorage *	storage
bool	unreadOnly

Public Member Functions
	BaseModel (QObject *parent=nullptr)
	~BaseModel () override
double	doubleParentId () const
virtual QModelIndex	findByID (qint64 id) const
virtual QHash< qint64, QModelIndex >	findByIDs (const IdList &ids) const
bool	inOperation () const
int	limit () const
bool	loaded () const
qint64	parentId () const
void	setDoubleParentId (double nDoubleParentId)
void	setLimit (int nLimit)
void	setParentId (qint64 nParentId)
void	setSortingRole (FuotenEnums::SortingRole nSortingRole)
void	setSortOrder (Qt::SortOrder nSortOrder)
void	setStorage (AbstractStorage *nStorage)
void	setUnreadOnly (bool nUnreadOnly)
FuotenEnums::SortingRole	sortingRole () const
Qt::SortOrder	sortOrder () const
AbstractStorage *	storage () const
bool	unreadOnly () const

Public Slots
virtual void	load ()=0
virtual void	reload ()

Signals
void	doubleParentIdChanged (double doubleParentId)
void	inOperationChanged (bool inOperation)
void	limitChanged (int limit)
void	loadedChanged (bool loaded)
void	parentIdChanged (qint64 parentId)
void	sortingRoleChanged (FuotenEnums::SortingRole sortingRole)
void	sortOrderChanged (Qt::SortOrder sortOrder)
void	storageChanged (Fuoten::AbstractStorage *storage)
void	unreadOnlyChanged (bool unreadOnly)

Protected Member Functions
virtual void	clear ()=0
virtual void	handleStorageChanged (AbstractStorage *old)
void	setInOperation (bool nInOperation)
void	setLoaded (bool loaded)

Detailed Description

Abstract base class for all data models.

Property Documentation

doubleParentId

double doubleParentId

readwrite

Stores the parent ID as double to make it accesseable from QML.

This uses the same data as parentId, but converts it between double and qint64. This is a convenience property for use in QML that does not support 64bit integers. As JavaScript and JSON are storing number values according to IEEE 754, there might happen an overflow, if setting values greater than the limit of qint64. Under normal circumstances we simply assume, that there will hardly be greater database IDs than what fits in qint64.

Access functions:

double	doubleParentId() const
void	setDoubleParentId(double nDoubleParentId)

Notifier signal:

void	doubleParentIdChanged(double doubleParentId)

inOperation

bool inOperation

readwrite

Returns true while the model is loading data.

Access functions:

bool	inOperation() const

Notifier signal:

void	inOperationChanged(bool inOperation)

See also

setInOperation()

limit

int limit

readwrite

Limits the result to the specified number of objects.

Access functions:

int	limit() const
void	setLimit(int nLimit)

Notifier signal:

void	limitChanged(int limit)

loaded

bool loaded

read

This property holds true if the model has initially loaded the data.

While it is true, load() will return immediately without loading data. Use reload() instead. When creating a derived class, you should use setLoaded() after your model has initially loaded the data.

Access functions:

void setLoaded(bool loaded) bool loaded() const

Notifier signal:

void loadedChanged(bool loaded)

parentId

qint64 parentId

readwrite

Sets the parent database ID to load feeds/items for.

If used on a model presenting feeds, this defines the folder, the feed belongs to. If used on a model presenting items, this defines the feed the items belong to.

Access functions:

qint64	parentId() const
void	setParentId(qint64 nParentId)

Notifier signal:

void	parentIdChanged(qint64 parentId)

sortingRole

Fuoten::FuotenEnums::SortingRole sortingRole

readwrite

The role/value used to sort the result.

Access functions:

FuotenEnums::SortingRole	sortingRole() const
void	setSortingRole(FuotenEnums::SortingRole nSortingRole)

Notifier signal:

void	sortingRoleChanged(FuotenEnums::SortingRole sortingRole)

sortOrder

Qt::SortOrder sortOrder

readwrite

The sorting order.

Access functions:

Qt::SortOrder	sortOrder() const
void	setSortOrder(Qt::SortOrder nSortOrder)

Notifier signal:

void	sortOrderChanged(Qt::SortOrder sortOrder)

storage

Fuoten::AbstractStorage * storage

readwrite

Pointer to a class derived from AbstractStorage.

Access functions:

AbstractStorage*	storage() const
void	setStorage(AbstractStorage *nStorage)

Notifier signal:

void	storageChanged(AbstractStorage *storage)

unreadOnly

bool unreadOnly

readwrite

If true, only unread articles, feeds or folders are returned.

Access functions:

bool	unreadOnly() const
void	setUnreadOnly(bool nUnreadOnly)

Notifier signal:

void	unreadOnlyChanged(bool unreadOnly)

Constructor & Destructor Documentation

BaseModel()

BaseModel ( QObject * parent = nullptr )

explicit

Constructs a new BaseModel object.

~BaseModel()

~BaseModel ( )

override

Deconstructs the BaseModel object.

Member Function Documentation

clear()

virtual void clear ( )

protectedpure virtual

Clears the model and removes all model data.

Implemented in AbstractArticleModel, AbstractFeedModel, and AbstractFolderModel.

doubleParentId()

double doubleParentId

(

)

const

Returns the currently set parent ID as double. This function is for use in QML, that does not support 64bit integers. It performs a static cast from the saved qint64 parent ID to double.

See also

doubleParentId

doubleParentIdChanged

void doubleParentIdChanged ( double doubleParentId )

signal

This signal is emitted if the parent ID changes.

See also

doubleParentId

findByID()

QModelIndex findByID ( qint64 id ) const

virtual

Returns the model index of the item identified by database ID.

The default implementation returns an invalid QModelIndex. Reimplement this function in a subclass.

Reimplemented in AbstractArticleModel, AbstractFeedModel, and AbstractFolderModel.

findByIDs()

QHash< qint64, QModelIndex > findByIDs ( const IdList & ids ) const

virtual

Returns a hash-table containing IDs and their model index fount in the model.

The default implementation return an empty QHash<qint64, QModelIndex>. Reimplement this function in a subclass.

Reimplemented in AbstractArticleModel, and AbstractFeedModel.

handleStorageChanged()

void handleStorageChanged ( AbstractStorage * old )

protectedvirtual

Will be called by setStorage() whenever the storage changes.

The default implementation does nothing. You should use this to connect signals from the AbstractStorage to slots in the model implementation that updates the model data after the local data has been changed.

Example implementation

void AbstractFolderModel::handleStorageChanged()
{
    AbstractStorage *s = storage();
    connect(s, &AbstractStorage::readyChanged, this, &AbstractFolderModel::load);
    connect(s, &AbstractStorage::requestedFolders, this, &AbstractFolderModel::foldersRequested);
    connect(s, &AbstractStorage::renamedFolder, this, &AbstractFolderModel::folderRenamed);
    connect(s, &AbstractStorage::createdFolder, this, &AbstractFolderModel::folderCreated);
    connect(s, &AbstractStorage::deletedFolder, this, &AbstractFolderModel::folderDeleted);
    connect(s, &AbstractStorage::markedReadFolder, this, &AbstractFolderModel::folderMarkedRead);
}

Reimplemented in AbstractArticleModel, AbstractFeedModel, and AbstractFolderModel.

inOperation()

bool inOperation

(

)

const

Returns true while the model is loading data.

See also

inOperation

inOperationChanged

void inOperationChanged ( bool inOperation )

signal

This signal is emitted if the operational state of the model changes.

See also

inOperatoin

limit()

int limit

(

)

const

Getter function for the limit property.

See also

BaseModel::setLimit(), BaseModel::limitChanged()

limitChanged

void limitChanged ( int limit )

signal

This is emitted if the value of the limit property changes.

See also

BaseModel::limit(), BaseModel::setLimit()

load

virtual void load ( )

pure virtualslot

Loads the model data.

Reimplement this in a subclass. Do only load the data, if loaded() returns false and set setLoaded() to true after the data has been loaded. All later changes, after the model has loaded the initial data, should be done by signals and slots without reloading the full model.

Additionally you could use the inOperation property in this function to indicate, that the model is loading its data.

Example implementation

void AbstractFolderModel::load()
{
    if (!storage()) {
        return;
    }
 
    if (!storage()->ready() || loaded()) {
        return;
    }
 
    setInOperation(true);
 
    Q_D(AbstractFolderModel);
 
    const QList<Folder*> fs = storage()->getFolders(FuotenEnums::Name, Qt::AscendingOrder);
    if (!fs.isEmpty()) {
        beginInsertRows(QModelIndex(), 0, fs.count() - 1);
        d->folders = fs;
        endInsertRows();
    }
 
    setLoaded(true);
    setInOperation(false);
}

loaded()

bool loaded

(

)

const

Getter function for the loaded property. *.

See also

setLoaded(), loadedChanged()

loadedChanged

void loadedChanged ( bool loaded )

signal

This is emitted if the value of the loaded property changes.

See also

loaded(), setLoaded()

parentId()

qint64 parentId

(

)

const

Returns the currently set parent ID.

See also

parentId

parentIdChanged

void parentIdChanged ( qint64 parentId )

signal

This signal is emitted if the parent ID changes.

See also

parentId

reload

void reload ( )

virtualslot

Reloads the complete model.

Will call clear(), will than set loaded to false and will then call load().

setDoubleParentId()

void setDoubleParentId

(

double

nDoubleParentId

)

Sets the parent ID via a double. This function is for use in QML, that does not support 64bit integers. It performs a static cast from the double to a qint64 to save it.

See also

doubleParentId

setInOperation()

void setInOperation ( bool nInOperation )

protected

Sets the inOperation property.

See also

inOperation

setLimit()

void setLimit

(

int

nLimit

)

Setter function for the limit property. Emits the limitChanged() signal if nLimit is not equal to the stored value.

See also

BaseModel::limit(), BaseModel::limitChanged()

setLoaded()

void setLoaded ( bool loaded )

protected

Set this to true if the model has initially loaded its data.

In the reimplementation of a BaseModel this should be set in the implementation of the load() function, after the initial data has been loaded.

See also

BaseModel::loaded

setParentId()

void setParentId

(

qint64

nParentId

)

Set the parent ID.

See also

parentId

setSortingRole()

void setSortingRole

(

FuotenEnums::SortingRole

nSortingRole

)

Setter function for the sortingRole property. Emits the sortingRoleChanged() signal if nSortingRole is not equal to the stored value.

See also

BaseModel::sortingRole(), BaseModel::sortingRoleChanged()

setSortOrder()

void setSortOrder

(

Qt::SortOrder

nSortOrder

)

Setter function for the sortOrder property. Emits the sortOrderChanged() signal if nSortOrder is not equal to the stored value.

See also

BaseModel::sortOrder(), BaseModel::sortOrderChanged()

setStorage()

void setStorage

(

AbstractStorage *

nStorage

)

Sets the pointer to the local storage handler.

See also

storage

setUnreadOnly()

void setUnreadOnly

(

bool

nUnreadOnly

)

Setter function for the unreadOnly property. Emits the unreadOnlyChanged() signal if nUnreadOnly is not equal to the stored value.

See also

BaseModel::unreadOnly(), BaseModel::unreadOnlyChanged()

sortingRole()

FuotenEnums::SortingRole sortingRole

(

)

const

Getter function for the sortingRole property.

See also

BaseModel::setSortingRole(), BaseModel::sortingRoleChanged()

sortingRoleChanged

void sortingRoleChanged ( FuotenEnums::SortingRole sortingRole )

signal

This is emitted if the value of the sortingRole property changes.

See also

BaseModel::sortingRole(), BaseModel::setSortingRole()

sortOrder()

Qt::SortOrder sortOrder

(

)

const

Getter function for the sortOrder property.

See also

BaseModel::setSortOrder(), BaseModel::sortOrderChanged()

sortOrderChanged

void sortOrderChanged ( Qt::SortOrder sortOrder )

signal

This is emitted if the value of the sortOrder property changes.

See also

BaseModel::sortOrder(), BaseModel::setSortOrder()

storage()

AbstractStorage * storage

(

)

const

Returns the pointer to the currently set local storage.

See also

storage

storageChanged

void storageChanged ( Fuoten::AbstractStorage * storage )

signal

This signal is emitted if the poiner to the local storage changes.

See also

storage

unreadOnly()

bool unreadOnly

(

)

const

Getter function for the unreadOnly property.

See also

BaseModel::setUnreadOnly(), BaseModel::unreadOnlyChanged()

unreadOnlyChanged

void unreadOnlyChanged ( bool unreadOnly )

signal

This is emitted if the value of the unreadOnly property changes.

See also

BaseModel::unreadOnly(), BaseModel::setUnreadOnly()