org.jivesoftware.smackx.disco.packet

Class DiscoverInfo

java.lang.Object

org.jivesoftware.smack.packet.Stanza

org.jivesoftware.smack.packet.IQ

org.jivesoftware.smackx.disco.packet.DiscoverInfo

All Implemented Interfaces:

org.jivesoftware.smack.packet.Element, org.jivesoftware.smack.packet.FullyQualifiedElement, org.jivesoftware.smack.packet.IqView, org.jivesoftware.smack.packet.NamedElement, org.jivesoftware.smack.packet.StanzaView, org.jivesoftware.smack.packet.TopLevelStreamElement, org.jivesoftware.smack.packet.XmlLangElement, DiscoverInfoView

public class DiscoverInfo
extends org.jivesoftware.smack.packet.IQ
implements DiscoverInfoView

A DiscoverInfo IQ packet, which is used by XMPP clients to request and receive information to/from other XMPP entities.

The received information may contain one or more identities of the requested XMPP entity, and a list of supported features by the requested XMPP entity.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DiscoverInfo.Feature Represents the features offered by the item.
static class	DiscoverInfo.Identity Represents the identity of a given XMPP entity.

Nested classes/interfaces inherited from class org.jivesoftware.smack.packet.IQ

org.jivesoftware.smack.packet.IQ.IQChildElementXmlStringBuilder, org.jivesoftware.smack.packet.IQ.ResponseType, org.jivesoftware.smack.packet.IQ.Type

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ELEMENT
static java.lang.String	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
DiscoverInfo() Deprecated. use DiscoverInfoBuilder instead.
DiscoverInfo(DiscoverInfo d) Copy constructor.

Method Summary

Modifier and Type	Method and Description
boolean	addFeature(DiscoverInfo.Feature feature) Deprecated. use DiscoverInfoBuilder.addFeature(DiscoverInfo.Feature) instead.
boolean	addFeature(java.lang.String feature) Deprecated. use DiscoverInfoBuilder.addFeature(String) instead.
void	addFeatures(java.util.Collection<java.lang.String> featuresToAdd) Deprecated. use DiscoverInfoBuilder.addFeatures(Collection) instead.
void	addIdentities(java.util.Collection<DiscoverInfo.Identity> identitiesToAdd) Deprecated. use DiscoverInfoBuilder.addIdentities(Collection) instead.
void	addIdentity(DiscoverInfo.Identity identity) Deprecated. use DiscoverInfoBuilder.addIdentity(DiscoverInfo.Identity) instead.
DiscoverInfoBuilder	asBuilder(java.lang.String stanzaId)
static DiscoverInfoBuilder	builder(org.jivesoftware.smack.packet.IqData iqData)
static DiscoverInfoBuilder	builder(java.lang.String stanzaId)
static DiscoverInfoBuilder	builder(org.jivesoftware.smack.XMPPConnection connection)
DiscoverInfo	clone() Deprecated. use asBuilder(String) instead.
boolean	containsDuplicateFeatures() Test if a DiscoverInfo response contains duplicate features.
boolean	containsDuplicateIdentities() Test if a DiscoverInfo response contains duplicate identities.
boolean	containsFeature(java.lang.CharSequence feature) Returns true if the specified feature is part of the discovered information.
java.util.List<DiscoverInfo.Feature>	getFeatures() Returns the discovered features of an XMPP entity.
java.util.List<DiscoverInfo.Identity>	getIdentities() Returns the discovered identities of an XMPP entity.
java.util.List<DiscoverInfo.Identity>	getIdentities(java.lang.String category, java.lang.String type) Returns all Identities of the given category and type of this DiscoverInfo.
protected org.jivesoftware.smack.packet.IQ.IQChildElementXmlStringBuilder	getIQChildElementBuilder(org.jivesoftware.smack.packet.IQ.IQChildElementXmlStringBuilder xml)
java.lang.String	getNode() Returns the node attribute that supplements the 'jid' attribute.
boolean	hasIdentity(java.lang.String category, java.lang.String type) Returns true if this DiscoverInfo contains at least one Identity of the given category and type.
static boolean	nullSafeContainsFeature(DiscoverInfo discoverInfo, java.lang.CharSequence feature)
void	setNode(java.lang.String node) Deprecated. use DiscoverInfoBuilder.setNode(String) instead.

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

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

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

getType, isRequestIQ, isResponseIQ

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

getError, getExtension, getExtension, getExtensions, getExtensions, getExtensions, getFrom, getStanzaId, getTo, hasExtension, hasExtension, hasExtension

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

getLanguage

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

getQName

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

toXML, toXML

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

DiscoverInfo

@Deprecated
public DiscoverInfo()

Deprecated. use DiscoverInfoBuilder instead.

Deprecated.

DiscoverInfo

public DiscoverInfo(DiscoverInfo d)

Copy constructor.

Parameters:

d - TODO javadoc me please

Method Detail

addFeature

@Deprecated
public boolean addFeature(java.lang.String feature)

Deprecated. use DiscoverInfoBuilder.addFeature(String) instead.

Adds a new feature to the discovered information.

Parameters:

feature - the discovered feature

Returns:

true if the feature did not already exist.

addFeatures

@Deprecated
public void addFeatures(java.util.Collection<java.lang.String> featuresToAdd)

Deprecated. use DiscoverInfoBuilder.addFeatures(Collection) instead.

Adds a collection of features to the packet. Does noting if featuresToAdd is null.

Parameters:

featuresToAdd - TODO javadoc me please

addFeature

@Deprecated
public boolean addFeature(DiscoverInfo.Feature feature)

Deprecated. use DiscoverInfoBuilder.addFeature(DiscoverInfo.Feature) instead.

Deprecated.

Parameters:

feature - the future.

Returns:

true if the feature is new.

getFeatures

public java.util.List<DiscoverInfo.Feature> getFeatures()

Description copied from interface: DiscoverInfoView

Returns the discovered features of an XMPP entity.

Specified by:

getFeatures in interface DiscoverInfoView

Returns:

an unmodifiable list of the discovered features of an XMPP entity

addIdentity

@Deprecated
public void addIdentity(DiscoverInfo.Identity identity)

Deprecated. use DiscoverInfoBuilder.addIdentity(DiscoverInfo.Identity) instead.

Adds a new identity of the requested entity to the discovered information.

Parameters:

identity - the discovered entity's identity

addIdentities

@Deprecated
public void addIdentities(java.util.Collection<DiscoverInfo.Identity> identitiesToAdd)

Deprecated. use DiscoverInfoBuilder.addIdentities(Collection) instead.

Adds identities to the DiscoverInfo stanza.

Parameters:

identitiesToAdd - TODO javadoc me please

getIdentities

public java.util.List<DiscoverInfo.Identity> getIdentities()

Description copied from interface: DiscoverInfoView

Returns the discovered identities of an XMPP entity.

Specified by:

getIdentities in interface DiscoverInfoView

Returns:

an unmodifiable list of the discovered identities

hasIdentity

public boolean hasIdentity(java.lang.String category,
                           java.lang.String type)

Returns true if this DiscoverInfo contains at least one Identity of the given category and type.

Parameters:

category - the category to look for.

type - the type to look for.

Returns:

true if this DiscoverInfo contains a Identity of the given category and type.

getIdentities

public java.util.List<DiscoverInfo.Identity> getIdentities(java.lang.String category,
                                                           java.lang.String type)

Returns all Identities of the given category and type of this DiscoverInfo.

Parameters:

category - category the category to look for.

type - type the type to look for.

Returns:

a list of Identites with the given category and type.

getNode

public java.lang.String getNode()

Description copied from interface: DiscoverInfoView

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.

Specified by:

getNode in interface DiscoverInfoView

Returns:

the node attribute that supplements the 'jid' attribute

setNode

@Deprecated
public void setNode(java.lang.String node)

Deprecated. use DiscoverInfoBuilder.setNode(String) instead.

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

containsFeature

public boolean containsFeature(java.lang.CharSequence feature)

Returns true if the specified feature is part of the discovered information.

Parameters:

feature - the feature to check

Returns:

true if the requests feature has been discovered

nullSafeContainsFeature

public static boolean nullSafeContainsFeature(DiscoverInfo discoverInfo,
                                              java.lang.CharSequence feature)

getIQChildElementBuilder

protected org.jivesoftware.smack.packet.IQ.IQChildElementXmlStringBuilder getIQChildElementBuilder(org.jivesoftware.smack.packet.IQ.IQChildElementXmlStringBuilder xml)

Specified by:

getIQChildElementBuilder in class org.jivesoftware.smack.packet.IQ

containsDuplicateIdentities

public boolean containsDuplicateIdentities()

Test if a DiscoverInfo response contains duplicate identities.

Returns:

true if duplicate identities where found, otherwise false

containsDuplicateFeatures

public boolean containsDuplicateFeatures()

Test if a DiscoverInfo response contains duplicate features.

Returns:

true if duplicate identities where found, otherwise false

asBuilder

public DiscoverInfoBuilder asBuilder(java.lang.String stanzaId)

clone

@Deprecated
public DiscoverInfo clone()

Deprecated. use asBuilder(String) instead.

Deprecated, do not use.

Overrides:

clone in class java.lang.Object

builder

public static DiscoverInfoBuilder builder(org.jivesoftware.smack.XMPPConnection connection)

builder

public static DiscoverInfoBuilder builder(org.jivesoftware.smack.packet.IqData iqData)

builder

public static DiscoverInfoBuilder builder(java.lang.String stanzaId)