Class AdHocCommandData
- java.lang.Object
-
- org.jivesoftware.smack.packet.Stanza
-
- org.jivesoftware.smack.packet.IQ
-
- org.jivesoftware.smackx.commands.packet.AdHocCommandData
-
- All Implemented Interfaces:
Element,FullyQualifiedElement,IqView,NamedElement,StanzaView,TopLevelStreamElement,XmlLangElement
public class AdHocCommandData extends IQ
Represents the state and the request of the execution of an adhoc command.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classAdHocCommandData.SpecificError-
Nested classes/interfaces inherited from class org.jivesoftware.smack.packet.IQ
IQ.IQChildElementXmlStringBuilder, IQ.ResponseType, IQ.Type
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.StringELEMENTstatic java.lang.StringNAMESPACE-
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 Description AdHocCommandData()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidaddAction(AdHocCommand.Action action)voidaddNote(AdHocCommandNote note)AdHocCommand.ActiongetAction()Returns the action to execute.java.util.List<AdHocCommand.Action>getActions()AdHocCommand.ActiongetExecuteAction()DataFormgetForm()Returns the form of the command.JidgetId()Returns the JID of the command host.protected IQ.IQChildElementXmlStringBuildergetIQChildElementBuilder(IQ.IQChildElementXmlStringBuilder xml)This method must be overwritten by IQ subclasses to create their child content.java.lang.StringgetName()Returns the human name of the command.java.lang.StringgetNode()Returns the identifier of the command.java.util.List<AdHocCommandNote>getNotes()Returns the list of notes that the command has.java.lang.StringgetSessionID()AdHocCommand.StatusgetStatus()Returns the status of the execution.voidremoveNote(AdHocCommandNote note)voidsetAction(AdHocCommand.Action action)voidsetExecuteAction(AdHocCommand.Action executeAction)voidsetForm(DataForm form)voidsetId(Jid id)voidsetName(java.lang.String name)voidsetNode(java.lang.String node)voidsetSessionID(java.lang.String sessionID)Set the 'sessionid' attribute of the command.voidsetStatus(AdHocCommand.Status status)-
Methods inherited from class org.jivesoftware.smack.packet.IQ
createErrorResponse, createErrorResponse, createErrorResponse, createResultIQ, getChildElementName, getChildElementNamespace, getChildElementQName, getChildElementXML, getElementName, getType, setType, toString, toXML
-
Methods inherited from class org.jivesoftware.smack.packet.Stanza
addCommonAttributes, addExtension, addExtensions, appendErrorIfExists, getDefaultLanguage, getError, getExtension, getExtension, getExtension, getExtensionElement, getExtensions, getExtensions, getExtensions, getExtensions, getExtensionsMap, getFrom, getLanguage, getNamespace, getStanzaId, getTo, hasExtension, hasExtension, hasStanzaIdSet, logCommonAttributes, overrideExtension, removeExtension, removeExtension, setError, setError, setFrom, setLanguage, setNewStanzaId, setStanzaId, setStanzaId, setTo, throwIfNoStanzaId
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface org.jivesoftware.smack.packet.FullyQualifiedElement
getQName
-
Methods inherited from interface org.jivesoftware.smack.packet.IqView
isRequestIQ, isResponseIQ
-
Methods inherited from interface org.jivesoftware.smack.packet.StanzaView
getError, getExtension, getExtension, getExtensions, getExtensions, getExtensions, getFrom, getStanzaId, getTo, hasExtension, hasExtension, hasExtension
-
-
-
-
Field Detail
-
ELEMENT
public static final java.lang.String ELEMENT
- See Also:
- Constant Field Values
-
NAMESPACE
public static final java.lang.String NAMESPACE
- See Also:
- Constant Field Values
-
-
Constructor Detail
-
AdHocCommandData
public AdHocCommandData()
-
-
Method Detail
-
getIQChildElementBuilder
protected IQ.IQChildElementXmlStringBuilder getIQChildElementBuilder(IQ.IQChildElementXmlStringBuilder xml)
Description copied from class:IQThis 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 byIQ.IQChildElementXmlStringBuilderafter eventual existingExtensionElements have been added.For example to create an IQ with a extra attribute and an additional child element
the body of the<iq to='foo@example.org' id='123'> <bar xmlns='example:bar' extraAttribute='blaz'> <extraElement>elementText</extraElement> </bar> </iq>getIQChildElementBuilderlooks like
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.// 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')xml.attribute("myAttribute", "myAttributeValue"); xml.setEmptyElement();If your IQ does not contain any attributes or child elements (besidesExtensionElements), consider sub-classingSimpleIQinstead.- Specified by:
getIQChildElementBuilderin classIQ- 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.
-
getName
public java.lang.String getName()
Returns the human name of the command.- Returns:
- the name of the command.
-
setName
public void setName(java.lang.String name)
-
getNode
public java.lang.String getNode()
Returns the identifier of the command.- Returns:
- the node.
-
setNode
public void setNode(java.lang.String node)
-
getNotes
public java.util.List<AdHocCommandNote> getNotes()
Returns the list of notes that the command has.- Returns:
- the notes.
-
addNote
public void addNote(AdHocCommandNote note)
-
removeNote
public void removeNote(AdHocCommandNote note)
-
getForm
public DataForm getForm()
Returns the form of the command.- Returns:
- the data form associated with the command.
-
getAction
public AdHocCommand.Action getAction()
Returns the action to execute. The action is set only on a request.- Returns:
- the action to execute.
-
setAction
public void setAction(AdHocCommand.Action action)
-
getStatus
public AdHocCommand.Status getStatus()
Returns the status of the execution.- Returns:
- the status.
-
setStatus
public void setStatus(AdHocCommand.Status status)
-
getActions
public java.util.List<AdHocCommand.Action> getActions()
-
addAction
public void addAction(AdHocCommand.Action action)
-
setExecuteAction
public void setExecuteAction(AdHocCommand.Action executeAction)
-
getExecuteAction
public AdHocCommand.Action getExecuteAction()
-
setSessionID
public void setSessionID(java.lang.String sessionID)
Set the 'sessionid' attribute of the command.This value can be null or empty for the first command, but MUST be set for subsequent commands. See also XEP-0050 ยง 3.3 Session Lifetime.
- Parameters:
sessionID- TODO javadoc me please
-
getSessionID
public java.lang.String getSessionID()
-
-