org.jivesoftware.smackx.mam.element

Class MamQueryIQ

java.lang.Object

org.jivesoftware.smack.packet.Stanza

org.jivesoftware.smack.packet.IQ

org.jivesoftware.smackx.mam.element.MamQueryIQ

All Implemented Interfaces:

Element, TopLevelStreamElement

public class MamQueryIQ
extends IQ

MAM Query IQ class.

See Also:

XEP-0313: Message Archive Management

Nested Class Summary

Nested classes/interfaces inherited from class org.jivesoftware.smack.packet.IQ

IQ.IQChildElementXmlStringBuilder, IQ.Type

Field Summary

Fields

Modifier and Type	Field and Description
static String	ELEMENT the MAM query IQ element.
static String	NAMESPACE the MAM query IQ NAMESPACE.

Fields inherited from class org.jivesoftware.smack.packet.IQ

IQ_ELEMENT, QUERY_ELEMENT

Fields inherited from class org.jivesoftware.smack.packet.Stanza

DEFAULT_LANGUAGE, ITEM, language, TEXT

Constructor Summary

Constructors

Constructor and Description
MamQueryIQ(DataForm form) MAM query IQ constructor.
MamQueryIQ(String queryId) MAM query IQ constructor.
MamQueryIQ(String queryId, DataForm form) MAM query IQ constructor.
MamQueryIQ(String queryId, String node, DataForm dataForm) MAM query IQ constructor.

Method Summary

Modifier and Type	Method and Description
DataForm	getDataForm() Get the data form.
protected IQ.IQChildElementXmlStringBuilder	getIQChildElementBuilder(IQ.IQChildElementXmlStringBuilder xml) This method must be overwritten by IQ subclasses to create their child content.
String	getNode() Get the Node name.
String	getQueryId() Get query id.

Methods inherited from class org.jivesoftware.smack.packet.IQ

createErrorResponse, createErrorResponse, createErrorResponse, createResultIQ, getChildElementName, getChildElementNamespace, getChildElementXML, getChildElementXML, getType, initializeAsResultFor, initialzeAsResultFor, isRequestIQ, setType, toString, toXML

Methods inherited from class org.jivesoftware.smack.packet.Stanza

addCommonAttributes, addExtension, addExtensions, appendErrorIfExists, getDefaultLanguage, getError, getExtension, getExtension, getExtensions, getExtensions, getFrom, getLanguage, getPacketID, getStanzaId, getTo, hasExtension, hasExtension, hasStanzaIdSet, logCommonAttributes, overrideExtension, removeExtension, removeExtension, setError, setError, setFrom, setFrom, setLanguage, setPacketID, setStanzaId, setStanzaId, setTo, setTo

Methods inherited from class java.lang.Object

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

Field Detail

ELEMENT

public static final String ELEMENT

the MAM query IQ element.

See Also:

Constant Field Values

NAMESPACE

public static final String NAMESPACE

the MAM query IQ NAMESPACE.

See Also:

Constant Field Values

Constructor Detail

MamQueryIQ

public MamQueryIQ(String queryId)

MAM query IQ constructor.

Parameters:

queryId -

MamQueryIQ

public MamQueryIQ(DataForm form)

MAM query IQ constructor.

Parameters:

form -

MamQueryIQ

public MamQueryIQ(String queryId,
                  DataForm form)

MAM query IQ constructor.

Parameters:

queryId -

form -

MamQueryIQ

public MamQueryIQ(String queryId,
                  String node,
                  DataForm dataForm)

MAM query IQ constructor.

Parameters:

queryId -

node -

dataForm -

Method Detail

getQueryId

public String getQueryId()

Get query id.

Returns:

the query id

getNode

public String getNode()

Get the Node name.

Returns:

the node

getDataForm

public DataForm getDataForm()

Get the data form.

Returns:

the data form

getIQChildElementBuilder

protected IQ.IQChildElementXmlStringBuilder getIQChildElementBuilder(IQ.IQChildElementXmlStringBuilder xml)

Description copied from class: IQ

This method must be overwritten by IQ subclasses to create their child content. It is important you don't use the builder to add the final end tag. This will be done automatically by IQ.IQChildElementXmlStringBuilder after eventual existing ExtensionElements have been added.

For example to create an IQ with a extra attribute and an additional child element

 
 <iq to='foo@example.org' id='123'>
   <bar xmlns='example:bar' extraAttribute='blaz'>
      <extraElement>elementText</extraElement>
   </bar>
 </iq>
 
 

the body of the getIQChildElementBuilder looks like

 
 // The builder 'xml' will already have the child element and the 'xmlns' attribute added
 // So the current builder state is "<bar xmlns='example:bar'"
 xml.attribute("extraAttribute", "blaz");
 xml.rightAngleBracket();
 xml.element("extraElement", "elementText");
 // Do not close the 'bar' attribute by calling xml.closeElement('bar')
 
 

If your IQ only contains attributes and no child elements, i.e. it can be represented as empty element, then you can mark it as such.

 xml.attribute("myAttribute", "myAttributeValue");
 xml.setEmptyElement();
 

If your IQ does not contain any attributes or child elements (besides ExtensionElements), consider sub-classing SimpleIQ instead.

Specified by:

getIQChildElementBuilder in class IQ

Parameters:

xml - a pre-created builder which already has the child element and the 'xmlns' attribute set.

Returns:

the build to create the IQ child content.