X-Git-Url: https://git.quassel-irc.org/?p=quassel.git;a=blobdiff_plain;f=src%2Fcore%2Fstorage.h;h=2016ed395fc1dc335740b11f8fca93bae7ad162b;hp=d4c4b8b3703beb388371372fb0eda4e784b9502c;hb=52a7b4d0f289f075aa386445a47d876743bcb6d0;hpb=9f9d207ecf28dd5470ecef9d4076a3f447662a20 diff --git a/src/core/storage.h b/src/core/storage.h index d4c4b8b3..2016ed39 100644 --- a/src/core/storage.h +++ b/src/core/storage.h @@ -107,6 +107,23 @@ class Storage : public QObject { */ virtual void delUser(UserId user) = 0; + //! Store a user setting persistently + /** + * \param userId The users Id + * \param settingName The Name of the Setting + * \param data The Value + */ + virtual void setUserSetting(UserId userId, const QString &settingName, const QVariant &data) = 0; + + //! Retrieve a persistent user setting + /** + * \param userId The users Id + * \param settingName The Name of the Setting + * \param default Value to return in case it's unset. + * \return the Value of the Setting or the default value if it is unset. + */ + virtual QVariant getUserSetting(UserId userId, const QString &settingName, const QVariant &data = QVariant()) = 0; + /* Network handling */ //! Create a new Network in the storage backend and return it unique Id @@ -212,15 +229,21 @@ class Storage : public QObject { */ virtual BufferInfo getBufferInfo(UserId user, const BufferId &bufferId) = 0; - //! Request a list of all buffers known to a user since a certain point in time. + //! Request a list of all buffers known to a user. /** This method is used to get a list of all buffers we have stored a backlog from. - * Optionally, a QDateTime can be given, so that only buffers are listed that where active - * since that point in time. * \param user The user whose buffers we request - * \param since If this is defined, older buffers will be ignored * \return A list of the BufferInfos for all buffers as requested */ - virtual QList requestBuffers(UserId user, QDateTime since = QDateTime()) = 0; + virtual QList requestBuffers(UserId user) = 0; + + //! Request a list of BufferIds for a given NetworkId + /** \note This method is threadsafe. + * + * \param user The user whose buffers we request + * \param networkId The NetworkId of the network in question + * \return List of BufferIds belonging to the Network + */ + virtual QList requestBufferIdsForNetwork(UserId user, NetworkId networkId) = 0; //! Remove permanently a buffer and it's content from the storage backend /** This call cannot be reverted! @@ -268,7 +291,7 @@ class Storage : public QObject { * \param offset Do not return (but DO count) messages with MsgId >= offset, if offset >= 0 * \return The requested list of messages */ - virtual QList requestMsgs(BufferInfo buffer, int lastmsgs = -1, int offset = -1) = 0; + virtual QList requestMsgs(UserId user, BufferId buffer, int lastmsgs = -1, int offset = -1) = 0; //! Request messages stored in a given buffer since a certain point in time. /** \param buffer The buffer we request messages from @@ -276,7 +299,7 @@ class Storage : public QObject { * \param offset Do not return messages with MsgId >= offset, if offset >= 0 * \return The requested list of messages */ - virtual QList requestMsgs(BufferInfo buffer, QDateTime since, int offset = -1) = 0; + virtual QList requestMsgs(UserId user, BufferId buffer, QDateTime since, int offset = -1) = 0; //! Request a range of messages stored in a given buffer. /** \param buffer The buffer we request messages from @@ -284,7 +307,7 @@ class Storage : public QObject { * \param last Return messages with first <= MsgId <= last * \return The requested list of messages */ - virtual QList requestMsgRange(BufferInfo buffer, int first, int last) = 0; + virtual QList requestMsgRange(UserId user, BufferId buffer, int first, int last) = 0; signals: //! Sent when a new BufferInfo is created, or an existing one changed somehow.