libQuotient
A Qt library for building matrix clients
Quotient::SyncJob Class Reference

#include <syncjob.h>

Inheritance diagram for Quotient::SyncJob:
Collaboration diagram for Quotient::SyncJob:

Public Member Functions

 SyncJob (const QString &since={}, const QString &filter={}, int timeout=-1, const QString &presence={})
 
 SyncJob (const QString &since, const Filter &filter, int timeout=-1, const QString &presence={})
 
SyncData takeData ()
 
- Public Member Functions inherited from Quotient::BaseJob
 BaseJob (HttpVerb verb, const QString &name, QByteArray endpoint, bool needsToken=true)
 
 BaseJob (HttpVerb verb, const QString &name, QByteArray endpoint, const QUrlQuery &query, RequestData &&data={}, bool needsToken=true)
 
QUrl requestUrl () const
 
bool isBackground () const
 
Status status () const
 
QString statusCaption () const
 
QByteArray rawData (int bytesAtMost) const
 
const QByteArray & rawData () const
 
QString rawDataSample (int bytesAtMost=65535) const
 
QJsonObject jsonData () const
 
QJsonArray jsonItems () const
 
template<typename T , typename StrT >
loadFromJson (const StrT &keyName, T &&defaultValue={}) const
 
template<typename T >
takeFromJson (const QString &key, T &&defaultValue={})
 
int error () const
 
virtual QString errorString () const
 
QUrl errorUrl () const
 
int maxRetries () const
 
void setMaxRetries (int newMaxRetries)
 
std::chrono::seconds getCurrentTimeout () const
 
Q_INVOKABLE Quotient::BaseJob::duration_ms_t getCurrentTimeoutMs () const
 
std::chrono::seconds getNextRetryInterval () const
 
Q_INVOKABLE Quotient::BaseJob::duration_ms_t getNextRetryMs () const
 
std::chrono::milliseconds timeToRetry () const
 
Q_INVOKABLE Quotient::BaseJob::duration_ms_t millisToRetry () const
 

Protected Member Functions

Status prepareResult () override
 An extension point for additional reply processing. More...
 
- Protected Member Functions inherited from Quotient::BaseJob
const headers_trequestHeaders () const
 
void setRequestHeader (const headers_t::key_type &headerName, const headers_t::mapped_type &headerValue)
 
void setRequestHeaders (const headers_t &headers)
 
QUrlQuery query () const
 
void setRequestQuery (const QUrlQuery &query)
 
const RequestDatarequestData () const
 
void setRequestData (RequestData &&data)
 
const QByteArrayList & expectedContentTypes () const
 
void addExpectedContentType (const QByteArray &contentType)
 
void setExpectedContentTypes (const QByteArrayList &contentTypes)
 
QByteArrayList expectedKeys () const
 
void addExpectedKey (const QByteArray &key)
 
void setExpectedKeys (const QByteArrayList &keys)
 
const QNetworkReply * reply () const
 
QNetworkReply * reply ()
 
virtual void doPrepare ()
 
virtual void onSentRequest (QNetworkReply *)
 
virtual void beforeAbandon ()
 
virtual Status prepareError (Status currentStatus)
 Process details of the error. More...
 
QJsonValue takeValueFromJson (const QString &key)
 Get direct access to the JSON response object in the job. More...
 
void setStatus (Status s)
 
void setStatus (int code, QString message)
 
void setLoggingCategory (QMessageLogger::CategoryFunction lcf)
 Set the logging category for the given job instance. More...
 
 ~BaseJob () override
 

Additional Inherited Members

- Public Types inherited from Quotient::BaseJob
enum  StatusCode {
  Success = 0 , NoError = Success , Pending = 1 , WarningLevel = 20 ,
  UnexpectedResponseType = 21 , UnexpectedResponseTypeWarning = UnexpectedResponseType , Unprepared = 25 , Abandoned = 50 ,
  ErrorLevel = 100 , NetworkError = 101 , Timeout , Unauthorised ,
  ContentAccessError , NotFound , IncorrectRequest , IncorrectResponse ,
  TooManyRequests , RateLimited = TooManyRequests , RequestNotImplemented , UnsupportedRoomVersion ,
  NetworkAuthRequired , UserConsentRequired , CannotLeaveRoom , UserDeactivated ,
  FileError , UserDefinedError = 256
}
 
using duration_ms_t = std::chrono::milliseconds::rep
 
- Public Slots inherited from Quotient::BaseJob
void initiate (Quotient::ConnectionData *connData, bool inBackground)
 
void abandon ()
 Abandon the result of this job, arrived or unarrived. More...
 
- Signals inherited from Quotient::BaseJob
void aboutToSendRequest (QNetworkRequest *req)
 The job is about to send a network request. More...
 
void sentRequest ()
 
void statusChanged (Quotient::BaseJob::Status newStatus)
 
void retryScheduled (int nextAttempt, Quotient::BaseJob::duration_ms_t inMilliseconds)
 
void rateLimited ()
 
void finished (Quotient::BaseJob *job)
 
void result (Quotient::BaseJob *job)
 
void success (Quotient::BaseJob *)
 
void failure (Quotient::BaseJob *)
 
void downloadProgress (qint64 bytesReceived, qint64 bytesTotal)
 
void uploadProgress (qint64 bytesSent, qint64 bytesTotal)
 
- Static Public Member Functions inherited from Quotient::BaseJob
template<typename... StrTs>
static QByteArray makePath (StrTs &&... parts)
 
- Protected Types inherited from Quotient::BaseJob
using headers_t = QHash< QByteArray, QByteArray >
 
- Protected Slots inherited from Quotient::BaseJob
void timeout ()
 
virtual Status checkReply (const QNetworkReply *reply) const
 Check the pending or received reply for upfront issues. More...
 
- Static Protected Member Functions inherited from Quotient::BaseJob
static QUrl makeRequestUrl (QUrl baseUrl, const QByteArray &encodedPath, const QUrlQuery &query={})
 
- Properties inherited from Quotient::BaseJob
QUrl requestUrl
 
int maxRetries
 
int statusCode
 

Detailed Description

Definition at line 11 of file syncjob.h.

Constructor & Destructor Documentation

◆ SyncJob() [1/2]

Quotient::SyncJob::SyncJob ( const QString &  since = {},
const QString &  filter = {},
int  timeout = -1,
const QString &  presence = {} 
)
explicit

◆ SyncJob() [2/2]

Quotient::SyncJob::SyncJob ( const QString &  since,
const Filter filter,
int  timeout = -1,
const QString &  presence = {} 
)
explicit

Member Function Documentation

◆ prepareResult()

Status Quotient::SyncJob::prepareResult ( )
overrideprotectedvirtual

An extension point for additional reply processing.

The base implementation does nothing and returns Success.

See also
gotReply

Reimplemented from Quotient::BaseJob.

◆ takeData()

SyncData Quotient::SyncJob::takeData ( )
inline

Definition at line 18 of file syncjob.h.


The documentation for this class was generated from the following file: