Class Forwarded<S extends Stanza>

java.lang.Object

org.jivesoftware.smackx.forward.packet.Forwarded<S>

All Implemented Interfaces:

Element, ExtensionElement, NamedElement, XmlElement, XmlLangElement

public class Forwarded<S extends Stanza>
extends Object
implements ExtensionElement

Stanza extension for XEP-0297: Stanza Forwarding.

See Also:

• XEP-0297: Stanza Forwarding

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ELEMENT
static final String	NAMESPACE
static final QName	QNAME

Constructor Summary

Constructors

Constructor	Description
Forwarded(DelayInformation delay, S forwardedStanza)	Deprecated. use Forwarded(Stanza, DelayInformation) instead.
Forwarded(S fwdPacket)	Creates a new Forwarded stanza extension.
Forwarded(S forwardedStanza, DelayInformation delay)	Creates a new Forwarded stanza extension.

Method Summary

Modifier and Type	Method	Description
static List<Message>	extractMessagesFrom(Collection<Forwarded<Message>> forwardedCollection)	Extract messages in a collection of forwarded elements.
static Forwarded<?>	from(Stanza packet)	Get the forwarded extension.
DelayInformation	getDelayInformation()	get the timestamp of the forwarded packet.
String	getElementName()	Returns the root element name.
S	getForwardedStanza()	Get the forwarded Stanza found in this extension.
String	getNamespace()	Returns the root element XML namespace.
boolean	isForwarded(Class<? extends Stanza> stanzaClass)	Check if this is forwarding a stanza of the provided class.
XmlStringBuilder	toXML(XmlEnvironment enclosingNamespace)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface Element

toXML, toXML

Methods inherited from interface XmlElement

getLanguage, getQName

Field Details

NAMESPACE

public static final String NAMESPACE

See Also:

• Constant Field Values

ELEMENT

public static final String ELEMENT

See Also:

• Constant Field Values

QNAME

public static final QName QNAME

Constructor Details

Forwarded

@Deprecated
public Forwarded(DelayInformation delay,
 S forwardedStanza)

Deprecated.

use Forwarded(Stanza, DelayInformation) instead.

Creates a new Forwarded stanza extension.

Parameters:

delay - an optional DelayInformation timestamp of the packet.

forwardedStanza - the stanza that is forwarded (required).

Forwarded

public Forwarded(S fwdPacket)

Creates a new Forwarded stanza extension.

Parameters:

fwdPacket - the stanza that is forwarded (required).

Forwarded

public Forwarded(S forwardedStanza,
 DelayInformation delay)

Creates a new Forwarded stanza extension.

Parameters:

forwardedStanza - the stanza that is forwarded (required).

delay - an optional DelayInformation timestamp of the packet.

Method Details

getElementName

public String getElementName()

Description copied from interface: NamedElement

Returns the root element name.

Specified by:

getElementName in interface NamedElement

Returns:

the element name.

getNamespace

public String getNamespace()

Description copied from interface: XmlElement

Returns the root element XML namespace.

Specified by:

getNamespace in interface XmlElement

Returns:

the namespace.

toXML

public XmlStringBuilder toXML(XmlEnvironment enclosingNamespace)

Specified by:

toXML in interface Element

getForwardedStanza

public S getForwardedStanza()

Get the forwarded Stanza found in this extension.

Returns:

the Stanza (typically a message) that was forwarded.

getDelayInformation

public DelayInformation getDelayInformation()

get the timestamp of the forwarded packet.

Returns:

the DelayInformation representing the time when the original stanza was sent. May be null.

isForwarded

public boolean isForwarded(Class<? extends Stanza> stanzaClass)

Check if this is forwarding a stanza of the provided class.

Parameters:

stanzaClass - the class to check for.

Returns:

true if this is forwarding a stanza of the provided class.

Since:

4.4

from

public static Forwarded<?> from(Stanza packet)

Get the forwarded extension.

Parameters:

packet - TODO javadoc me please

Returns:

the Forwarded extension or null

extractMessagesFrom

public static List<Message> extractMessagesFrom(Collection<Forwarded<Message>> forwardedCollection)

Extract messages in a collection of forwarded elements. Note that it is required that the Forwarded in the given collection only contain Message stanzas.

Parameters:

forwardedCollection - the collection to extract from.

Returns:

a list a the extracted messages.

Since:

4.3.0