org.jivesoftware.smackx.jingleold.packet

Class Jingle

java.lang.Object

org.jivesoftware.smack.packet.Stanza

org.jivesoftware.smack.packet.IQ

org.jivesoftware.smackx.jingleold.packet.Jingle

All Implemented Interfaces:

Element, Packet, TopLevelStreamElement

public class Jingle
extends IQ

An Jingle sub-packet, which is used by XMPP clients to exchange info like descriptions and transports.

The following link summarizes the requirements of Jingle IM: Valid tags.

Warning: this is an non-standard protocol documented by XEP-166. Because this is a non-standard protocol, it is subject to change.

Nested Class Summary

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

IQ.IQChildElementXmlStringBuilder, IQ.Type

Field Summary

Fields

Modifier and Type	Field and Description
static String	NAMESPACE
static String	NODENAME

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
Jingle() The default constructor
Jingle(JingleActionEnum action) A constructor where the action can be specified.
Jingle(JingleContent content) Constructor with a contents.
Jingle(JingleContentInfo info) Constructor with a content info.
Jingle(List<JingleContent> contents, JingleContentInfo mi, String sid) A constructor where the main components can be initialized.
Jingle(String sid) A constructor where the session ID can be specified.

Method Summary

Modifier and Type	Method and Description
void	addContent(JingleContent content) Add a new content.
void	addContents(List<JingleContent> contentList) Add a list of JingleContent elements
JingleActionEnum	getAction() Get the action specified in the packet
JingleContentInfo	getContentInfo()
Iterator<JingleContent>	getContents() Get an iterator for the contents
List<JingleContent>	getContentsList() Get an iterator for the content
static String	getElementName() Returns the XML element name of the extension sub-packet root element.
String	getInitiator() Get the initiator.
protected IQ.IQChildElementXmlStringBuilder	getIQChildElementBuilder(IQ.IQChildElementXmlStringBuilder buf) Return the XML representation of the packet.
static String	getNamespace() Returns the XML namespace of the extension sub-packet root element.
String	getResponder() Get the responder.
static int	getSessionHash(String sid, String initiator) Get a hash key for the session this stanza(/packet) belongs to.
String	getSid() Returns the session ID related to the session.
void	setAction(JingleActionEnum action) Set the action in the packet
void	setContentInfo(JingleContentInfo contentInfo)
void	setInitiator(String initiator) Set the initiator.
void	setResponder(String resp) Set the responder.
void	setSid(String sid) Set the session ID related to this session.

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

createErrorResponse, createResultIQ, getChildElementName, getChildElementNamespace, getChildElementXML, getType, isRequestIQ, setType, 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, overrideExtension, removeExtension, removeExtension, setError, setFrom, setLanguage, setPacketID, setStanzaId, setTo, toString

Methods inherited from class java.lang.Object

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

Field Detail

NAMESPACE

public static final String NAMESPACE

See Also:

Constant Field Values

NODENAME

public static final String NODENAME

See Also:

Constant Field Values

Constructor Detail

Jingle

public Jingle(List<JingleContent> contents,
              JingleContentInfo mi,
              String sid)

A constructor where the main components can be initialized.

Jingle

public Jingle(JingleContent content)

Constructor with a contents.

Parameters:

content - a content

Jingle

public Jingle(JingleContentInfo info)

Constructor with a content info.

Parameters:

info - The content info

Jingle

public Jingle(JingleActionEnum action)

A constructor where the action can be specified.

Parameters:

action - The action.

Jingle

public Jingle(String sid)

A constructor where the session ID can be specified.

Parameters:

sid - The session ID related to the negotiation.

See Also:

setSid(String)

Jingle

public Jingle()

The default constructor

Method Detail

setSid

public final void setSid(String sid)

Set the session ID related to this 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 &.

Parameters:

sid - the session ID

getSid

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

See Also:

setSid(String)

getElementName

public static String getElementName()

Returns the XML element name of the extension sub-packet root element. Always returns "jingle"

Returns:

the XML element name of the stanza(/packet) extension.

getNamespace

public static String getNamespace()

Returns the XML namespace of the extension sub-packet root element.

Returns:

the XML namespace of the stanza(/packet) extension.

getContentInfo

public JingleContentInfo getContentInfo()

Returns:

the audioInfo

setContentInfo

public void setContentInfo(JingleContentInfo contentInfo)

Parameters:

contentInfo - the audioInfo to set

getContents

public Iterator<JingleContent> getContents()

Get an iterator for the contents

Returns:

the contents

getContentsList

public List<JingleContent> getContentsList()

Get an iterator for the content

Returns:

the contents

addContent

public void addContent(JingleContent content)

Add a new content.

Parameters:

content - the content to add

addContents

public void addContents(List<JingleContent> contentList)

Add a list of JingleContent elements

Parameters:

contentList - the list of contents to add

getAction

public JingleActionEnum getAction()

Get the action specified in the packet

Returns:

the action

setAction

public void setAction(JingleActionEnum action)

Set the action in the packet

Parameters:

action - the action to set

getInitiator

public String 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

setInitiator

public void setInitiator(String initiator)

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

Parameters:

initiator - the initiator to set

getResponder

public String 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" addresss in the IQ).

Returns:

the responder

setResponder

public void setResponder(String resp)

Set the responder. The responder must be the full JID of the entity that has replied to the initiation (which may be different to the "to" addresss in the IQ).

Parameters:

resp - the responder to set

getSessionHash

public static int getSessionHash(String sid,
                                 String initiator)

Get a hash key for the session this stanza(/packet) belongs to.

Parameters:

sid - The session id

initiator - The initiator

Returns:

A hash key

getIQChildElementBuilder

protected IQ.IQChildElementXmlStringBuilder getIQChildElementBuilder(IQ.IQChildElementXmlStringBuilder buf)

Return the XML representation of the packet.

Specified by:

getIQChildElementBuilder in class IQ

Parameters:

buf - a pre-created builder which already has the child element and the 'xmlns' attribute set.

Returns:

the XML string