1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
|
/******************************************************************************
* THIS FILE IS GENERATED - ANY EDITS WILL BE OVERWRITTEN
*/
#pragma once
#include "jobs/basejob.h"
#include "converters.h"
#include <QtCore/QIODevice>
namespace QMatrixClient
{
// Operations
/// Upload some content to the content repository.
class UploadContentJob : public BaseJob
{
public:
/*! Upload some content to the content repository.
* \param content
* \param filename
* The name of the file being uploaded
* \param contentType
* The content type of the file being uploaded
*/
explicit UploadContentJob(QIODevice* content, const QString& filename = {}, const QString& contentType = {});
~UploadContentJob() override;
// Result properties
/// The MXC URI to the uploaded content.
const QString& contentUri() const;
protected:
Status parseJson(const QJsonDocument& data) override;
private:
class Private;
QScopedPointer<Private> d;
};
/// Download content from the content repository.
class GetContentJob : public BaseJob
{
public:
/*! Download content from the content repository.
* \param serverName
* The server name from the ``mxc://`` URI (the authoritory component)
* \param mediaId
* The media ID from the ``mxc://`` URI (the path component)
* \param allowRemote
* Indicates to the server that it should not attempt to fetch the media if it is deemed
* remote. This is to prevent routing loops where the server contacts itself. Defaults to
* true if not provided.
*/
explicit GetContentJob(const QString& serverName, const QString& mediaId, bool allowRemote = true);
/*! Construct a URL without creating a full-fledged job object
*
* This function can be used when a URL for
* GetContentJob is necessary but the job
* itself isn't.
*/
static QUrl makeRequestUrl(QUrl baseUrl, const QString& serverName, const QString& mediaId, bool allowRemote = true);
~GetContentJob() override;
// Result properties
/// The content type of the file that was previously uploaded.
const QString& contentType() const;
/// The name of the file that was previously uploaded, if set.
const QString& contentDisposition() const;
/// The content that was previously uploaded.
QIODevice* data() const;
protected:
Status parseReply(QNetworkReply* reply) override;
private:
class Private;
QScopedPointer<Private> d;
};
/// Download content from the content repository as a given filename.
class GetContentOverrideNameJob : public BaseJob
{
public:
/*! Download content from the content repository as a given filename.
* \param serverName
* The server name from the ``mxc://`` URI (the authoritory component)
* \param mediaId
* The media ID from the ``mxc://`` URI (the path component)
* \param fileName
* The filename to give in the Content-Disposition
* \param allowRemote
* Indicates to the server that it should not attempt to fetch the media if it is deemed
* remote. This is to prevent routing loops where the server contacts itself. Defaults to
* true if not provided.
*/
explicit GetContentOverrideNameJob(const QString& serverName, const QString& mediaId, const QString& fileName, bool allowRemote = true);
/*! Construct a URL without creating a full-fledged job object
*
* This function can be used when a URL for
* GetContentOverrideNameJob is necessary but the job
* itself isn't.
*/
static QUrl makeRequestUrl(QUrl baseUrl, const QString& serverName, const QString& mediaId, const QString& fileName, bool allowRemote = true);
~GetContentOverrideNameJob() override;
// Result properties
/// The content type of the file that was previously uploaded.
const QString& contentType() const;
/// The name of file given in the request
const QString& contentDisposition() const;
/// The content that was previously uploaded.
QIODevice* data() const;
protected:
Status parseReply(QNetworkReply* reply) override;
private:
class Private;
QScopedPointer<Private> d;
};
/// Download a thumbnail of the content from the content repository.
class GetContentThumbnailJob : public BaseJob
{
public:
/*! Download a thumbnail of the content from the content repository.
* \param serverName
* The server name from the ``mxc://`` URI (the authoritory component)
* \param mediaId
* The media ID from the ``mxc://`` URI (the path component)
* \param width
* The *desired* width of the thumbnail. The actual thumbnail may not
* match the size specified.
* \param height
* The *desired* height of the thumbnail. The actual thumbnail may not
* match the size specified.
* \param method
* The desired resizing method.
* \param allowRemote
* Indicates to the server that it should not attempt to fetch the media if it is deemed
* remote. This is to prevent routing loops where the server contacts itself. Defaults to
* true if not provided.
*/
explicit GetContentThumbnailJob(const QString& serverName, const QString& mediaId, int width, int height, const QString& method = {}, bool allowRemote = true);
/*! Construct a URL without creating a full-fledged job object
*
* This function can be used when a URL for
* GetContentThumbnailJob is necessary but the job
* itself isn't.
*/
static QUrl makeRequestUrl(QUrl baseUrl, const QString& serverName, const QString& mediaId, int width, int height, const QString& method = {}, bool allowRemote = true);
~GetContentThumbnailJob() override;
// Result properties
/// The content type of the thumbnail.
const QString& contentType() const;
/// A thumbnail of the requested content.
QIODevice* data() const;
protected:
Status parseReply(QNetworkReply* reply) override;
private:
class Private;
QScopedPointer<Private> d;
};
/// Get information about a URL for a client
class GetUrlPreviewJob : public BaseJob
{
public:
/*! Get information about a URL for a client
* \param url
* The URL to get a preview of
* \param ts
* The preferred point in time to return a preview for. The server may
* return a newer version if it does not have the requested version
* available.
*/
explicit GetUrlPreviewJob(const QString& url, Omittable<qint64> ts = none);
/*! Construct a URL without creating a full-fledged job object
*
* This function can be used when a URL for
* GetUrlPreviewJob is necessary but the job
* itself isn't.
*/
static QUrl makeRequestUrl(QUrl baseUrl, const QString& url, Omittable<qint64> ts = none);
~GetUrlPreviewJob() override;
// Result properties
/// The byte-size of the image. Omitted if there is no image attached.
Omittable<qint64> matrixImageSize() const;
/// An MXC URI to the image. Omitted if there is no image.
const QString& ogImage() const;
protected:
Status parseJson(const QJsonDocument& data) override;
private:
class Private;
QScopedPointer<Private> d;
};
/// Get the configuration for the content repository.
///
/// This endpoint allows clients to retrieve the configuration of the content
/// repository, such as upload limitations.
/// Clients SHOULD use this as a guide when using content repository endpoints.
/// All values are intentionally left optional. Clients SHOULD follow
/// the advice given in the field description when the field is not available.
///
/// **NOTE:** Both clients and server administrators should be aware that proxies
/// between the client and the server may affect the apparent behaviour of content
/// repository APIs, for example, proxies may enforce a lower upload size limit
/// than is advertised by the server on this endpoint.
class GetConfigJob : public BaseJob
{
public:
explicit GetConfigJob();
/*! Construct a URL without creating a full-fledged job object
*
* This function can be used when a URL for
* GetConfigJob is necessary but the job
* itself isn't.
*/
static QUrl makeRequestUrl(QUrl baseUrl);
~GetConfigJob() override;
// Result properties
/// The maximum size an upload can be in bytes.
/// Clients SHOULD use this as a guide when uploading content.
/// If not listed or null, the size limit should be treated as unknown.
Omittable<qint64> uploadSize() const;
protected:
Status parseJson(const QJsonDocument& data) override;
private:
class Private;
QScopedPointer<Private> d;
};
} // namespace QMatrixClient
|
