org.jivesoftware.smackx.pubsub

Class Subscription

java.lang.Object

org.jivesoftware.smackx.pubsub.NodeExtension

org.jivesoftware.smackx.pubsub.Subscription

All Implemented Interfaces:

Element, ExtensionElement, NamedElement

public class Subscription
extends NodeExtension

Represents a subscription to node for both requests and replies.

Author:

Robin Collier

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Subscription.State

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	configRequired
protected String	id
protected String	jid
protected Subscription.State	state

Constructor Summary

Constructors

Constructor and Description
Subscription(String subscriptionJid) Used to constructs a subscription request to the root node with the specified JID.
Subscription(String subscriptionJid, String nodeId) Used to constructs a subscription request to the specified node with the specified JID.
Subscription(String jid, String nodeId, String subscriptionId, Subscription.State state) Constructs a representation of a subscription reply to the specified node and JID.
Subscription(String jid, String nodeId, String subscriptionId, Subscription.State state, boolean configRequired) Constructs a representation of a subscription reply to the specified node and JID.

Method Summary

Modifier and Type	Method and Description
String	getId() Gets the subscription id
String	getJid() Gets the JID the subscription is created for
Subscription.State	getState() Gets the current subscription state.
boolean	isConfigRequired() This value is only relevant when the getState() is Subscription.State.unconfigured
String	toXML() Returns the XML representation of this Element.

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

getElementName, getNamespace, getNode, toString

Methods inherited from class java.lang.Object

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

Field Detail

jid

protected String jid

id

protected String id

state

protected Subscription.State state

configRequired

protected boolean configRequired

Constructor Detail

Subscription

public Subscription(String subscriptionJid)

Used to constructs a subscription request to the root node with the specified JID.

Parameters:

subscriptionJid - The subscriber JID

Subscription

public Subscription(String subscriptionJid,
                    String nodeId)

Used to constructs a subscription request to the specified node with the specified JID.

Parameters:

subscriptionJid - The subscriber JID

nodeId - The node id

Subscription

public Subscription(String jid,
                    String nodeId,
                    String subscriptionId,
                    Subscription.State state)

Constructs a representation of a subscription reply to the specified node and JID. The server will have supplied the subscription id and current state.

Parameters:

jid - The JID the request was made under

nodeId - The node subscribed to

subscriptionId - The id of this subscription

state - The current state of the subscription

Subscription

public Subscription(String jid,
                    String nodeId,
                    String subscriptionId,
                    Subscription.State state,
                    boolean configRequired)

Constructs a representation of a subscription reply to the specified node and JID. The server will have supplied the subscription id and current state and whether the subscription need to be configured.

Parameters:

jid - The JID the request was made under

nodeId - The node subscribed to

subscriptionId - The id of this subscription

state - The current state of the subscription

configRequired - Is configuration required to complete the subscription

Method Detail

getJid

public String getJid()

Gets the JID the subscription is created for

Returns:

The JID

getId

public String getId()

Gets the subscription id

Returns:

The subscription id

getState

public Subscription.State getState()

Gets the current subscription state.

Returns:

Current subscription state

isConfigRequired

public boolean isConfigRequired()

This value is only relevant when the getState() is Subscription.State.unconfigured

Returns:

true if configuration is required, false otherwise

toXML

public String toXML()

Description copied from interface: Element

Returns the XML representation of this Element.

Specified by:

toXML in interface Element

Overrides:

toXML in class NodeExtension

Returns:

the stanza(/packet) extension as XML.