Package org.jivesoftware.smackx.message_fastening.element

Class FasteningElement

java.lang.Object

org.jivesoftware.smackx.message_fastening.element.FasteningElement

All Implemented Interfaces:

Element, ExtensionElement, NamedElement, XmlElement, XmlLangElement

public final class FasteningElement
extends Object
implements ExtensionElement

Message Fastening container element.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	FasteningElement.Builder

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ATTR_CLEAR
static final String	ATTR_ID
static final String	ATTR_SHELL
static final String	ELEMENT
static final String	NAMESPACE

Method Summary

Modifier and Type	Method	Description
void	applyTo(MessageBuilder messageBuilder)	Add this element to the provided message builder.
static FasteningElement.Builder	builder()
static FasteningElement	createShellElementForSensitiveElement(String originIdOfSensitiveElement)
static FasteningElement	createShellElementForSensitiveElement(FasteningElement sensitiveElement)
static FasteningElement	createShellElementForSensitiveElement(OriginIdElement originIdOfSensitiveElement)
String	getElementName()	Returns the root element name.
List<ExternalElement>	getExternalPayloads()	Return all external payloads of this element.
String	getNamespace()	Returns the root element XML namespace.
OriginIdElement	getReferencedStanzasOriginId()	Return the origin-id of the Stanza that the message fastenings are to be applied to.
List<XmlElement>	getWrappedPayloads()	Return all wrapped payloads of this element.
static boolean	hasFasteningElement(Message message)	Return true if the provided Message contains a FasteningElement.
static boolean	hasFasteningElement(MessageBuilder builder)	Return true if the provided MessageBuilder contains a FasteningElement.
boolean	isRemovingElement()	Does this element remove a previously sent FasteningElement?
boolean	isShellElement()	Is this a shell element? Shell elements are otherwise empty elements that indicate that an encrypted payload of a message encrypted using XEP-420: Stanza Content Encryption contains a sensitive FasteningElement.
XmlStringBuilder	toXML(XmlEnvironment xmlEnvironment)

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

ATTR_ID

public static final String ATTR_ID

See Also:

• Constant Field Values

ATTR_CLEAR

public static final String ATTR_CLEAR

See Also:

• Constant Field Values

ATTR_SHELL

public static final String ATTR_SHELL

See Also:

• Constant Field Values

Method Details

getReferencedStanzasOriginId

public OriginIdElement getReferencedStanzasOriginId()

Return the origin-id of the Stanza that the message fastenings are to be applied to.

Returns:

origin id of the referenced stanza

getWrappedPayloads

public List<XmlElement> getWrappedPayloads()

Return all wrapped payloads of this element.

Returns:

wrapped payloads.

See Also:

• XEP-0422: §3.1. Wrapped Payloads

getExternalPayloads

public List<ExternalElement> getExternalPayloads()

Return all external payloads of this element.

Returns:

external payloads.

See Also:

• XEP-0422: §3.2. External Payloads

isRemovingElement

public boolean isRemovingElement()

Does this element remove a previously sent FasteningElement?

Returns:

true if the clear attribute is set.

See Also:

• XEP-0422: Message Fastening §3.4 Removing fastenings

isShellElement

public boolean isShellElement()

Is this a shell element? Shell elements are otherwise empty elements that indicate that an encrypted payload of a message encrypted using XEP-420: Stanza Content Encryption contains a sensitive FasteningElement.

Returns:

true if this is a shell element.

See Also:

• XEP-0422: Message Fastening §3.5 Interaction with stanza encryption

hasFasteningElement

public static boolean hasFasteningElement(Message message)

Return true if the provided Message contains a FasteningElement.

Parameters:

message - message

Returns:

true if the stanza has an FasteningElement.

hasFasteningElement

public static boolean hasFasteningElement(MessageBuilder builder)

Return true if the provided MessageBuilder contains a FasteningElement.

Parameters:

builder - message builder

Returns:

true if the stanza has an FasteningElement.

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 xmlEnvironment)

Specified by:

toXML in interface Element

createShellElementForSensitiveElement

public static FasteningElement createShellElementForSensitiveElement(FasteningElement sensitiveElement)

createShellElementForSensitiveElement

public static FasteningElement createShellElementForSensitiveElement(String originIdOfSensitiveElement)

createShellElementForSensitiveElement

public static FasteningElement createShellElementForSensitiveElement(OriginIdElement originIdOfSensitiveElement)

applyTo

public void applyTo(MessageBuilder messageBuilder)

Add this element to the provided message builder. Note: The stanza MUST NOT contain more than one apply-to elements at the same time.

Parameters:

messageBuilder - message builder

See Also:

• XEP-0422 §4: Business Rules

builder

public static FasteningElement.Builder builder()