blob: 22fc636f8be698c77a96578471905ab0217aff1f (
plain)
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
|
/*
* Copyright (c) 2010 Remko Tronçon
* Licensed under the GNU General Public License v3.
* See Documentation/Licenses/GPLv3.txt for more information.
*/
#pragma once
#include "Swiften/Client/CoreClient.h"
namespace Swift {
class SoftwareVersionResponder;
class XMPPRoster;
class XMPPRosterImpl;
class XMPPRosterController;
class PresenceOracle;
class PresenceSender;
class MUCRegistry;
class Storages;
class MemoryStorages;
class VCardManager;
/**
* Provides the core functionality for writing XMPP client software.
*
* Besides connecting to an XMPP server, this class also provides interfaces for
* performing most tasks on the XMPP network.
*
* \param storages The interfaces for storing cache information etc. If this is NULL,
* all data will be stored in memory (and be lost on shutdown)
*/
class Client : public CoreClient {
public:
Client(const JID& jid, const String& password, Storages* storages = NULL);
~Client();
/**
* Sets the software version of the client.
*
* This will be used to respond to version queries from other entities.
*/
void setSoftwareVersion(const String& name, const String& version);
/**
* Returns a representation of the roster.
*
* The roster is initially empty. To populate it, call requestRoster(), which
* will request the roster from the server. When the roster has been requested,
* it will also be kept up to date when it is updated on the server side.
*
* This pointer remains the same across the lifetime of Client. All changes
* to the roster (e.g. after the initial roster request, or after subsequent
* roster updates) are notified through the XMPPRoster's signals.
*
* \see requestRoster()
*/
XMPPRoster* getRoster() const;
/**
* Requests the roster from the server.
*
* \see getRoster()
*/
void requestRoster();
/**
* Returns the last received presence for the given (full) JID.
*/
Presence::ref getLastPresence(const JID& jid) const;
/**
* Returns the presence with the highest priority received for the given JID.
*/
Presence::ref getHighestPriorityPresence(const JID& bareJID) const;
PresenceOracle* getPresenceOracle() const {
return presenceOracle;
}
PresenceSender* getPresenceSender() const {
return presenceSender;
}
MUCRegistry* getMUCRegistry() const {
return mucRegistry;
}
VCardManager* getVCardManager() const {
return vcardManager;
}
public:
/**
* This signal is emitted when a JID changes presence.
*/
boost::signal<void (boost::shared_ptr<Presence>)> onPresenceChange;
/**
* This signal is emitted when a presence subscription request is received.
*/
boost::signal<void (const JID&, const String&)> onPresenceSubscriptionRequest;
private:
Storages* getStorages() const;
private:
Storages* storages;
MemoryStorages* memoryStorages;
SoftwareVersionResponder* softwareVersionResponder;
XMPPRosterImpl* roster;
XMPPRosterController* rosterController;
PresenceOracle* presenceOracle;
PresenceSender* presenceSender;
MUCRegistry* mucRegistry;
VCardManager* vcardManager;
};
}
|
Swift