blob: eb697a0f457c46c8de2d83cdb56b355684acaca2 (
plain) (
blame)
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
|
/*
* Copyright (C) 2008-2021 The QXmpp developers
*
* Author:
* Jeremy Lainé
* Linus Jahn
*
* Source:
* https://github.com/qxmpp-project/qxmpp
*
* This file is a part of QXmpp library.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
*/
#ifndef QXMPPPUBSUBITEM_H
#define QXMPPPUBSUBITEM_H
#include "QXmppGlobal.h"
#include <QDomElement>
#include <QMetaType>
#include <QSharedDataPointer>
class QXmlStreamWriter;
class QXmppPubSubItemPrivate;
class QXMPP_EXPORT QXmppPubSubItem
{
public:
QXmppPubSubItem(const QString &id = {}, const QString &publisher = {});
QXmppPubSubItem(const QXmppPubSubItem &);
virtual ~QXmppPubSubItem();
QXmppPubSubItem &operator=(const QXmppPubSubItem &);
QString id() const;
void setId(const QString &id);
QString publisher() const;
void setPublisher(const QString &publisher);
/// \cond
void parse(const QDomElement &element);
void toXml(QXmlStreamWriter *writer) const;
/// \endcond
static bool isItem(const QDomElement &element);
protected:
virtual void parsePayload(const QDomElement &payloadElement);
virtual void serializePayload(QXmlStreamWriter *writer) const;
template<typename PayloadChecker>
static bool isItem(const QDomElement &element, PayloadChecker isPayloadValid);
private:
QSharedDataPointer<QXmppPubSubItemPrivate> d;
};
///
/// Returns true, if the element is a valid PubSub item and (if existant) the
/// payload is correct.
///
/// \param element The element to be checked to be an <item/> element.
/// \param isPayloadValid A function that validates the payload element (first
/// child element). The functions needs to return true, if the payload is valid.
/// In case there is no payload, the function is not called.
///
/// Here is an example covering how this could be used to check for the
/// \xep{0118, User Tune} payload:
/// \code
/// auto isPayloadValid = [](const QDomElement &payload) -> bool {
/// return payload.tagName() == "tune" && payload.namespaceURI() == ns_tune;
/// };
///
/// bool valid = QXmppPubSubItem::isItem(itemElement, isPayloadValid);
/// \endcode
///
template<typename PayloadChecker>
bool QXmppPubSubItem::isItem(const QDomElement &element, PayloadChecker isPayloadValid)
{
if (!isItem(element)) {
return false;
}
const QDomElement payload = element.firstChildElement();
// we can only check the payload if it's existant
if (!payload.isNull()) {
return isPayloadValid(payload);
}
return true;
}
Q_DECLARE_METATYPE(QXmppPubSubItem)
#endif // QXMPPPUBSUBITEM_H
|
