org.jivesoftware.smackx.pubsub

Class ItemsExtension

java.lang.Object

org.jivesoftware.smackx.pubsub.NodeExtension

org.jivesoftware.smackx.pubsub.ItemsExtension

All Implemented Interfaces:

Element, ExtensionElement, NamedElement, EmbeddedPacketExtension

public class ItemsExtension
extends NodeExtension
implements EmbeddedPacketExtension

This class is used for multiple purposes.

• It can represent an event containing a list of items that have been published
• It can represent an event containing a list of retracted (deleted) items.
• It can represent a request to delete a list of items.
• It can represent a request to get existing items.

Please note, this class is used for internal purposes, and is not required for usage of pubsub functionality.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ItemsExtension.ItemsElementType

Field Summary

Fields

Modifier and Type	Field and Description
protected List<? extends NamedElement>	items
protected Boolean	notify
protected ItemsExtension.ItemsElementType	type

Constructor Summary

Constructors

Constructor and Description
ItemsExtension(ItemsExtension.ItemsElementType itemsType, String nodeId, List<? extends NamedElement> items) Construct an instance with a list representing items that have been published or deleted.
ItemsExtension(String nodeId, List<? extends ExtensionElement> items, boolean notify) Construct an instance with a list representing items that have been published or deleted.

Method Summary

Modifier and Type	Method and Description
List<ExtensionElement>	getExtensions() Get the list of embedded ExtensionElement objects.
List<? extends NamedElement>	getItems() Gets the items related to the type of request or event.
ItemsExtension.ItemsElementType	getItemsElementType() Get the type of element.
boolean	getNotify() Gets the value of the optional attribute related to the ItemsExtension.ItemsElementType.
String	toString()
CharSequence	toXML(String enclosingNamespace) Returns the XML representation of this Element.

Methods inherited from class org.jivesoftware.smackx.pubsub.NodeExtension

getElementName, getNamespace, getNode, getPubSubNamespace

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.ExtensionElement

getNamespace

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

getElementName

Field Detail

type

protected ItemsExtension.ItemsElementType type

notify

protected Boolean notify

items

protected List<? extends NamedElement> items

Constructor Detail

ItemsExtension

public ItemsExtension(ItemsExtension.ItemsElementType itemsType,
                      String nodeId,
                      List<? extends NamedElement> items)

Construct an instance with a list representing items that have been published or deleted.

Valid scenarios are:

• Request items from node - itemsType = ItemsExtension.ItemsElementType.items, items = list of Item and an optional value for the max_items attribute.
• Request to delete items - itemsType = ItemsExtension.ItemsElementType.retract, items = list of Item containing only id's and an optional value for the notify attribute.
• Items published event - itemsType = ItemsExtension.ItemsElementType.items, items = list of Item and attributeValue = null
• Items deleted event - itemsType = ItemsExtension.ItemsElementType.items, items = list of RetractItem and attributeValue = null

Parameters:

itemsType - Type of representation

nodeId - The node to which the items are being sent or deleted

items - The list of Item or RetractItem

ItemsExtension

public ItemsExtension(String nodeId,
                      List<? extends ExtensionElement> items,
                      boolean notify)

Construct an instance with a list representing items that have been published or deleted.

Valid scenarios are:

• Request items from node - itemsType = ItemsExtension.ItemsElementType.items, items = list of Item and an optional value for the max_items attribute.
• Request to delete items - itemsType = ItemsExtension.ItemsElementType.retract, items = list of Item containing only id's and an optional value for the notify attribute.
• Items published event - itemsType = ItemsExtension.ItemsElementType.items, items = list of Item and attributeValue = null
• Items deleted event - itemsType = ItemsExtension.ItemsElementType.items, items = list of RetractItem and attributeValue = null

Parameters:

nodeId - The node to which the items are being sent or deleted

items - The list of Item or RetractItem

notify -

Method Detail

getItemsElementType

public ItemsExtension.ItemsElementType getItemsElementType()

Get the type of element.

Returns:

The element type

getExtensions

public List<ExtensionElement> getExtensions()

Description copied from interface: EmbeddedPacketExtension

Get the list of embedded ExtensionElement objects.

Specified by:

getExtensions in interface EmbeddedPacketExtension

Returns:

List of embedded ExtensionElement

getItems

public List<? extends NamedElement> getItems()

Gets the items related to the type of request or event.

Returns:

List of Item, RetractItem, or null

getNotify

public boolean getNotify()

Gets the value of the optional attribute related to the ItemsExtension.ItemsElementType.

Returns:

The attribute value

toXML

public CharSequence toXML(String enclosingNamespace)

Description copied from interface: Element

Returns the XML representation of this Element. This method takes an optional argument for the enclosing namespace which may be null or the empty String if the value is not known.

Specified by:

toXML in interface Element

Overrides:

toXML in class NodeExtension

Parameters:

enclosingNamespace - the enclosing namespace or null.

Returns:

the stanza extension as XML.

toString

public String toString()

Overrides:

toString in class NodeExtension