aboutsummaryrefslogtreecommitdiff
path: root/lib/application-service/definitions/protocol.h
diff options
context:
space:
mode:
authorn-peugnet <n.peugnet@free.fr>2022-10-06 19:27:24 +0200
committern-peugnet <n.peugnet@free.fr>2022-10-06 19:27:24 +0200
commitd911b207f49e936b3e992200796110f0749ed150 (patch)
tree96d20ebb4d074a4c1755e21cb316a52d584daee3 /lib/application-service/definitions/protocol.h
parent8ad8a74152c5701b6ca1f9a00487ba9257a439b4 (diff)
parent56c2f2e2b809b9077393eb617828f33d144f5634 (diff)
downloadlibquotient-d911b207f49e936b3e992200796110f0749ed150.tar.gz
libquotient-d911b207f49e936b3e992200796110f0749ed150.zip
New upstream version 0.7.0
Diffstat (limited to 'lib/application-service/definitions/protocol.h')
-rw-r--r--lib/application-service/definitions/protocol.h166
1 files changed, 97 insertions, 69 deletions
diff --git a/lib/application-service/definitions/protocol.h b/lib/application-service/definitions/protocol.h
index 2aca7d66..213dbf19 100644
--- a/lib/application-service/definitions/protocol.h
+++ b/lib/application-service/definitions/protocol.h
@@ -6,84 +6,112 @@
#include "converters.h"
-#include <QtCore/QHash>
-#include <QtCore/QJsonObject>
-#include "converters.h"
-#include <QtCore/QVector>
+namespace Quotient {
+/// Definition of valid values for a field.
+struct FieldType {
+ /// A regular expression for validation of a field's value. This may be
+ /// relatively coarse to verify the value as the application service
+ /// providing this protocol may apply additional validation or filtering.
+ QString regexp;
-namespace QMatrixClient
-{
- // Data structures
+ /// An placeholder serving as a valid example of the field value.
+ QString placeholder;
+};
- /// Definition of valid values for a field.
- struct FieldType
+template <>
+struct JsonObjectConverter<FieldType> {
+ static void dumpTo(QJsonObject& jo, const FieldType& pod)
+ {
+ addParam<>(jo, QStringLiteral("regexp"), pod.regexp);
+ addParam<>(jo, QStringLiteral("placeholder"), pod.placeholder);
+ }
+ static void fillFrom(const QJsonObject& jo, FieldType& pod)
{
- /// A regular expression for validation of a field's value. This may be relatively
- /// coarse to verify the value as the application service providing this protocol
- /// may apply additional validation or filtering.
- QString regexp;
- /// An placeholder serving as a valid example of the field value.
- QString placeholder;
- };
+ fromJson(jo.value("regexp"_ls), pod.regexp);
+ fromJson(jo.value("placeholder"_ls), pod.placeholder);
+ }
+};
- QJsonObject toJson(const FieldType& pod);
+struct ProtocolInstance {
+ /// A human-readable description for the protocol, such as the name.
+ QString desc;
- template <> struct FromJsonObject<FieldType>
- {
- FieldType operator()(const QJsonObject& jo) const;
- };
+ /// An optional content URI representing the protocol. Overrides the one
+ /// provided at the higher level Protocol object.
+ QString icon;
+
+ /// Preset values for `fields` the client may use to search by.
+ QJsonObject fields;
+
+ /// A unique identifier across all instances.
+ QString networkId;
+};
- struct ProtocolInstance
+template <>
+struct JsonObjectConverter<ProtocolInstance> {
+ static void dumpTo(QJsonObject& jo, const ProtocolInstance& pod)
{
- /// A human-readable description for the protocol, such as the name.
- QString desc;
- /// An optional content URI representing the protocol. Overrides the one provided
- /// at the higher level Protocol object.
- QString icon;
- /// Preset values for ``fields`` the client may use to search by.
- QJsonObject fields;
- /// A unique identifier across all instances.
- QString networkId;
- };
-
- QJsonObject toJson(const ProtocolInstance& pod);
-
- template <> struct FromJsonObject<ProtocolInstance>
+ addParam<>(jo, QStringLiteral("desc"), pod.desc);
+ addParam<IfNotEmpty>(jo, QStringLiteral("icon"), pod.icon);
+ addParam<>(jo, QStringLiteral("fields"), pod.fields);
+ addParam<>(jo, QStringLiteral("network_id"), pod.networkId);
+ }
+ static void fillFrom(const QJsonObject& jo, ProtocolInstance& pod)
{
- ProtocolInstance operator()(const QJsonObject& jo) const;
- };
+ fromJson(jo.value("desc"_ls), pod.desc);
+ fromJson(jo.value("icon"_ls), pod.icon);
+ fromJson(jo.value("fields"_ls), pod.fields);
+ fromJson(jo.value("network_id"_ls), pod.networkId);
+ }
+};
+
+struct ThirdPartyProtocol {
+ /// Fields which may be used to identify a third party user. These should be
+ /// ordered to suggest the way that entities may be grouped, where higher
+ /// groupings are ordered first. For example, the name of a network should
+ /// be searched before the nickname of a user.
+ QStringList userFields;
+
+ /// Fields which may be used to identify a third party location. These
+ /// should be ordered to suggest the way that entities may be grouped, where
+ /// higher groupings are ordered first. For example, the name of a network
+ /// should be searched before the name of a channel.
+ QStringList locationFields;
+
+ /// A content URI representing an icon for the third party protocol.
+ QString icon;
+
+ /// The type definitions for the fields defined in the `user_fields` and
+ /// `location_fields`. Each entry in those arrays MUST have an entry here.
+ /// The `string` key for this object is field name itself.
+ ///
+ /// May be an empty object if no fields are defined.
+ QHash<QString, FieldType> fieldTypes;
+
+ /// A list of objects representing independent instances of configuration.
+ /// For example, multiple networks on IRC if multiple are provided by the
+ /// same application service.
+ QVector<ProtocolInstance> instances;
+};
- struct ThirdPartyProtocol
+template <>
+struct JsonObjectConverter<ThirdPartyProtocol> {
+ static void dumpTo(QJsonObject& jo, const ThirdPartyProtocol& pod)
{
- /// Fields which may be used to identify a third party user. These should be
- /// ordered to suggest the way that entities may be grouped, where higher
- /// groupings are ordered first. For example, the name of a network should be
- /// searched before the nickname of a user.
- QStringList userFields;
- /// Fields which may be used to identify a third party location. These should be
- /// ordered to suggest the way that entities may be grouped, where higher
- /// groupings are ordered first. For example, the name of a network should be
- /// searched before the name of a channel.
- QStringList locationFields;
- /// A content URI representing an icon for the third party protocol.
- QString icon;
- /// The type definitions for the fields defined in the ``user_fields`` and
- /// ``location_fields``. Each entry in those arrays MUST have an entry here. The
- /// ``string`` key for this object is field name itself.
- ///
- /// May be an empty object if no fields are defined.
- QHash<QString, FieldType> fieldTypes;
- /// A list of objects representing independent instances of configuration.
- /// For example, multiple networks on IRC if multiple are provided by the
- /// same application service.
- QVector<ProtocolInstance> instances;
- };
-
- QJsonObject toJson(const ThirdPartyProtocol& pod);
-
- template <> struct FromJsonObject<ThirdPartyProtocol>
+ addParam<>(jo, QStringLiteral("user_fields"), pod.userFields);
+ addParam<>(jo, QStringLiteral("location_fields"), pod.locationFields);
+ addParam<>(jo, QStringLiteral("icon"), pod.icon);
+ addParam<>(jo, QStringLiteral("field_types"), pod.fieldTypes);
+ addParam<>(jo, QStringLiteral("instances"), pod.instances);
+ }
+ static void fillFrom(const QJsonObject& jo, ThirdPartyProtocol& pod)
{
- ThirdPartyProtocol operator()(const QJsonObject& jo) const;
- };
+ fromJson(jo.value("user_fields"_ls), pod.userFields);
+ fromJson(jo.value("location_fields"_ls), pod.locationFields);
+ fromJson(jo.value("icon"_ls), pod.icon);
+ fromJson(jo.value("field_types"_ls), pod.fieldTypes);
+ fromJson(jo.value("instances"_ls), pod.instances);
+ }
+};
-} // namespace QMatrixClient
+} // namespace Quotient