Package org.jivesoftware.smackx.reference.element

Class ReferenceElement

java.lang.Object

org.jivesoftware.smackx.reference.element.ReferenceElement

All Implemented Interfaces:

Element, ExtensionElement, NamedElement, XmlElement, XmlLangElement

public class ReferenceElement
extends Object
implements ExtensionElement

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	ReferenceElement.Type

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ATTR_ANCHOR
static final String	ATTR_BEGIN
static final String	ATTR_END
static final String	ATTR_TYPE
static final String	ATTR_URI
static final String	ELEMENT
static final String	NAMESPACE
static final QName	QNAME

Constructor Summary

Constructors

Constructor	Description
ReferenceElement(Integer begin, Integer end, ReferenceElement.Type type, String anchor, URI uri)	XEP-Compliant constructor.
ReferenceElement(Integer begin, Integer end, ReferenceElement.Type type, String anchor, URI uri, XmlElement child)	XEP-incompliant (v0.2) constructor.

Method Summary

Modifier and Type	Method	Description
static void	addMention(Stanza stanza, int begin, int end, BareJid jid)	Add a reference to another users bare jid to a stanza.
static boolean	containsReferences(Stanza stanza)	Return true, if the stanza contains at least one reference extension.
String	getAnchor()
Integer	getBegin()
String	getElementName()	Returns the root element name.
Integer	getEnd()
String	getNamespace()	Returns the root element XML namespace.
static List<ReferenceElement>	getReferencesFromStanza(Stanza stanza)	Return a list of all reference extensions contained in a stanza.
ReferenceElement.Type	getType()
URI	getUri()
XmlStringBuilder	toXML(XmlEnvironment enclosingNamespace)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jivesoftware.smack.packet.Element

toXML, toXML

Methods inherited from interface org.jivesoftware.smack.packet.XmlElement

getLanguage, getQName

Field Details

ELEMENT

public static final String ELEMENT

See Also:

• Constant Field Values

NAMESPACE

public static final String NAMESPACE

See Also:

• Constant Field Values

QNAME

public static final QName QNAME

ATTR_BEGIN

public static final String ATTR_BEGIN

See Also:

• Constant Field Values

ATTR_END

public static final String ATTR_END

See Also:

• Constant Field Values

ATTR_TYPE

public static final String ATTR_TYPE

See Also:

• Constant Field Values

ATTR_ANCHOR

public static final String ATTR_ANCHOR

See Also:

• Constant Field Values

ATTR_URI

public static final String ATTR_URI

See Also:

• Constant Field Values

Constructor Details

ReferenceElement

public ReferenceElement(Integer begin,
 Integer end,
 ReferenceElement.Type type,
 String anchor,
 URI uri,
 XmlElement child)

XEP-incompliant (v0.2) constructor. This is needed for SIMS.

Parameters:

begin - TODO javadoc me please

end - TODO javadoc me please

type - TODO javadoc me please

anchor - TODO javadoc me please

uri - TODO javadoc me please

child - TODO javadoc me please

ReferenceElement

public ReferenceElement(Integer begin,
 Integer end,
 ReferenceElement.Type type,
 String anchor,
 URI uri)

XEP-Compliant constructor.

Parameters:

begin - TODO javadoc me please

end - TODO javadoc me please

type - TODO javadoc me please

anchor - TODO javadoc me please

uri - TODO javadoc me please

Method Details

getBegin

public Integer getBegin()

getEnd

public Integer getEnd()

getType

public ReferenceElement.Type getType()

getAnchor

public String getAnchor()

getUri

public URI getUri()

addMention

public static void addMention(Stanza stanza,
 int begin,
 int end,
 BareJid jid)

Add a reference to another users bare jid to a stanza.

Parameters:

stanza - stanza.

begin - start index of the mention in the messages body.

end - end index of the mention in the messages body.

jid - referenced jid.

getReferencesFromStanza

public static List<ReferenceElement> getReferencesFromStanza(Stanza stanza)

Return a list of all reference extensions contained in a stanza. If there are no reference elements, return an empty list.

Parameters:

stanza - stanza

Returns:

list of all references contained in the stanza

containsReferences

public static boolean containsReferences(Stanza stanza)

Return true, if the stanza contains at least one reference extension.

Parameters:

stanza - stanza

Returns:

true if stanza contains references

getNamespace

public String getNamespace()

Description copied from interface: XmlElement

Returns the root element XML namespace.

Specified by:

getNamespace in interface XmlElement

Returns:

the namespace.

getElementName

public String getElementName()

Description copied from interface: NamedElement

Returns the root element name.

Specified by:

getElementName in interface NamedElement

Returns:

the element name.

toXML

public XmlStringBuilder toXML(XmlEnvironment enclosingNamespace)

Specified by:

toXML in interface Element