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
|
/*
* Copyright (C) 2008-2010 The QXmpp developers
*
* Authors:
* Manjeet Dahiya
* Jeremy Lainé
*
* Source:
* http://code.google.com/p/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 QXMPPROSTERIQ_H
#define QXMPPROSTERIQ_H
#include "QXmppIq.h"
#include <QList>
#include <QSet>
/// \brief The QXmppRosterIq class represents a roster IQ.
///
/// \ingroup Stanzas
class QXmppRosterIq : public QXmppIq
{
public:
/// \brief The QXmppRosterIq::Item class represents a roster entry.
class Item
{
public:
/// An enumeration for type of subscription with the bareJid in the roster.
enum SubscriptionType
{
NotSet = 0,
None, ///< the user does not have a subscription to the
///< contact's presence information, and the contact does
///< not have a subscription to the user's presence information
Both, ///< both the user and the contact have subscriptions to each
///< other's presence information
From, ///< the contact has a subscription to the user's presence information,
///< but the user does not have a subscription to the contact's presence information
To, ///< the user has a subscription to the contact's presence information,
///< but the contact does not have a subscription to the user's presence information
Remove ///< to delete a roster item
};
QString bareJid() const;
QSet<QString> groups() const;
QString name() const;
QString subscriptionStatus() const;
SubscriptionType subscriptionType() const;
void setBareJid(const QString&);
void setGroups(const QSet<QString>&);
void setName(const QString&);
void setSubscriptionStatus(const QString&);
void setSubscriptionType(SubscriptionType);
/// \cond
void parse(const QDomElement &element);
void toXml(QXmlStreamWriter *writer) const;
// deprecated in release 0.2.0
// deprecated accessors, use the form without "get" instead
SubscriptionType Q_DECL_DEPRECATED getSubscriptionType() const;
QString Q_DECL_DEPRECATED getName() const;
QString Q_DECL_DEPRECATED getSubscriptionStatus() const;
QString Q_DECL_DEPRECATED getBareJid() const;
QSet<QString> Q_DECL_DEPRECATED getGroups() const;
/// \endcond
private:
QString getSubscriptionTypeStr() const;
void setSubscriptionTypeFromStr(const QString&);
QString m_bareJid;
SubscriptionType m_type;
QString m_name;
// can be subscribe/unsubscribe (attribute "ask")
QString m_subscriptionStatus;
QSet<QString> m_groups;
};
void addItem(const Item&);
QList<Item> items() const;
static bool isRosterIq(const QDomElement &element);
// deprecated in release 0.2.0
// deprecated accessors, use the form without "get" instead
/// \cond
QList<Item> Q_DECL_DEPRECATED getItems() const;
/// \endcond
protected:
/// \cond
void parseElementFromChild(const QDomElement &element);
void toXmlElementFromChild(QXmlStreamWriter *writer) const;
/// \endcond
private:
QList<Item> m_items;
};
#endif // QXMPPROSTERIQ_H
|
