Smack

org.jivesoftware.smackx.packet
Class DiscoverItems

java.lang.Object
  extended by org.jivesoftware.smack.packet.Packet
      extended by org.jivesoftware.smack.packet.IQ
          extended by org.jivesoftware.smackx.packet.DiscoverItems

public class DiscoverItems
extends IQ

A DiscoverItems IQ packet, which is used by XMPP clients to request and receive items associated with XMPP entities.

The items could also be queried in order to discover if they contain items inside. Some items may be addressable by its JID and others may require to be addressed by a JID and a node name.

Author:
Gaston Dombiak

Nested Class Summary
static class DiscoverItems.Item
          An item is associated with an XMPP Entity, usually thought of a children of the parent entity and normally are addressable as a JID.
 
Nested classes/interfaces inherited from class org.jivesoftware.smack.packet.IQ
IQ.Type
 
Field Summary
 
Fields inherited from class org.jivesoftware.smack.packet.Packet
ID_NOT_AVAILABLE
 
Constructor Summary
DiscoverItems()
           
 
Method Summary
 void addItem(DiscoverItems.Item item)
          Adds a new item to the discovered information.
 String getChildElementXML()
          Returns the sub-element XML section of the IQ packet, or null if there isn't one.
 Iterator<DiscoverItems.Item> getItems()
          Returns the discovered items of the queried XMPP entity.
 String getNode()
          Returns the node attribute that supplements the 'jid' attribute.
 void setNode(String node)
          Sets the node attribute that supplements the 'jid' attribute.
 
Methods inherited from class org.jivesoftware.smack.packet.IQ
getType, setType, toXML
 
Methods inherited from class org.jivesoftware.smack.packet.Packet
addExtension, deleteProperty, getError, getExtension, getExtension, getExtensions, getExtensionsXML, getFrom, getPacketID, getProperty, getPropertyNames, getTo, removeExtension, setError, setFrom, setPacketID, setProperty, setTo
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DiscoverItems

public DiscoverItems()
Method Detail

addItem

public void addItem(DiscoverItems.Item item)
Adds a new item to the discovered information.

Parameters:
item - the discovered entity's item

getItems

public Iterator<DiscoverItems.Item> getItems()
Returns the discovered items of the queried XMPP entity.

Returns:
an Iterator on the discovered entity's items

getNode

public String getNode()
Returns the node attribute that supplements the 'jid' attribute. A node is merely something that is associated with a JID and for which the JID can provide information.

Node attributes SHOULD be used only when trying to provide or query information which is not directly addressable.

Returns:
the node attribute that supplements the 'jid' attribute

setNode

public void setNode(String node)
Sets the node attribute that supplements the 'jid' attribute. A node is merely something that is associated with a JID and for which the JID can provide information.

Node attributes SHOULD be used only when trying to provide or query information which is not directly addressable.

Parameters:
node - the node attribute that supplements the 'jid' attribute

getChildElementXML

public String getChildElementXML()
Description copied from class: IQ
Returns the sub-element XML section of the IQ packet, or null if there isn't one. Packet extensions must be included, if any are defined.

Extensions of this class must override this method.

Specified by:
getChildElementXML in class IQ
Returns:
the child element section of the IQ XML.

Smack

Copyright © 2003-2007 Jive Software.