#include <stanza.h>

Inheritance diagram for Stanza:

Public Member Functions
virtual	~Stanza ()

void	setFrom (const JID &from)

const JID &	from () const

const JID &	to () const

const std::string &	id () const

const Error *	error () const

const std::string &	xmlLang () const

void	addExtension (const StanzaExtension *se)

const StanzaExtension *	findExtension (int type) const

template<class T >
const T *	findExtension (int type) const

const StanzaExtensionList &	extensions () const

void	removeExtensions ()

void	setEmbeddedStanza ()

bool	hasEmbeddedStanza () const

Stanza *	embeddedStanza () const

Tag *	embeddedTag () const

virtual Tag *	tag () const =0

Protected Member Functions
	Stanza (Tag *tag)

	Stanza (const JID &to)

Detailed Description

This is the base class for XMPP stanza abstractions.

Author: Jakob Schröter js@ca.nosp@m.maya.nosp@m..net

Since: 0.4

Definition at line 33 of file stanza.h.

Constructor & Destructor Documentation

~Stanza ( )

virtual

Virtual destructor.

Definition at line 42 of file stanza.cpp.

Stanza ( Tag * tag )

protected

Creates a new Stanza, taking from and to addresses from the given Tag.

Parameters

tag	The Tag to create the Stanza from.

Since: 1.0

Definition at line 31 of file stanza.cpp.

Stanza ( const JID & to )

protected

Creates a new Stanza object and initializes the receiver's JID.

Parameters

to	The receipient of the Stanza.

Since: 1.0

Definition at line 26 of file stanza.cpp.

Member Function Documentation

void addExtension ( const StanzaExtension * se )

Use this function to add a StanzaExtension to this Stanza.

Parameters

se	The StanzaExtension to add.

Note: The Stanza will become the owner of the StanzaExtension and will take care of deletion.

Since: 0.9

Definition at line 52 of file stanza.cpp.

Stanza * embeddedStanza ( ) const

This function returns the embedded Stanza. It is only needed by ClientBase/StanzaExtensionFactory. If hasEmbeddedStanza() is true, this function checks every embedded StanzaExtension for an embedded Stanza and returns the first it finds. You should not need to use this function directly.

Returns: The embedded Stanza. May be 0.

Definition at line 69 of file stanza.cpp.

Tag * embeddedTag ( ) const

This function returns the embedded Tag that the embedded Stanza is based on. It is only needed by ClientBase/StanzaExtensionFactory. If hasEmbeddedStanza() is true, this function checks every embedded StanzaExtension for an embedded Tag and returns the first it finds. You should not need to use this function directly.

Returns: The embedded Tag. May be 0.

Definition at line 76 of file stanza.cpp.

const Error * error ( ) const

A convenience function that returns the stanza error condition, if any.

Returns: The stanza error condition, may be 0.

Definition at line 47 of file stanza.cpp.

const StanzaExtensionList& extensions ( ) const

inline

Returns the list of the Stanza's extensions.

Returns: The list of the Stanza's extensions.

Definition at line 113 of file stanza.h.

const StanzaExtension * findExtension ( int type ) const

Finds a StanzaExtension of a particular type.

Parameters

type	StanzaExtensionType to search for.

Returns: A pointer to the StanzaExtension, or 0 if none was found.

Definition at line 57 of file stanza.cpp.

const T* findExtension ( int type ) const

inline

Finds a StanzaExtension of a particular type. Example:

const MyExtension* c = presence.findExtension<MyExtension>( ExtMyExt );

Parameters

type	The extension type to look for.

Returns: The static_cast' type, or 0 if none was found.

Definition at line 104 of file stanza.h.

const JID& from ( ) const

inline

Returns the JID the stanza comes from.

Returns: The origin of the stanza.

Definition at line 51 of file stanza.h.

bool hasEmbeddedStanza ( ) const

inline

This function indicates whether this Stanza instance contains an embedded Stanza that needs to be checked for further StanzaExtensions. You should not need to use this function directly.

Returns: Whether this Stanza instance contains an embedded Stanza.

Definition at line 135 of file stanza.h.

const std::string& id ( ) const

inline

Returns the id of the stanza, if set.

Returns: The ID of the stanza.

Definition at line 63 of file stanza.h.

void removeExtensions ( )

Removes (deletes) all the stanza's extensions.

Definition at line 64 of file stanza.cpp.

void setEmbeddedStanza ( )

inline

This function is used by StanzaExtensionFactory to signal ClientBase that this Stanza instance contains an embedded Stanza that needs to be checked for further StanzaExtensions. You should not need to use this function directly.

Definition at line 126 of file stanza.h.

void setFrom ( const JID & from )

inline

Sets the 'from' address of the Stanza. This useful for Components .

Parameters

from	The from address.

Definition at line 45 of file stanza.h.

virtual Tag* tag ( ) const

pure virtual

Creates a Tag representation of the Stanza. The Tag is completely independent of the Stanza and will not be updated when the Stanza is modified.

Returns: A pointer to a Tag representation. It is the job of the caller to delete the Tag.

Implemented in Presence, Message, Subscription, and IQ.

const JID& to ( ) const

inline

Returns the receiver of the stanza.

Returns: The stanza's destination.

Definition at line 57 of file stanza.h.

const std::string& xmlLang ( ) const

inline

Retrieves the value of the xml:lang attribute of this stanza. Default is 'en'.

Returns: The stanza's default language.

Definition at line 76 of file stanza.h.

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

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation