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
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
|
/*
* 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/Base/boost_bsignals.h"
#include <boost/shared_ptr.hpp>
#include "Swiften/Network/PlatformDomainNameResolver.h"
#include "Swiften/Network/Connector.h"
#include "Swiften/Base/Error.h"
#include "Swiften/Client/ClientSession.h"
#include "Swiften/Client/ClientError.h"
#include "Swiften/Elements/Presence.h"
#include "Swiften/Elements/Message.h"
#include "Swiften/JID/JID.h"
#include "Swiften/Base/String.h"
#include "Swiften/Client/StanzaChannel.h"
#include "Swiften/Parser/PayloadParsers/FullPayloadParserFactoryCollection.h"
#include "Swiften/Serializer/PayloadSerializers/FullPayloadSerializerCollection.h"
#include "Swiften/Client/ClientSessionStanzaChannel.h"
namespace Swift {
class IQRouter;
class TLSContextFactory;
class ConnectionFactory;
class TimerFactory;
class ClientSession;
class BasicSessionStream;
class EventLoop;
class SecurityError;
/**
* The central class for communicating with an XMPP server.
*
* This class is responsible for setting up the connection with the XMPP
* server, authenticating, and initializing the session.
*
* This class can be used directly in your application, although the Client
* subclass provides more functionality and interfaces, and is better suited
* for most needs.
*/
class CoreClient {
public:
/**
* Constructs a client for the given JID with the given password.
* The given eventLoop will be used to post events to.
*/
CoreClient(EventLoop* eventLoop, const JID& jid, const String& password);
~CoreClient();
void setCertificate(const String& certificate);
/**
* Connects the client to the server.
*
* After the connection is established, the client will set
* initialize the stream and authenticate.
*/
void connect();
/**
* Disconnects the client from the server.
*/
void disconnect();
void connect(const JID& jid);
void connect(const String& host);
/**
* Instructs the client to continue initializing the session
* after a security error has occurred (and as such ignoring the error)
*
* \see onSecurityError
*/
void continueAfterSecurityError();
/**
* Sends a message.
*/
void sendMessage(Message::ref);
/**
* Sends a presence stanza.
*/
void sendPresence(Presence::ref);
/**
* Returns the IQ router for this client.
*/
IQRouter* getIQRouter() const {
return iqRouter_;
}
/**
* Checks whether the client is connected to the server,
* and stanzas can be sent.
*/
bool isAvailable() const {
return stanzaChannel_->isAvailable();
}
/**
* Checks whether the client is active.
*
* A client is active when it is connected or connecting to the server.
*/
bool isActive() const;
/**
* Returns the JID of the client.
* After the session was initialized, this returns the bound JID.
*/
const JID& getJID() const {
if (session_) {
return session_->getLocalJID();
}
else {
return jid_;
}
}
/**
* Checks whether stream management is enabled.
*
* If stream management is enabled, onStanzaAcked will be
* emitted when a stanza is received by the server.
*
* \see onStanzaAcked
*/
bool getStreamManagementEnabled() const {
return stanzaChannel_->getStreamManagementEnabled();
}
StanzaChannel* getStanzaChannel() const {
return stanzaChannel_;
}
/**
* Sets whether security errors should be ignored or not.
*
* If this is set to 'true', onSecurityError will not be called when a security
* error occurs, and connecting will continue.
*
* Defaults to true.
*/
void setIgnoreSecurityErrors(bool b) {
ignoreSecurityErrors = b;
}
public:
/**
* Emitted when an error occurred while establishing a secure connection.
*
* If the error is to be ignored, call continueAfterSecurityError(), otherwise call
* finish().
* This signal is not emitted when setIgnoreSecurityErrors() is set to true.
*/
boost::signal<void (const SecurityError&)> onSecurityError;
/**
* Emitted when the client was disconnected from the network.
*
* If the connection was due to a non-recoverable error, the type
* of error will be passed as a parameter.
*/
boost::signal<void (const boost::optional<ClientError>&)> onDisconnected;
/**
* Emitted when the client is connected and authenticated,
* and stanzas can be sent.
*/
boost::signal<void ()> onConnected;
/**
* Emitted when the client receives data.
*
* This signal is emitted before the XML data is parsed,
* so this data is unformatted.
*/
boost::signal<void (const String&)> onDataRead;
/**
* Emitted when the client sends data.
*
* This signal is emitted after the XML was serialized, and
* is unformatted.
*/
boost::signal<void (const String&)> onDataWritten;
/**
* Emitted when a message is received.
*/
boost::signal<void (Message::ref)> onMessageReceived;
/**
* Emitted when a presence stanza is received.
*/
boost::signal<void (Presence::ref) > onPresenceReceived;
/**
* Emitted when the server acknowledges receipt of a
* stanza (if acknowledgements are available).
*
* \see getStreamManagementEnabled()
*/
boost::signal<void (Stanza::ref)> onStanzaAcked;
private:
void handleConnectorFinished(boost::shared_ptr<Connection>);
void handleStanzaChannelAvailableChanged(bool available);
void handleSessionFinished(boost::shared_ptr<Error>);
void handleNeedCredentials();
void handleDataRead(const String&);
void handleDataWritten(const String&);
void handleSecurityError(const SecurityError& securityError);
private:
PlatformDomainNameResolver resolver_;
JID jid_;
String password_;
EventLoop* eventLoop;
ClientSessionStanzaChannel* stanzaChannel_;
IQRouter* iqRouter_;
Connector::ref connector_;
ConnectionFactory* connectionFactory_;
TimerFactory* timerFactory_;
TLSContextFactory* tlsContextFactory_;
FullPayloadParserFactoryCollection payloadParserFactories_;
FullPayloadSerializerCollection payloadSerializers_;
boost::shared_ptr<Connection> connection_;
boost::shared_ptr<BasicSessionStream> sessionStream_;
boost::shared_ptr<ClientSession> session_;
String certificate_;
bool disconnectRequested_;
bool ignoreSecurityErrors;
};
}
|