org.jivesoftware.smackx.jingle.element

Class Jingle

java.lang.Object

org.jivesoftware.smack.packet.Stanza

org.jivesoftware.smack.packet.IQ

org.jivesoftware.smackx.jingle.element.Jingle

All Implemented Interfaces:

org.jivesoftware.smack.packet.Element, org.jivesoftware.smack.packet.TopLevelStreamElement

public final class Jingle
extends org.jivesoftware.smack.packet.IQ

The Jingle element.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Jingle.Builder

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

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

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ACTION_ATTRIBUTE_NAME
static java.lang.String	ELEMENT
static java.lang.String	INITIATOR_ATTRIBUTE_NAME
static java.lang.String	NAMESPACE
static java.lang.String	RESPONDER_ATTRIBUTE_NAME
static java.lang.String	SESSION_ID_ATTRIBUTE_NAME

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

Method Summary

Modifier and Type	Method and Description
JingleAction	getAction() Get the action specified in the jingle IQ.
static Jingle.Builder	getBuilder()
java.util.List<JingleContent>	getContents() Get a List of the contents.
org.jxmpp.jid.FullJid	getInitiator() Get the initiator.
protected org.jivesoftware.smack.packet.IQ.IQChildElementXmlStringBuilder	getIQChildElementBuilder(org.jivesoftware.smack.packet.IQ.IQChildElementXmlStringBuilder xml)
JingleReason	getReason()
org.jxmpp.jid.FullJid	getResponder() Get the responder.
java.lang.String	getSid() Returns the session ID related to the session.
JingleContent	getSoleContentOrThrow() Get the only jingle content if one exists, or null.

Methods inherited from class org.jivesoftware.smack.packet.IQ

createErrorResponse, createErrorResponse, createErrorResponse, createResultIQ, getChildElementName, getChildElementNamespace, getChildElementXML, getType, initializeAsResultFor, initialzeAsResultFor, isRequestIQ, setType, toString, toXML

Methods inherited from class org.jivesoftware.smack.packet.Stanza

addCommonAttributes, addExtension, addExtensions, appendErrorIfExists, getDefaultLanguage, getError, getExtension, getExtension, getExtensions, getExtensions, getExtensionsXML, getFrom, getLanguage, getPacketID, getStanzaId, getTo, hasExtension, hasExtension, hasStanzaIdSet, logCommonAttributes, overrideExtension, removeExtension, removeExtension, setError, setError, setFrom, setFrom, setLanguage, setPacketID, setStanzaId, setStanzaId, setTo, setTo

Methods inherited from class java.lang.Object

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

Field Detail

NAMESPACE

public static final java.lang.String NAMESPACE

See Also:

Constant Field Values

ACTION_ATTRIBUTE_NAME

public static final java.lang.String ACTION_ATTRIBUTE_NAME

See Also:

Constant Field Values

INITIATOR_ATTRIBUTE_NAME

public static final java.lang.String INITIATOR_ATTRIBUTE_NAME

See Also:

Constant Field Values

RESPONDER_ATTRIBUTE_NAME

public static final java.lang.String RESPONDER_ATTRIBUTE_NAME

See Also:

Constant Field Values

SESSION_ID_ATTRIBUTE_NAME

public static final java.lang.String SESSION_ID_ATTRIBUTE_NAME

See Also:

Constant Field Values

ELEMENT

public static final java.lang.String ELEMENT

See Also:

Constant Field Values

Method Detail

getInitiator

public org.jxmpp.jid.FullJid getInitiator()

Get the initiator. The initiator will be the full JID of the entity that has initiated the flow (which may be different to the "from" address in the IQ)

Returns:

the initiator

getResponder

public org.jxmpp.jid.FullJid getResponder()

Get the responder. The responder is the full JID of the entity that has replied to the initiation (which may be different to the "to" address in the IQ).

Returns:

the responder

getSid

public java.lang.String getSid()

Returns the session ID related to the session. The session ID is a unique identifier generated by the initiator. This should match the XML Nmtoken production so that XML character escaping is not needed for characters such as &.

Returns:

Returns the session ID related to the session.

getAction

public JingleAction getAction()

Get the action specified in the jingle IQ.

Returns:

the action.

getReason

public JingleReason getReason()

getContents

public java.util.List<JingleContent> getContents()

Get a List of the contents.

Returns:

the contents.

getSoleContentOrThrow

public JingleContent getSoleContentOrThrow()

Get the only jingle content if one exists, or null. This method will throw an IllegalStateException if there is more than one jingle content.

Returns:

a JingleContent instance or null.

Throws:

java.lang.IllegalStateException - if there is more than one jingle content.

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

getBuilder

public static Jingle.Builder getBuilder()