ClientBase Class Reference

This is the common base class for a Jabber/XMPP Client and a Jabber Component. More...

#include <clientbase.h>

Inherits gloox::TagHandler, gloox::ConnectionDataHandler, gloox::CompressionDataHandler, gloox::TLSHandler, and gloox::IqHandler.

Inherited by Client, and Component.

List of all members.

Public Member Functions

 ClientBase (const std::string &ns, const std::string &server, int port=-1)
 ClientBase (const std::string &ns, const std::string &password, const std::string &server, int port=-1)
virtual ~ClientBase ()
bool connect (bool block=true)
ConnectionError recv (int timeout=-1)
virtual const std::string & username () const
const JIDjid ()
void setSasl (bool sasl)
void setTls (TLSPolicy tls)
void setCompression (bool compression)
void setPort (int port)
void setServer (const std::string &server)
void setPassword (const std::string &password)
const std::string & server () const
bool sasl () const
TLSPolicy tls () const
bool compression () const
int port () const
virtual const std::string & password () const
virtual Discodisco () const
const std::string getID ()
void send (Tag *tag)
void send (IQ &iq, IqHandler *ih, int context, bool del=false)
void send (const IQ &iq)
void send (const Message &msg)
void send (const Subscription &sub)
void send (Presence &pres)
bool authed () const
ConnectionState state () const
const std::string & xmlLang () const
void setXmlLang (const std::string &xmllang)
ConnectionBaseconnectionImpl () const
void setConnectionImpl (ConnectionBase *cb)
TLSBaseencryptionImpl () const
void setEncryptionImpl (TLSBase *tb)
CompressionBasecompressionImpl () const
void setCompressionImpl (CompressionBase *cb)
void whitespacePing ()
void xmppPing (const JID &to, EventHandler *eh)
void setAuthzid (const JID &authzid)
void setAuthcid (const std::string &authcid)
void setSASLMechanisms (int mechanisms)
void registerStanzaExtension (StanzaExtension *ext)
bool removeStanzaExtension (int ext)
void registerConnectionListener (ConnectionListener *cl)
void registerIqHandler (IqHandler *ih, int exttype)
void removeIDHandler (IqHandler *ih)
void registerMessageHandler (MessageHandler *mh)
void removeMessageHandler (MessageHandler *mh)
void registerMessageSession (MessageSession *session)
void disposeMessageSession (MessageSession *session)
void registerPresenceHandler (PresenceHandler *ph)
void registerPresenceHandler (const JID &jid, PresenceHandler *ph)
void registerSubscriptionHandler (SubscriptionHandler *sh)
void registerTagHandler (TagHandler *th, const std::string &tag, const std::string &xmlns)
void registerStatisticsHandler (StatisticsHandler *sh)
void removeConnectionListener (ConnectionListener *cl)
void removeIqHandler (IqHandler *ih, int exttype)
void removePresenceHandler (PresenceHandler *ph)
void removePresenceHandler (const JID &jid, PresenceHandler *ph)
void removeSubscriptionHandler (SubscriptionHandler *sh)
void removeTagHandler (TagHandler *th, const std::string &tag, const std::string &xmlns)
void removeStatisticsHandler ()
void setCACerts (const StringList &cacerts)
void setClientCert (const std::string &clientKey, const std::string &clientCerts)
void registerMessageSessionHandler (MessageSessionHandler *msh, int types=0)
LogSinklogInstance ()
StreamError streamError () const
const std::string & streamErrorText (const std::string &lang="default") const
const std::string & streamErrorCData () const
const TagstreamErrorAppCondition () const
AuthenticationError authError () const
StatisticsStruct getStatistics ()
void registerMUCInvitationHandler (MUCInvitationHandler *mih)
void removeMUCInvitationHandler ()
void addPresenceExtension (StanzaExtension *se)
bool removePresenceExtension (int type)
const StanzaExtensionListpresenceExtensions () const
virtual void handleTag (Tag *tag)
virtual void handleCompressedData (const std::string &data)
virtual void handleDecompressedData (const std::string &data)
virtual void handleReceivedData (const ConnectionBase *connection, const std::string &data)
virtual void handleConnect (const ConnectionBase *connection)
virtual void handleDisconnect (const ConnectionBase *connection, ConnectionError reason)
virtual void handleEncryptedData (const TLSBase *base, const std::string &data)
virtual void handleDecryptedData (const TLSBase *base, const std::string &data)
virtual void handleHandshakeResult (const TLSBase *base, bool success, CertInfo &certinfo)

Protected Member Functions

void notifyOnResourceBindError (const Error *error)
void notifyOnResourceBind (const std::string &resource)
void notifyOnSessionCreateError (const Error *error)
bool notifyOnTLSConnect (const CertInfo &info)
void notifyOnConnect ()
void notifyStreamEvent (StreamEvent event)
virtual void disconnect (ConnectionError reason)
void header ()
void setAuthed (bool authed)
void setAuthFailure (AuthenticationError e)
virtual bool checkStreamVersion (const std::string &version)
void startSASL (SaslMechanism type)
void processSASLSuccess ()
void processSASLChallenge (const std::string &challenge)
void processSASLError (Tag *tag)
void setNTLMDomain (const std::string &domain)
void startTls ()
bool hasTls ()

Protected Attributes

JID m_jid
JID m_authzid
std::string m_authcid
ConnectionBasem_connection
TLSBasem_encryption
CompressionBasem_compression
Discom_disco
StanzaExtensionList m_presenceExtensions
std::string m_selectedResource
std::string m_clientCerts
std::string m_clientKey
std::string m_namespace
std::string m_password
std::string m_xmllang
std::string m_server
std::string m_sid
bool m_compressionActive
bool m_encryptionActive
bool m_compress
bool m_authed
bool m_block
bool m_sasl
TLSPolicy m_tls
int m_port
int m_availableSaslMechs

Detailed Description

This is the common base class for a Jabber/XMPP Client and a Jabber Component.

It manages connection establishing, authentication, filter registration and invocation. You should normally use Client for client connections and Component for component connections.

Author:
Jakob Schroeter <js@camaya.net>
Since:
0.3

Definition at line 75 of file clientbase.h.


Constructor & Destructor Documentation

ClientBase ( const std::string &  ns,
const std::string &  server,
int  port = -1 
)

Constructs a new ClientBase. You should not need to use this class directly. Use Client or Component instead.

Parameters:
ns The namespace which qualifies the stream. Either jabber:client or jabber:component:*
server The server to connect to.
port The port to connect to. The default of -1 means to look up the port via DNS SRV or to use a default port of 5222 as defined in XMPP Core.

Definition at line 68 of file clientbase.cpp.

ClientBase ( const std::string &  ns,
const std::string &  password,
const std::string &  server,
int  port = -1 
)

Constructs a new ClientBase. You should not need to use this class directly. Use Client or Component instead.

Parameters:
ns The namespace which qualifies the stream. Either jabber:client or jabber:component:*
password The password to use for further authentication.
server The server to connect to.
port The port to connect to. The default of -1 means to look up the port via DNS SRV or to use a default port of 5222 as defined in XMPP: Core.

Definition at line 83 of file clientbase.cpp.

~ClientBase (  )  [virtual]

Virtual destrcuctor.

Definition at line 119 of file clientbase.cpp.


Member Function Documentation

void addPresenceExtension ( StanzaExtension se  ) 

Adds a StanzaExtension that will be sent with every Presence stanza sent. Capabilities are included by default if you are using a Client.

Parameters:
se A StanzaExtension to add. If an extension of the same type has been added previously it will be replaced by the new one. Use removePresenceExtension() to remove an extension.

Definition at line 1443 of file clientbase.cpp.

bool authed (  )  const [inline]

Returns whether authentication has taken place and was successful.

Returns:
True if authentication has been carried out and was successful, false otherwise.

Definition at line 289 of file clientbase.h.

AuthenticationError authError (  )  const [inline]

Use this function to retrieve the type of the authentication error after it occurs and you received a ConnectionError of type ConnAuthenticationFailed from the ConnectionListener.

Returns:
The type of the authentication, if any, AuthErrorUndefined otherwise.

Definition at line 639 of file clientbase.h.

bool checkStreamVersion ( const std::string &  version  )  [protected, virtual]

Implementors of this function can check if they support the advertized stream version. The return value indicates whether or not the stream can be handled. A default implementation is provided.

Parameters:
version The advertized stream version.
Returns:
True if the stream can be handled, false otherwise.

Reimplemented in Component.

Definition at line 877 of file clientbase.cpp.

bool compression (  )  const [inline]

Returns whether Stream Compression is currently enabled (not necessarily used).

Returns:
The current Stream Compression status.

Definition at line 213 of file clientbase.h.

CompressionBase* compressionImpl (  )  const [inline]

This function returns the concrete compression implementation currently in use.

Returns:
The concrete compression implementation.
Since:
0.9

Definition at line 348 of file clientbase.h.

bool connect ( bool  block = true  ) 

Initiates the connection to a server. This function blocks as long as a connection is established. You can have the connection block 'til the end of the connection, or you can have it return immediately. If you choose the latter, its your responsibility to call recv() every now and then to actually receive data from the socket and to feed the parser.

Parameters:
block True for blocking, false for non-blocking connect. Defaults to true.
Returns:
False if prerequisits are not met (server not set) or if the connection was refused, true otherwise.
Note:
Since 0.9 onDisconnect() is called in addition to a return value of false.

Definition at line 144 of file clientbase.cpp.

ConnectionBase* connectionImpl (  )  const [inline]

This function returns the concrete connection implementation currently in use.

Returns:
The concrete connection implementation.
Since:
0.9

Definition at line 316 of file clientbase.h.

virtual Disco* disco (  )  const [inline, virtual]

This function gives access to the Disco object.

Returns:
A pointer to the Disco object.

Definition at line 232 of file clientbase.h.

void disconnect ( ConnectionError  reason  )  [protected, virtual]

Disconnects the underlying stream and broadcasts the given reason.

Parameters:
reason The reason for the disconnect.

Definition at line 343 of file clientbase.cpp.

void disposeMessageSession ( MessageSession session  ) 

Removes the given MessageSession from the list of MessageSessions and deletes it.

Parameters:
session The MessageSession to be deleted.

Definition at line 1110 of file clientbase.cpp.

TLSBase* encryptionImpl (  )  const [inline]

This function returns the concrete encryption implementation currently in use.

Returns:
The concrete encryption implementation.
Since:
0.9

Definition at line 332 of file clientbase.h.

const std::string getID (  ) 

Creates a string which is unique in the current instance and can be used as an ID for queries.

Returns:
A unique string suitable for query IDs.

Definition at line 868 of file clientbase.cpp.

StatisticsStruct getStatistics (  ) 

Returns a StatisticsStruct containing byte and stanza counts for the current active connection.

Returns:
A struct containing the current connection's statistics.

Definition at line 818 of file clientbase.cpp.

void handleCompressedData ( const std::string &  data  )  [virtual]

This function is called when compression is finished.

Parameters:
data The compressed data.

Implements CompressionDataHandler.

Definition at line 258 of file clientbase.cpp.

void handleConnect ( const ConnectionBase connection  )  [virtual]

This function is called when e.g. the raw TCP connection was established.

Parameters:
connection The connection.

Implements ConnectionDataHandler.

Definition at line 321 of file clientbase.cpp.

void handleDecompressedData ( const std::string &  data  )  [virtual]

This function is called when decompression is finished.

Parameters:
data The decompressed data.

Implements CompressionDataHandler.

Definition at line 268 of file clientbase.cpp.

void handleDecryptedData ( const TLSBase base,
const std::string &  data 
) [virtual]

Reimplement this function to receive decrypted data from a TLSBase implementation.

Parameters:
base The encryption implementation which called this function.
data The decrypted data (e.g. to parse).

Implements TLSHandler.

Definition at line 281 of file clientbase.cpp.

void handleDisconnect ( const ConnectionBase connection,
ConnectionError  reason 
) [virtual]

This connection is called when e.g. the raw TCP connection was closed.

Parameters:
connection The connection.
reason The reason for the disconnect.

Implements ConnectionDataHandler.

Definition at line 326 of file clientbase.cpp.

void handleEncryptedData ( const TLSBase base,
const std::string &  data 
) [virtual]

Reimplement this function to receive encrypted data from a TLSBase implementation.

Parameters:
base The encryption implementation which called this function.
data The encrypted data (e.g. to send over the wire).

Implements TLSHandler.

Definition at line 273 of file clientbase.cpp.

void handleHandshakeResult ( const TLSBase base,
bool  success,
CertInfo certinfo 
) [virtual]

Reimplement this function to receive the result of a TLS handshake.

Parameters:
base The encryption implementation which called this function.
success Whether or not the handshake was successful.
certinfo Information about the server's certificate.

Implements TLSHandler.

Definition at line 289 of file clientbase.cpp.

void handleReceivedData ( const ConnectionBase connection,
const std::string &  data 
) [virtual]

This function is called for received from the underlying transport.

Parameters:
connection The connection that received the data.
data The data received.

Implements ConnectionDataHandler.

Definition at line 311 of file clientbase.cpp.

void handleTag ( Tag tag  )  [virtual]

This function is called when a registered XML element arrives. As with every handler in gloox, the Tag is going to be deleted after this function returned. If you need a copy afterwards, create it using Tag::clone().

Parameters:
tag The complete Tag.

Implements TagHandler.

Definition at line 174 of file clientbase.cpp.

bool hasTls (  )  [protected]

Indicates whether or not TLS is supported.

Returns:
True if TLS is supported, false otherwise.

Definition at line 392 of file clientbase.cpp.

void header (  )  [protected]

Sends the stream header.

Definition at line 383 of file clientbase.cpp.

const JID& jid (  )  [inline]

Returns the current Jabber ID. If an authorization ID has been set (using setAuthzid()) this authzid is returned.

Returns:
A reference to the Jabber ID.
Note:
If you change the server part of the JID, the server of the connection is not synced. You have to do that manually using setServer().

Definition at line 146 of file clientbase.h.

LogSink& logInstance (  )  [inline]

Returns the LogSink instance for this ClientBase and all related objects.

Returns:
The LogSink instance used in the current ClientBase.

Definition at line 598 of file clientbase.h.

void notifyOnConnect (  )  [protected]

This function is called to notify about successful connection.

Definition at line 1212 of file clientbase.cpp.

void notifyOnResourceBind ( const std::string &  resource  )  [protected]

This function is called when binding a resource succeeded.

Parameters:
resource The bound resource.

Definition at line 1236 of file clientbase.cpp.

void notifyOnResourceBindError ( const Error error  )  [protected]

This function is called when resource binding yieled an error.

Parameters:
error A pointer to an Error object that contains more information. May be 0.

Definition at line 1231 of file clientbase.cpp.

void notifyOnSessionCreateError ( const Error error  )  [protected]

This function is called when session creation yieled an error.

Parameters:
error A pointer to an Error object that contains more information. May be 0.

Definition at line 1241 of file clientbase.cpp.

bool notifyOnTLSConnect ( const CertInfo info  )  [protected]

This function is called when the TLS handshake completed correctly. The return value is used to determine whether or not the client accepted the server's certificate. If false is returned the connection is closed.

Parameters:
info Information on the server's certificate.
Returns:
True if the certificate seems trustworthy, false otherwise.

Definition at line 1223 of file clientbase.cpp.

void notifyStreamEvent ( StreamEvent  event  )  [protected]

This function is used to notify subscribers of stream events.

Parameters:
event The event to publish.

Definition at line 1246 of file clientbase.cpp.

virtual const std::string& password (  )  const [inline, virtual]

Returns the current password.

Returns:
The password used to connect.

Definition at line 226 of file clientbase.h.

int port (  )  const [inline]

Returns the port. The default of -1 means that the actual port will be looked up using SRV records, or the XMPP default port of 5222 will be used.

Returns:
The port used to connect.

Definition at line 220 of file clientbase.h.

const StanzaExtensionList& presenceExtensions (  )  const [inline]

Returns the current list of Presence StanzaExtensions.

Returns:
The current list of Presence StanzaExtensions.

Definition at line 679 of file clientbase.h.

void processSASLChallenge ( const std::string &  challenge  )  [protected]

Processes the given SASL challenge and sends a response.

Parameters:
challenge The SASL challenge to process.

Definition at line 507 of file clientbase.cpp.

void processSASLError ( Tag tag  )  [protected]

Examines the given Tag for SASL errors.

Parameters:
tag The Tag to parse.

Definition at line 656 of file clientbase.cpp.

void processSASLSuccess (  )  [protected]

Releases SASL related resources.

Definition at line 684 of file clientbase.cpp.

ConnectionError recv ( int  timeout = -1  ) 

Use this periodically to receive data from the socket and to feed the parser. You need to use this only if you chose to connect in non-blocking mode.

Parameters:
timeout The timeout in microseconds to use for select. Default of -1 means blocking until data was available.
Returns:
The state of the connection.

Definition at line 136 of file clientbase.cpp.

void registerConnectionListener ( ConnectionListener cl  ) 

Registers cl as object that receives connection notifications.

Parameters:
cl The object to receive connection notifications.

Definition at line 1200 of file clientbase.cpp.

void registerIqHandler ( IqHandler ih,
int  exttype 
)

Registers ih as object that receives notifications for IQ stanzas that contain StanzaExtensions of the given type. The number of handlers per extension type is not limited.

Parameters:
ih The object to receive IQ stanza notifications.
exttype The extension type. See StanzaExtension and StanzaExtensionType .
Since:
1.0

Definition at line 1073 of file clientbase.cpp.

void registerMessageHandler ( MessageHandler mh  ) 

Registers mh as object that receives Message stanza notifications.

Parameters:
mh The object to receive Message stanza notifications.

Definition at line 1125 of file clientbase.cpp.

void registerMessageSession ( MessageSession session  ) 

Registers the given MessageSession to receive Messages incoming from the session's target JID.

Note:
The ClientBase instance becomes the owner of the MessageSession, it will be deleted in ClientBase's destructor. To get rid of the session before that, use disposeMessageSession().
Parameters:
session The MessageSession to register.
Note:
Since a MessageSession automatically registers itself with the ClientBase, there is no need to call this function directly.

Definition at line 1104 of file clientbase.cpp.

void registerMessageSessionHandler ( MessageSessionHandler msh,
int  types = 0 
)

Use this function to register a MessageSessionHandler with the Client. Optionally the MessageSessionHandler can receive only MessageSessions with a given message type. There can be only one handler per message type.
A MessageSession will be created for every incoming message stanza if there is no MessageHandler registered for the originating JID.

Parameters:
msh The MessageSessionHandler that will receive the newly created MessageSession.
types ORed StanzaSubType's that describe the desired message types the handler shall receive. Only StanzaMessage* types are valid. A value of 0 means any type (default).

Definition at line 1004 of file clientbase.cpp.

void registerMUCInvitationHandler ( MUCInvitationHandler mih  ) 

Registers a MUCInvitationHandler with the ClientBase.

Parameters:
mih The MUCInvitationHandler to register.

Definition at line 1185 of file clientbase.cpp.

void registerPresenceHandler ( const JID jid,
PresenceHandler ph 
)

Registers a new PresenceHandler for the given JID. Presences received for this particular JID will not be forwarded to the generic PresenceHandler (and therefore the Roster). This functionality is primarily intended for the MUC implementation.

Parameters:
jid The JID to 'watch'.
ph The PresenceHandler to inform about presence changes from jid.
Since:
0.9

Definition at line 1031 of file clientbase.cpp.

void registerPresenceHandler ( PresenceHandler ph  ) 

Registers ph as object that receives Presence stanza notifications.

Parameters:
ph The object to receive Presence stanza notifications.

Definition at line 1019 of file clientbase.cpp.

void registerStanzaExtension ( StanzaExtension ext  ) 

Registers a new StanzaExtension with the StanzaExtensionFactory.

Parameters:
ext The extension to register.

Definition at line 802 of file clientbase.cpp.

void registerStatisticsHandler ( StatisticsHandler sh  ) 

Registers sh as object that receives up-to-date connection statistics each time a Stanza is received or sent. Alternatively, you can use getStatistics() manually. Only one StatisticsHandler per ClientBase at a time is possible.

Parameters:
sh The StatisticsHandler to register.

Definition at line 1174 of file clientbase.cpp.

void registerSubscriptionHandler ( SubscriptionHandler sh  ) 

Registers sh as object that receives Subscription stanza notifications.

Parameters:
sh The object to receive Subscription stanza notifications.

Definition at line 1137 of file clientbase.cpp.

void registerTagHandler ( TagHandler th,
const std::string &  tag,
const std::string &  xmlns 
)

Registers th as object that receives incoming packts with a given root tag qualified by the given namespace.

Parameters:
th The object to receive Subscription packet notifications.
tag The element's name.
xmlns The element's namespace.

Definition at line 1149 of file clientbase.cpp.

void removeConnectionListener ( ConnectionListener cl  ) 

Removes the given object from the list of connection listeners.

Parameters:
cl The object to remove from the list.

Definition at line 1206 of file clientbase.cpp.

void removeIDHandler ( IqHandler ih  ) 

Removes the given IqHandler from the list of handlers of pending operations, added using trackID(). Necessary, for example, when closing a GUI element that has an operation pending.

Parameters:
ih The IqHandler to remove.
Since:
0.8.7

Definition at line 1058 of file clientbase.cpp.

void removeIqHandler ( IqHandler ih,
int  exttype 
)

Removes the given IQ handler for the given extension type.

Parameters:
ih The IqHandler.
exttype The extension type. See StanzaExtensionType .
Since:
1.0

Definition at line 1087 of file clientbase.cpp.

void removeMessageHandler ( MessageHandler mh  ) 

Removes the given object from the list of message handlers.

Parameters:
mh The object to remove from the list.

Definition at line 1131 of file clientbase.cpp.

void removeMUCInvitationHandler (  ) 

Removes the currently registered MUCInvitationHandler.

Definition at line 1194 of file clientbase.cpp.

bool removePresenceExtension ( int  type  ) 

Removes the StanzaExtension of the given type from the list of Presence StanzaExtensions. Use addPresenceExtension() to replace an already added type.

Definition at line 1452 of file clientbase.cpp.

void removePresenceHandler ( const JID jid,
PresenceHandler ph 
)

Removes the given object from the list of presence handlers for the given JID.

Parameters:
jid The JID to remove the PresenceHandler(s) for.
ph The PresenceHandler to remove from the list. If ph is 0, all handlers for the given JID will be removed.

Definition at line 1042 of file clientbase.cpp.

void removePresenceHandler ( PresenceHandler ph  ) 

Removes the given object from the list of presence handlers.

Parameters:
ph The object to remove from the list.

Definition at line 1025 of file clientbase.cpp.

bool removeStanzaExtension ( int  ext  ) 

Removes the given StanzaExtension type from the StanzaExtensionFactory.

Parameters:
ext The extension type.
Returns:
True if the given type was found (and removed), false otherwise.

Definition at line 810 of file clientbase.cpp.

void removeStatisticsHandler (  ) 

Removes the current StatisticsHandler.

Definition at line 1180 of file clientbase.cpp.

void removeSubscriptionHandler ( SubscriptionHandler sh  ) 

Removes the given object from the list of subscription handlers.

Parameters:
sh The object to remove from the list.

Definition at line 1143 of file clientbase.cpp.

void removeTagHandler ( TagHandler th,
const std::string &  tag,
const std::string &  xmlns 
)

Removes the given object from the list of tag handlers for the given element and namespace.

Parameters:
th The object to remove from the list.
tag The element to remove the handler for.
xmlns The namespace qualifying the element.

Definition at line 1161 of file clientbase.cpp.

bool sasl (  )  const [inline]

Returns whether SASL is currently enabled (not necessarily used).

Returns:
The current SASL status.

Definition at line 201 of file clientbase.h.

void send ( Presence pres  ) 

A convenience function that sends the given Presence stanza.

Parameters:
pres The Presence stanza to send.

Definition at line 741 of file clientbase.cpp.

void send ( const Subscription sub  ) 

A convenience function that sends the given Subscription stanza.

Parameters:
sub The Subscription stanza to send.

Definition at line 732 of file clientbase.cpp.

void send ( const Message msg  ) 

A convenience function that sends the given Message stanza.

Parameters:
msg The Message stanza to send.

Definition at line 723 of file clientbase.cpp.

void send ( const IQ iq  ) 

A convenience function that sends the given IQ stanza.

Parameters:
iq The IQ stanza to send.

Definition at line 714 of file clientbase.cpp.

void send ( IQ iq,
IqHandler ih,
int  context,
bool  del = false 
)

Sends the given IQ stanza. The given IqHandler is registered to be notified of replies. This, of course, only works for IQs of type get or set. An ID is added if necessary.

Parameters:
iq The IQ stanza to send.
ih The handler to register for replies.
context A value that allows for restoring context.
del Whether or not delete the IqHandler object after its being called. Default: false.

Definition at line 695 of file clientbase.cpp.

void send ( Tag tag  ) 

Sends the given Tag over an established connection. The ClientBase object becomes the owner of this Tag and will delete it after sending it. You should not rely on the existance of the Tag after it's been sent. If you still need it after sending it, use Tag::clone() to create a deep copy.

Parameters:
tag The Tag to send.

Definition at line 753 of file clientbase.cpp.

const std::string& server (  )  const [inline]

Returns the current prepped server.

Returns:
The server used to connect.

Definition at line 195 of file clientbase.h.

void setAuthcid ( const std::string &  authcid  )  [inline]

Use this function to set an authentication ID (authcid) for SASL PLAIN. The default authcid is the username, i.e. the JID's node part. This should work in most cases. If this is not what you want to use for authentication, use this function.

Parameters:
authcid The authentication ID.
Since:
1.0
Note:
Right now this is used for SASL PLAIN authentication only.

Definition at line 390 of file clientbase.h.

void setAuthed ( bool  authed  )  [inline, protected]

Tells ClientBase that authentication was successful (or not).

Parameters:
authed Whether or not authentication was successful.

Definition at line 764 of file clientbase.h.

void setAuthFailure ( AuthenticationError  e  )  [inline, protected]

If authentication failed, this function tells ClientBase the reason.

Parameters:
e The reason for the authentication failure.

Definition at line 771 of file clientbase.h.

void setAuthzid ( const JID authzid  )  [inline]

Use this function to set an authorization ID (authzid). Provided the server supports it and the user has sufficient rights, they could then authenticate as bob@example.net but act as alice@example.net.

Parameters:
authzid The JID to authorize as. Only the bare JID is used.
Since:
0.9

Definition at line 380 of file clientbase.h.

void setCACerts ( const StringList cacerts  )  [inline]

Use this function to set a number of trusted root CA certificates which shall be used to verify a servers certificate.

Parameters:
cacerts A list of absolute paths to CA root certificate files in PEM format.

Definition at line 567 of file clientbase.h.

void setClientCert ( const std::string &  clientKey,
const std::string &  clientCerts 
)

Use this function to set the user's certificate and private key. The certificate will be presented to the server upon request and can be used for SASL EXTERNAL authentication. The user's certificate file should be a bundle of more than one certificate in PEM format. The first one in the file should be the user's certificate, each cert following that one should have signed the previous one.

Note:
These certificates are not necessarily the same as those used to verify the server's certificate.
Parameters:
clientKey The absolute path to the user's private key in PEM format.
clientCerts A path to a certificate bundle in PEM format.

Definition at line 413 of file clientbase.cpp.

void setCompression ( bool  compression  )  [inline]

Switches usage of Stream Compression on/off (if available). Default: on if available. Stream Compression should only be disabled if there are problems with using it.

Parameters:
compression Whether to switch Stream Compression usage on or off.

Definition at line 167 of file clientbase.h.

void setCompressionImpl ( CompressionBase cb  ) 

Use this function if you have a class supporting some fancy compression algorithm. This should be called before calling connect(). If there already is a compression implementation set (either manually or automatically), it gets deleted.

Parameters:
cb The compression implementation to use.
Since:
0.9

Definition at line 914 of file clientbase.cpp.

void setConnectionImpl ( ConnectionBase cb  ) 

Use this function if you have a class implementing a UDP, SCTP (or whatever) connection. This should be called before calling connect(). If there already is a connection implementation set (either manually or automatically), it gets deleted.

Parameters:
cb The connection to use.
Since:
0.9

Definition at line 896 of file clientbase.cpp.

void setEncryptionImpl ( TLSBase tb  ) 

Use this function if you have a class supporting hardware encryption (or whatever). This should be called before calling connect(). If there already is a encryption implementation set (either manually or automatically), it gets deleted.

Parameters:
tb The encryption implementation to use.
Since:
0.9

Definition at line 905 of file clientbase.cpp.

void setNTLMDomain ( const std::string &  domain  )  [inline, protected]

Sets the domain to use in SASL NTLM authentication.

Parameters:
domain The domain.

Definition at line 809 of file clientbase.h.

void setPassword ( const std::string &  password  )  [inline]

Sets the password to use to connect to the XMPP server.

Parameters:
password The password to use for authentication.

Definition at line 189 of file clientbase.h.

void setPort ( int  port  )  [inline]

Sets the port to connect to. This is not necessary if either the default port (5222) is used or SRV records exist which will be resolved.

Parameters:
port The port to connect to.

Definition at line 174 of file clientbase.h.

void setSasl ( bool  sasl  )  [inline]

Switches usage of SASL on/off. Default: on. SASL should only be disabled if there are problems with using it.

Parameters:
sasl Whether to switch SASL usage on or off.

Definition at line 153 of file clientbase.h.

void setSASLMechanisms ( int  mechanisms  )  [inline]

Use this function to limit SASL mechanisms gloox can use. By default, all supported mechanisms are allowed. To exclude one (or more) mechanisms, remove it from SaslMechAll like so:

 int mymechs = SaslMechAll ^ SaslMechDigestMd5;
Parameters:
mechanisms Bitwise ORed SaslMechanism.
Since:
0.9

Definition at line 402 of file clientbase.h.

void setServer ( const std::string &  server  ) 

Sets the XMPP server to connect to.

Parameters:
server The server to connect to. Either IP or fully qualified domain name.
Note:
If you change the server, the server part of the JID is not synced. You have to do that manually using jid() and JID::setServer().
This function also sets the server of the Connection(Base) in use.

Definition at line 406 of file clientbase.cpp.

void setTls ( TLSPolicy  tls  )  [inline]

Sets the TLS policy. Default: TLS will be used if available. TLS should only be disabled if there are problems with using it.

Parameters:
tls The TLS policy.

Definition at line 160 of file clientbase.h.

void setXmlLang ( const std::string &  xmllang  )  [inline]

Sets the value for the xml:lang attribute of the initial stream.

Parameters:
xmllang The language identifier for the stream. It must conform to section 2.12 of the XML specification and RFC 3066. Default is 'en'.

Definition at line 309 of file clientbase.h.

void startSASL ( SaslMechanism  type  )  [protected]

Starts authentication using the given SASL mechanism.

Parameters:
type A SASL mechanism to use for authentication.

Definition at line 419 of file clientbase.cpp.

void startTls (  )  [protected]

Starts the TLS handshake.

Definition at line 401 of file clientbase.cpp.

ConnectionState state (  )  const

Returns the current connection status.

Returns:
The status of the connection.

Definition at line 826 of file clientbase.cpp.

StreamError streamError (  )  const [inline]

Use this function to retrieve the type of the stream error after it occurs and you received a ConnectionError of type ConnStreamError from the ConnectionListener.

Returns:
The StreamError.
Note:
The return value is only meaningful when called from ConnectionListener::onDisconnect().

Definition at line 606 of file clientbase.h.

const Tag* streamErrorAppCondition (  )  const [inline]

This function can be used to retrieve the application-specific error condition of a stream error.

Returns:
The application-specific error element of a stream error. 0 if no respective element was found or no error occured.

Definition at line 632 of file clientbase.h.

const std::string& streamErrorCData (  )  const [inline]

In case the defined-condition element of an stream error contains XML character data you can use this function to retrieve it. RFC 3920 only defines one condition (see-other-host)where this is possible.

Returns:
The cdata of the stream error's text element (only for see-other-host).

Definition at line 625 of file clientbase.h.

const std::string & streamErrorText ( const std::string &  lang = "default"  )  const

Returns the text of a stream error for the given language if available. If the requested language is not available, the default text (without a xml:lang attribute) will be returned.

Parameters:
lang The language identifier for the desired language. It must conform to section 2.12 of the XML specification and RFC 3066. If empty, the default body will be returned, if any.
Returns:
The describing text of a stream error. Empty if no stream error occured.

Definition at line 998 of file clientbase.cpp.

TLSPolicy tls (  )  const [inline]

Returns whether TLS is currently enabled (not necessarily used).

Returns:
The current TLS status.

Definition at line 207 of file clientbase.h.

virtual const std::string& username (  )  const [inline, virtual]

Reimplement this function to provide a username for connection purposes.

Returns:
The username.

Definition at line 137 of file clientbase.h.

void whitespacePing (  ) 

Sends a whitespace ping to the server.

Since:
0.9

Definition at line 831 of file clientbase.cpp.

const std::string& xmlLang (  )  const [inline]

Retrieves the value of the xml:lang attribute of the initial stream. Default is 'en', i.e. if not changed by a call to setXmlLang().

Definition at line 301 of file clientbase.h.

void xmppPing ( const JID to,
EventHandler eh 
)

Sends a XMPP Ping (XEP-0199) to the given JID.

Parameters:
to Then entity to ping.
eh An EventHandler to inform about the reply.
Since:
0.9

Definition at line 836 of file clientbase.cpp.


Member Data Documentation

std::string m_authcid [protected]

An alternative authentication ID. See setAuthcid().

Definition at line 824 of file clientbase.h.

bool m_authed [protected]

Whether authentication has been completed successfully.

Definition at line 849 of file clientbase.h.

JID m_authzid [protected]

An optional authorization ID. See setAuthzid().

Definition at line 823 of file clientbase.h.

int m_availableSaslMechs [protected]

The SASL mechanisms the server offered.

Definition at line 856 of file clientbase.h.

bool m_block [protected]

Whether blocking connection is wanted.

Definition at line 850 of file clientbase.h.

std::string m_clientCerts [protected]

TLS client certificates.

Definition at line 835 of file clientbase.h.

std::string m_clientKey [protected]

TLS client private key.

Definition at line 836 of file clientbase.h.

bool m_compress [protected]

Whether stream compression is desired at all.

Definition at line 847 of file clientbase.h.

Used for connection compression.

Definition at line 827 of file clientbase.h.

bool m_compressionActive [protected]

Indicates whether or not stream compression is currently activated.

Definition at line 843 of file clientbase.h.

The transport connection.

Definition at line 825 of file clientbase.h.

Disco* m_disco [protected]

The local Service Discovery client.

Definition at line 828 of file clientbase.h.

TLSBase* m_encryption [protected]

Used for connection encryption.

Definition at line 826 of file clientbase.h.

bool m_encryptionActive [protected]

Indicates whether or not stream encryption is currently activated.

Definition at line 845 of file clientbase.h.

JID m_jid [protected]

The 'self' JID.

Definition at line 822 of file clientbase.h.

std::string m_namespace [protected]

Default namespace.

Definition at line 837 of file clientbase.h.

std::string m_password [protected]

Client's password.

Definition at line 838 of file clientbase.h.

int m_port [protected]

The port to connect to, if not to be determined by querying the server's SRV records.

Definition at line 853 of file clientbase.h.

A list of permanent presence extensions.

Definition at line 831 of file clientbase.h.

bool m_sasl [protected]

Whether SASL authentication is wanted.

Definition at line 851 of file clientbase.h.

std::string m_selectedResource [protected]

The currently selected resource. See Client::selectResource() and Client::binRessource().

Definition at line 833 of file clientbase.h.

std::string m_server [protected]

The server to connect to, if different from the JID's server.

Definition at line 840 of file clientbase.h.

std::string m_sid [protected]

The stream ID.

Definition at line 842 of file clientbase.h.

TLSPolicy m_tls [protected]

The current TLS policy.

Definition at line 852 of file clientbase.h.

std::string m_xmllang [protected]

Default value of the xml:lang attribute.

Definition at line 839 of file clientbase.h.


The documentation for this class was generated from the following files:

Generated by  doxygen 1.6.2