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

Download device identity keys. More...

#include <keys.h>

Inheritance diagram for Quotient::QueryKeysJob:
Collaboration diagram for Quotient::QueryKeysJob:

Classes

struct  DeviceInformation
 
struct  UnsignedDeviceInfo
 

Public Member Functions

 QueryKeysJob (const QHash< QString, QStringList > &deviceKeys, std::optional< int > timeout=std::nullopt)
 
QHash< QString, QJsonObject > failures () const
 
QHash< QString, QHash< QString, DeviceInformation > > deviceKeys () const
 
QHash< QString, CrossSigningKeymasterKeys () const
 
QHash< QString, CrossSigningKeyselfSigningKeys () const
 
QHash< QString, CrossSigningKeyuserSigningKeys () const
 
- 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
 

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...
 
- 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 prepareResult ()
 An extension point for additional reply processing. More...
 
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
 
- 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

Download device identity keys.

Returns the current devices and identity keys for the given users.

Definition at line 64 of file keys.h.

Constructor & Destructor Documentation

◆ QueryKeysJob()

Quotient::QueryKeysJob::QueryKeysJob ( const QHash< QString, QStringList > &  deviceKeys,
std::optional< int >  timeout = std::nullopt 
)
explicit
Parameters
deviceKeysThe keys to be downloaded. A map from user ID, to a list of device IDs, or to an empty list to indicate all devices for the corresponding user.
timeoutThe time (in milliseconds) to wait when downloading keys from remote servers. 10 seconds is the recommended default.

Member Function Documentation

◆ deviceKeys()

QHash<QString, QHash<QString, DeviceInformation> > Quotient::QueryKeysJob::deviceKeys ( ) const
inline

Information on the queried devices. A map from user ID, to a map from device ID to device information. For each device, the information returned will be the same as uploaded via /keys/upload, with the addition of an unsigned property.

Definition at line 115 of file keys.h.

◆ failures()

QHash<QString, QJsonObject> Quotient::QueryKeysJob::failures ( ) const
inline

If any remote homeservers could not be reached, they are recorded here. The names of the properties are the names of the unreachable servers.

If the homeserver could be reached, but the user or device was unknown, no failure is recorded. Instead, the corresponding user or device is missing from the device_keys result.

Definition at line 105 of file keys.h.

◆ masterKeys()

QHash<QString, CrossSigningKey> Quotient::QueryKeysJob::masterKeys ( ) const
inline

Information on the master cross-signing keys of the queried users. A map from user ID, to master key information. For each key, the information returned will be the same as uploaded via /keys/device_signing/upload, along with the signatures uploaded via /keys/signatures/upload that the requesting user is allowed to see.

Definition at line 126 of file keys.h.

◆ selfSigningKeys()

QHash<QString, CrossSigningKey> Quotient::QueryKeysJob::selfSigningKeys ( ) const
inline

Information on the self-signing keys of the queried users. A map from user ID, to self-signing key information. For each key, the information returned will be the same as uploaded via /keys/device_signing/upload.

Definition at line 135 of file keys.h.

◆ userSigningKeys()

QHash<QString, CrossSigningKey> Quotient::QueryKeysJob::userSigningKeys ( ) const
inline

Information on the user-signing key of the user making the request, if they queried their own device information. A map from user ID, to user-signing key information. The information returned will be the same as uploaded via /keys/device_signing/upload.

Definition at line 145 of file keys.h.


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