org.jivesoftware.smackx.mam.element

Class MamPrefsIQ

java.lang.Object

org.jivesoftware.smack.packet.Stanza

org.jivesoftware.smack.packet.IQ

org.jivesoftware.smackx.mam.element.MamPrefsIQ

All Implemented Interfaces:

Element, TopLevelStreamElement

public class MamPrefsIQ
extends IQ

MAM Preferences IQ class.

See Also:

XEP-0313: Message Archive Management

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MamPrefsIQ.DefaultBehavior

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 preferences element.
static String	NAMESPACE the 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
MamPrefsIQ() Construct a new MAM <prefs/> IQ retrieval request (IQ type 'get').
MamPrefsIQ(List<org.jxmpp.jid.Jid> alwaysJids, List<org.jxmpp.jid.Jid> neverJids, MamPrefsIQ.DefaultBehavior defaultBehavior) MAM preferences IQ constructor.

Method Summary

Modifier and Type	Method and Description
List<org.jxmpp.jid.Jid>	getAlwaysJids() Get the list of always store info JIDs.
MamPrefsIQ.DefaultBehavior	getDefault() Get the default behavior.
protected IQ.IQChildElementXmlStringBuilder	getIQChildElementBuilder(IQ.IQChildElementXmlStringBuilder xml) This method must be overwritten by IQ subclasses to create their child content.
List<org.jxmpp.jid.Jid>	getNeverJids() Get the list of never store info JIDs.

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 preferences element.

See Also:

Constant Field Values

NAMESPACE

public static final String NAMESPACE

the IQ NAMESPACE.

See Also:

Constant Field Values

Constructor Detail

MamPrefsIQ

public MamPrefsIQ()

Construct a new MAM <prefs/> IQ retrieval request (IQ type 'get').

MamPrefsIQ

public MamPrefsIQ(List<org.jxmpp.jid.Jid> alwaysJids,
                  List<org.jxmpp.jid.Jid> neverJids,
                  MamPrefsIQ.DefaultBehavior defaultBehavior)

MAM preferences IQ constructor.

Parameters:

alwaysJids -

neverJids -

defaultBehavior -

Method Detail

getAlwaysJids

public List<org.jxmpp.jid.Jid> getAlwaysJids()

Get the list of always store info JIDs.

Returns:

the always list

getNeverJids

public List<org.jxmpp.jid.Jid> getNeverJids()

Get the list of never store info JIDs.

Returns:

the never list

getDefault

public MamPrefsIQ.DefaultBehavior getDefault()

Get the default behavior.

Returns:

the default behavior.

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.