Download a thumbnail of content from the content repository. More...

#include <authed-content-repo.h>

Inheritance diagram for Quotient::GetContentThumbnailAuthedJob:

Collaboration diagram for Quotient::GetContentThumbnailAuthedJob:

Public Member Functions
	GetContentThumbnailAuthedJob (const QString &serverName, const QString &mediaId, int width, int height, const QString &method={}, qint64 timeoutMs=20000, std::optional< bool > animated=std::nullopt)

QString	contentDisposition () const

QString	contentType () const
	The content type of the thumbnail. More...

QIODevice *	data ()
	A thumbnail of the requested content. More...

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
	Current status of the job. More...

QString	statusCaption () const
	Short human-friendly message on the job status. More...

QByteArray	rawData (int bytesAtMost) const
	Get first bytes of the raw response body as received from the server. More...

const QByteArray &	rawData () const
	Access the whole response body as received from the server. More...

QString	rawDataSample (int bytesAtMost=65535) const
	Get UI-friendly sample of raw data. More...

QJsonObject	jsonData () const
	Get the response body as a JSON object. More...

QJsonArray	jsonItems () const
	Get the response body as a JSON array. More...

template<typename T >
T	loadFromJson (auto keyName, T &&defaultValue={}) const
	Load the property from the JSON response assuming a given C++ type. More...

template<typename T >
T	takeFromJson (auto key, T &&defaultValue={})
	Load the property from the JSON response and delete it from JSON. More...

int	error () const
	Error (more generally, status) code. More...

virtual QString	errorString () const
	Error-specific message, as returned by the server. More...

QUrl	errorUrl () const
	A URL to help/clarify the error, if provided by the server. More...

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

Static Public Member Functions
static QUrl	makeRequestUrl (const HomeserverData &hsData, const QString &serverName, const QString &mediaId, int width, int height, const QString &method={}, qint64 timeoutMs=20000, std::optional< bool > animated=std::nullopt)
	Construct a URL without creating a full-fledged job object. More...

Static Public Member Functions inherited from Quotient::BaseJob
template<typename... StrTs>
static QByteArray	makePath (QByteArrayView base, StrTs &&... parts)

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 , AccountLocked , UserDefinedError = 256 }
	Job status codes. More...

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 ()
	The job has sent a network request. More...

void	statusChanged (Quotient::BaseJob::Status newStatus)
	The job has changed its status. More...

void	retryScheduled (int nextAttempt, Quotient::BaseJob::duration_ms_t inMilliseconds)
	A retry of the network request is scheduled after the previous request failed. More...

void	rateLimited ()
	The job has been rate-limited. More...

void	finished (Quotient::BaseJob *job)
	The job has finished - either with a result, or abandoned. More...

void	result (Quotient::BaseJob *job)
	The job has finished with a result, successful or unsuccessful. More...

void	success (Quotient::BaseJob *)
	The job has finished with a successful result. More...

void	failure (Quotient::BaseJob *)
	The job has finished with a failure result Emitted together with result() when the job resulted in an error. Mutually exclusive with success(): after result() is emitted, exactly one of success() and failure() will be emitted next. Will not be emitted in case of abandon()ing. More...

void	downloadProgress (qint64 bytesReceived, qint64 bytesTotal)

void	uploadProgress (qint64 bytesSent, qint64 bytesTotal)

Protected Types inherited from Quotient::BaseJob
using	headers_t = QHash< QByteArray, QByteArray >

Protected Slots inherited from Quotient::BaseJob
void	timeout ()

Protected Member Functions inherited from Quotient::BaseJob
QByteArray	apiEndpoint () const

void	setApiEndpoint (QByteArray apiEndpoint)

const headers_t &	requestHeaders () 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 RequestData &	requestData () const

void	setRequestData (RequestData &&data)

const QByteArrayList &	expectedContentTypes () const

void	addExpectedContentType (const QByteArray &contentType)

void	setExpectedContentTypes (const QByteArrayList &contentTypes)

QStringList	expectedKeys () const

void	addExpectedKey (QString key)

void	setExpectedKeys (const QStringList &keys)

const QNetworkReply *	reply () const

QNetworkReply *	reply ()

virtual void	doPrepare (const ConnectionData *)
	Prepare the job for execution. More...

virtual void	onSentRequest (QNetworkReply *)
	Postprocessing after the network request has been sent. More...

virtual void	beforeAbandon ()

virtual Status	checkReply (const QNetworkReply *reply) const
	Check the pending or received reply for upfront issues. More...

virtual Status	prepareResult ()
	An extension point for additional reply processing. More...

virtual Status	prepareError (Status currentStatus)
	Process details of the error. More...

QJsonValue	takeValueFromJson (QAnyStringView key)
	Retrieve a value for one specific key and delete it from the JSON response object. More...

void	setStatus (Status s)

void	setStatus (int code, QString message)

void	forceResult (QJsonDocument resultDoc, Status s={ Success })
	Force completion of the job for sake of testing. More...

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 (const HomeserverData &hsData, const QByteArray &encodedPath, const QUrlQuery &query={})
	Construct a URL out of baseUrl, path and query. More...

Properties inherited from Quotient::BaseJob
QUrl	requestUrl

int	maxRetries

int	statusCode

Detailed Description

Download a thumbnail of content from the content repository.

Download a thumbnail of content from the content repository. See the Thumbnails section for more information.

Note: Clients SHOULD NOT generate or use URLs which supply the access token in the query string. These URLs may be copied by users verbatim and provided in a chat message to another user, disclosing the sender's access token.

Clients MAY be redirected using the 307/308 responses below to download the request object. This is typical when the homeserver uses a Content Delivery Network (CDN).

Definition at line 187 of file authed-content-repo.h.

Constructor & Destructor Documentation

◆ GetContentThumbnailAuthedJob()

Quotient::GetContentThumbnailAuthedJob::GetContentThumbnailAuthedJob	(	const QString &	serverName,
		const QString &	mediaId,
		int	width,
		int	height,
		const QString &	method = `{}`,
		qint64	timeoutMs = `20000`,
		std::optional< bool >	animated = `std::nullopt`
	)

explicit

Parameters

serverName	The server name from the `mxc://` URI (the authority component).
mediaId	The media ID from the `mxc://` URI (the path component).
width	The desired width of the thumbnail. The actual thumbnail may be larger than the size specified.
height	The desired height of the thumbnail. The actual thumbnail may be larger than the size specified.
method	The desired resizing method. See the Thumbnails section for more information.
timeoutMs	The maximum number of milliseconds that the client is willing to wait to start receiving data, in the case that the content has not yet been uploaded. The default value is 20000 (20 seconds). The content repository SHOULD impose a maximum value for this parameter. The content repository MAY respond before the timeout.
animated	Indicates preference for an animated thumbnail from the server, if possible. Animated thumbnails typically use the content types `image/gif`, `image/png` (with APNG format), `image/apng`, and `image/webp` instead of the common static `image/png` or `image/jpeg` content types.

When true, the server SHOULD return an animated thumbnail if possible and supported. When false, the server MUST NOT return an animated thumbnail. For example, returning a static image/png or image/jpeg thumbnail. When not provided, the server SHOULD NOT return an animated thumbnail.

Servers SHOULD prefer to return image/webp thumbnails when supporting animation.

When true and the media cannot be animated, such as in the case of a JPEG or PDF, the server SHOULD behave as though animated is false.

Member Function Documentation

◆ contentDisposition()

QString Quotient::GetContentThumbnailAuthedJob::contentDisposition ( ) const

inline

The disposition of the returned content. MUST be inline, and SHOULD contain a file name (e.g. thumbnail.png).

Servers should note the Content-Type restrictions for serving inline content, as these limitations imply which formats should be used for thumbnail generation.

Definition at line 253 of file authed-content-repo.h.

◆ contentType()

QString Quotient::GetContentThumbnailAuthedJob::contentType ( ) const

inline

The content type of the thumbnail.

Definition at line 259 of file authed-content-repo.h.

◆ data()

QIODevice* Quotient::GetContentThumbnailAuthedJob::data ( )

inline

A thumbnail of the requested content.

Definition at line 262 of file authed-content-repo.h.

◆ makeRequestUrl()

static QUrl Quotient::GetContentThumbnailAuthedJob::makeRequestUrl	(	const HomeserverData &	hsData,
		const QString &	serverName,
		const QString &	mediaId,
		int	width,
		int	height,
		const QString &	method = `{}`,
		qint64	timeoutMs = `20000`,
		std::optional< bool >	animated = `std::nullopt`
	)

static

Construct a URL without creating a full-fledged job object.

This function can be used when a URL for GetContentThumbnailAuthedJob is necessary but the job itself isn't.

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

Quotient/csapi/authed-content-repo.h

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ GetContentThumbnailAuthedJob()

Member Function Documentation

◆ contentDisposition()

◆ contentType()

◆ data()

◆ makeRequestUrl()