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
|
/*
jabbercapabilitiesmanager.h - Manage entity capabilities(JEP-0115) pool.
Copyright (c) 2006 by Michaël Larouche <michael.larouche@kdemail.net>
Kopete (c) 2001-2006 by the Kopete developers <kopete-devel@kde.org>
Imported from caps.cpp from Psi:
Copyright (C) 2005 Remko Troncon
*************************************************************************
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
* *
*************************************************************************
*/
#ifndef JABBERCAPABILITIESMANAGER_H
#define JABBERCAPABILITIESMANAGER_H
#include <tqobject.h>
#include <im.h>
#include <xmpp.h>
using namespace XMPP;
class JabberAccount;
/**
* @brief Manage Jabber entity capabilities (JEP-0115)
* @author Michaël Larouche <michael.larouche@kdemail.net>
* @author Remko Troncon
*/
class JabberCapabilitiesManager : public TQObject
{
TQ_OBJECT
public:
/**
* Construct
*/
JabberCapabilitiesManager();
~JabberCapabilitiesManager();
/**
* Load cached information from local file.
*/
void loadCachedInformation();
/**
* Check if the jid support Entity capabitilies.
* @param jid JID to check.
* @return true if the jid support entity capabitilies.
*/
bool capabilitiesEnabled(const Jid& jid) const;
/**
* Remove account from manager.
*/
void removeAccount(JabberAccount *account);
/**
* Return the features supported for the JID.
*/
XMPP::Features features(const Jid& jid) const;
/**
* Return the client name for the current JID.
*/
TQString clientName(const Jid& jid) const;
/**
* Return the client version for the current JID.
*/
TQString clientVersion(const Jid& jid) const;
signals:
void capabilitiesChanged(const XMPP::Jid &jid);
public slots:
/**
* Update if necessary the capabities for the JID passed in args.
* Caps are received in Presence messages so that's why we are
* passing a XMPP::Status object.
*
* @param jid JID that capabilities was updated.
* @param status The XMPP::Status that contain the caps.
*/
void updateCapabilities(JabberAccount *account, const XMPP::Jid &jid, const XMPP::Status &status);
private slots:
/**
* @brief Called when a reply to disco#info request was received.
* If the result was succesful, the resulting features are recorded in the
* features database for the requested node, and all the affected jids are
* put in the queue for update notification.
* If the result was unsuccesful, another jid with the same capabilities is
* selected and sent a disco#info query.
*/
void discoRequestFinished();
private:
/**
* @brief Sends a disco#info request to a given node of a jid through an account.
* When the request is finished, the discoRequestFinished() slot is called.
*
* @param account The account through which to send the disco request.
* @param jid The target entity's JID
* @param node The target disco#info node
*/
void requestDiscoInfo(JabberAccount *account, const Jid& jid, const TQString& node);
/**
* Save capabilities information to disk.
*/
void saveInformation();
class Capabilities;
typedef TQValueList<Capabilities> CapabilitiesList;
/**
* @brief A class representing an entity capability specification.
* An entity capability is a combination of a node, a version, and a set of
* extensions.
*/
class Capabilities
{
public:
/**
* Default constructor.
*/
Capabilities();
/**
* Define capabilities.
* @param node the node
* @param version the version
* @param extensions the list of extensions (separated by spaces)
*/
Capabilities(const TQString &node, const TQString &version, const TQString &extensions);
/**
* Returns the node of the capabilities specification.
*/
const TQString& node() const;
/**
* @brief Returns the version of the capabilities specification.
*/
const TQString& version() const;
/**
* @brief Returns the extensions of the capabilities specification.
*/
const TQString& extensions() const;
/**
* \brief Flattens the caps specification into the set of 'simple' specifications.
* A 'simple' specification is a specification with exactly one extension,
* or with the version number as the extension.
*
* Example: A caps specification with node=http://psi-im.org, version=0.10,
* and ext='achat vchat' would be expanded into the following list of specs:
* node=http://psi-im.org, ver=0.10, ext=0.10
* node=http://psi-im.org, ver=0.10, ext=achat
* node=http://psi-im.org, ver=0.10, ext=vchat
*/
CapabilitiesList flatten() const;
bool operator==(const Capabilities&) const;
bool operator!=(const Capabilities&) const;
bool operator<(const Capabilities&) const;
private:
TQString m_node, m_version, m_extensions;
};
class CapabilitiesInformation
{
public:
CapabilitiesInformation();
const TQStringList& features() const;
const DiscoItem::Identities& identities() const;
TQStringList jids() const;
bool discovered() const;
int pendingRequests() const;
void reset();
void removeAccount(JabberAccount* acc);
void removeJid(const Jid&);
void addJid(const Jid&, JabberAccount*);
TQPair<Jid,JabberAccount*> nextJid(const Jid&, const Task*);
void setDiscovered(bool);
void setPendingRequests(int);
void setIdentities(const DiscoItem::Identities&);
void setFeatures(const TQStringList&);
TQDomElement toXml(TQDomDocument *) const;
void fromXml(const TQDomElement&);
protected:
void updateLastSeen();
private:
bool m_discovered;
int m_pendingRequests;
TQStringList m_features;
DiscoItem::Identities m_identities;
TQValueList<TQPair<TQString,JabberAccount*> > m_jids;
TQDate m_lastSeen;
};
class Private;
Private *d;
};
#endif
|
