Package org.jivesoftware.smackx.ox.element

Class OpenPgpContentElement

java.lang.Object

org.jivesoftware.smackx.ox.element.OpenPgpContentElement

All Implemented Interfaces:

Element, ExtensionElement, NamedElement, XmlElement, XmlLangElement

Direct Known Subclasses:

EncryptedOpenPgpContentElement, SignElement

public abstract class OpenPgpContentElement
extends Object
implements ExtensionElement

This class describes an OpenPGP content element. It defines the elements and fields that OpenPGP content elements do have in common.

Field Summary

Fields

Modifier and Type	Field	Description
static String	ATTR_JID
static String	ATTR_STAMP
static String	ELEM_PAYLOAD
static String	ELEM_TIME
static String	ELEM_TO

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	OpenPgpContentElement(Set<? extends Jid> to, Date timestamp, List<ExtensionElement> payload)

Method Summary

Modifier and Type	Method	Description
protected void	addCommonXml(XmlStringBuilder xml)
protected void	ensureTimestampStringSet()
ExtensionElement	getExtension(String namespace)	Returns the first extension of this stanza that has the given namespace.
<PE extends ExtensionElement> PE	getExtension(String elementName, String namespace)	Returns the first extension that matches the specified element name and namespace, or null if it doesn't exist.
List<XmlElement>	getExtensions()	Return the payload of the message.
List<XmlElement>	getExtensions(String elementName, String namespace)	Return a list of all extensions with the given element name and namespace.
String	getNamespace()	Returns the root element XML namespace.
Date	getTimestamp()	Return the timestamp on which the encrypted element has been created.
Set<? extends Jid>	getTo()	Return the set of recipients.
InputStream	toInputStream()	Return a ByteArrayInputStream that reads the bytes of the XML representation of this element.

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, toXML

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

getElementName

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

getLanguage, getQName

Field Detail

ELEM_TO

public static final String ELEM_TO

See Also:

Constant Field Values

ATTR_JID

public static final String ATTR_JID

See Also:

Constant Field Values

ELEM_TIME

public static final String ELEM_TIME

See Also:

Constant Field Values

ATTR_STAMP

public static final String ATTR_STAMP

See Also:

Constant Field Values

ELEM_PAYLOAD

public static final String ELEM_PAYLOAD

See Also:

Constant Field Values

Constructor Detail

OpenPgpContentElement

protected OpenPgpContentElement(Set<? extends Jid> to,
                                Date timestamp,
                                List<ExtensionElement> payload)

Method Detail

getTo

public final Set<? extends Jid> getTo()

Return the set of recipients.

Returns:

recipients.

getTimestamp

public final Date getTimestamp()

Return the timestamp on which the encrypted element has been created. This should be checked for sanity by the client.

Returns:

timestamp.

getExtensions

public final List<XmlElement> getExtensions()

Return the payload of the message.

Returns:

payload.

getExtensions

public List<XmlElement> getExtensions(String elementName,
                                      String namespace)

Return a list of all extensions with the given element name and namespace.

Changes to the returned set will update the stanza extensions, if the returned set is not the empty set.

Parameters:

elementName - the element name, must not be null.

namespace - the namespace of the element(s), must not be null.

Returns:

a set of all matching extensions.

getExtension

public ExtensionElement getExtension(String namespace)

Returns the first extension of this stanza that has the given namespace.

When possible, use getExtension(String, String) instead.

Parameters:

namespace - the namespace of the extension that is desired.

Returns:

the stanza extension with the given namespace.

getExtension

public <PE extends ExtensionElement> PE getExtension(String elementName,
                                                     String namespace)

Returns the first extension that matches the specified element name and namespace, or null if it doesn't exist. If the provided elementName is null, only the namespace is matched. Extensions are are arbitrary XML elements in standard XMPP stanzas.

Type Parameters:

PE - type of the ExtensionElement.

Parameters:

elementName - the XML element name of the extension. (May be null)

namespace - the XML element namespace of the extension.

Returns:

the extension, or null if it doesn't exist.

getNamespace

public String getNamespace()

Description copied from interface: XmlElement

Returns the root element XML namespace.

Specified by:

getNamespace in interface XmlElement

Returns:

the namespace.

ensureTimestampStringSet

protected void ensureTimestampStringSet()

addCommonXml

protected void addCommonXml(XmlStringBuilder xml)

toInputStream

public InputStream toInputStream()

Return a ByteArrayInputStream that reads the bytes of the XML representation of this element.

Returns:

InputStream over xml.