org.jivesoftware.smackx.carbons.packet

Class CarbonExtension

java.lang.Object

org.jivesoftware.smackx.carbons.packet.CarbonExtension

All Implemented Interfaces:

org.jivesoftware.smack.packet.Element, org.jivesoftware.smack.packet.ExtensionElement, org.jivesoftware.smack.packet.NamedElement

public class CarbonExtension
extends java.lang.Object
implements org.jivesoftware.smack.packet.ExtensionElement

Stanza(/Packet) extension for XEP-0280: Message Carbons. The extension XEP-0280 is meant to synchronize a message flow to multiple presences of a user.

It accomplishes this by wrapping a Forwarded stanza(/packet) in a sent or received element

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CarbonExtension.Direction Defines the direction of a CarbonExtension message.
static class	CarbonExtension.Private Stanza(/Packet) extension indicating that a message may not be carbon-copied.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	NAMESPACE

Constructor Summary

Constructors

Constructor and Description
CarbonExtension(CarbonExtension.Direction dir, org.jivesoftware.smackx.forward.packet.Forwarded fwd) Construct a Carbon message extension.

Method Summary

Modifier and Type	Method and Description
static CarbonExtension	from(org.jivesoftware.smack.packet.Message msg) Obtain a Carbon from a message, if available.
CarbonExtension.Direction	getDirection() Get the direction (sent or received) of the carbon.
java.lang.String	getElementName()
org.jivesoftware.smackx.forward.packet.Forwarded	getForwarded() Get the forwarded packet.
static CarbonExtension	getFrom(org.jivesoftware.smack.packet.Message msg) Deprecated. use from(Message) instead
java.lang.String	getNamespace()
org.jivesoftware.smack.util.XmlStringBuilder	toXML()

Methods inherited from class java.lang.Object

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

Field Detail

NAMESPACE

public static final java.lang.String NAMESPACE

See Also:

Constant Field Values

Constructor Detail

CarbonExtension

public CarbonExtension(CarbonExtension.Direction dir,
                       org.jivesoftware.smackx.forward.packet.Forwarded fwd)

Construct a Carbon message extension.

Parameters:

dir - Determines if the carbon is being sent/received

fwd - The forwarded message.

Method Detail

getDirection

public CarbonExtension.Direction getDirection()

Get the direction (sent or received) of the carbon.

Returns:

the CarbonExtension.Direction of the carbon.

getForwarded

public org.jivesoftware.smackx.forward.packet.Forwarded getForwarded()

Get the forwarded packet.

Returns:

the Forwarded message contained in this Carbon.

getElementName

public java.lang.String getElementName()

Specified by:

getElementName in interface org.jivesoftware.smack.packet.NamedElement

getNamespace

public java.lang.String getNamespace()

Specified by:

getNamespace in interface org.jivesoftware.smack.packet.ExtensionElement

toXML

public org.jivesoftware.smack.util.XmlStringBuilder toXML()

Specified by:

toXML in interface org.jivesoftware.smack.packet.Element

getFrom

@Deprecated
public static CarbonExtension getFrom(org.jivesoftware.smack.packet.Message msg)

Deprecated. use from(Message) instead

Obtain a Carbon from a message, if available.

Only Message instances can contain a Carbon extensions.

Parameters:

msg - Message object to check for carbons

Returns:

a Carbon if available, null otherwise.

from

public static CarbonExtension from(org.jivesoftware.smack.packet.Message msg)

Obtain a Carbon from a message, if available.

Only Message instances can contain a Carbon extensions.

Parameters:

msg - Message object to check for carbons

Returns:

a Carbon if available, null otherwise.