org.jivesoftware.smackx.jingleold

Class JingleSession

java.lang.Object

org.jivesoftware.smackx.jingleold.JingleNegotiator

org.jivesoftware.smackx.jingleold.JingleSession

All Implemented Interfaces:

MediaReceivedListener

public class JingleSession
extends JingleNegotiator
implements MediaReceivedListener

An abstract Jingle session.

This class contains some basic properties of every Jingle session. However, the concrete implementation can be found in subclasses.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.List<JingleMediaManager>	jingleMediaManagers

Fields inherited from class org.jivesoftware.smackx.jingleold.JingleNegotiator

session

Constructor Summary

Constructors

Constructor and Description
JingleSession(org.jivesoftware.smack.XMPPConnection conn, JingleSessionRequest request, java.lang.String initiator, java.lang.String responder, java.util.List<JingleMediaManager> jingleMediaManagers) JingleSession constructor (for an outgoing Jingle session)
JingleSession(org.jivesoftware.smack.XMPPConnection conn, java.lang.String initiator, java.lang.String responder, java.lang.String sessionid, java.util.List<JingleMediaManager> jingleMediaManagers) Full featured JingleSession constructor

Method Summary

Modifier and Type	Method and Description
void	addContentNegotiator(ContentNegotiator inContentNegotiator) Add a new content negotiator on behalf of a section received.
void	addJingleMediaSession(java.lang.String mediaManagerName, JingleMediaSession mediaSession) The jingle session may have one or more media managers that are trying to establish media sessions.
void	addMediaListener(JingleMediaListener li) Add a listener for jmf negotiation events
void	addTransportListener(JingleTransportListener li) Add a listener for transport negotiation events
void	close() Terminate negotiations.
org.jivesoftware.smack.packet.IQ	createAck(org.jivesoftware.smack.packet.IQ iq) Acknowledge a IQ packet.
org.jivesoftware.smack.packet.IQ	createJingleError(org.jivesoftware.smack.packet.IQ iq, JingleError jingleError) Complete and send an error.
java.util.List<org.jivesoftware.smack.packet.IQ>	dispatchIncomingPacket(org.jivesoftware.smack.packet.IQ iq, java.lang.String id) Dispatch an incoming packet.
protected void	doStart() Each of the negotiators has their individual behavior when they start.
boolean	equals(java.lang.Object obj)
protected static java.lang.String	generateSessionId() Generate a unique session ID.
org.jivesoftware.smack.XMPPConnection	getConnection()
java.lang.String	getInitiator() Get the session initiator
static JingleSession	getInstanceFor(org.jivesoftware.smack.XMPPConnection con) Returns the JingleSession related to a particular connection.
java.util.List<JingleMediaManager>	getMediaManagers() Get the Media Manager of this Jingle Session
JingleMediaSession	getMediaSession(java.lang.String mediaManagerName) The jingle session may have one or more media managers that are trying to establish media sessions.
java.lang.String	getResponder() Get the session responder
JingleSessionState	getSessionState()
java.lang.String	getSid() Get the session ID
int	hashCode() Send a content info message.
boolean	isClosed()
boolean	isFullyEstablished() Return true if all of the media managers have finished
void	mediaReceived(java.lang.String participant) Called when new Media is received.
void	receivePacketAndRespond(org.jivesoftware.smack.packet.IQ iq) Process and respond to an incoming packet.
protected void	removeAsyncPacketListener() Remove the stanza(/packet) listener used for processing packet.
void	removeMediaListener(JingleMediaListener li) Remove a listener for jmf negotiation events
void	removeTransportListener(JingleTransportListener li) Remove a listener for transport negotiation events
Jingle	sendFormattedJingle(org.jivesoftware.smack.packet.IQ iq, Jingle jout) Complete and send a packet.
Jingle	sendFormattedJingle(Jingle jout) Complete and send a packet.
void	sendStanza(org.jivesoftware.smack.packet.IQ iq)
void	setInitiator(java.lang.String initiator) Set the session initiator
void	setMediaManagers(java.util.List<JingleMediaManager> jingleMediaManagers) Set the Media Manager of this Jingle Session
void	setResponder(java.lang.String responder) Set the session responder.
void	setSessionState(JingleSessionState stateIs) Validate the state changes.
protected void	setSid(java.lang.String sessionId) Set the session ID
void	setupListeners() Setup the listeners that act on events coming from the lower level negotiators.
void	startIncoming() This is the starting point for responding to a new session.
void	startOutgoing() This is the starting point for intitiating a new session.
void	terminate() Terminates the session with default reason.
void	terminate(java.lang.String reason) Terminates the session with a custom reason.
protected void	triggerMediaReceived(java.lang.String participant) Trigger a media received event.
protected void	triggerSessionClosed(java.lang.String reason) Trigger a session closed event.
protected void	triggerSessionClosedOnError(org.jivesoftware.smack.XMPPException exc) Trigger a session closed event due to an error.
protected void	updatePacketListener() Install the stanza(/packet) listener.

Methods inherited from class org.jivesoftware.smackx.jingleold.JingleNegotiator

addExpectedId, addListener, getListenersList, getNegotiatorState, getSession, isExpectedId, isStarted, removeExpectedId, removeListener, setNegotiatorState, setSession, start

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

jingleMediaManagers

protected java.util.List<JingleMediaManager> jingleMediaManagers

Constructor Detail

JingleSession

public JingleSession(org.jivesoftware.smack.XMPPConnection conn,
                     java.lang.String initiator,
                     java.lang.String responder,
                     java.lang.String sessionid,
                     java.util.List<JingleMediaManager> jingleMediaManagers)

Full featured JingleSession constructor

Parameters:

conn - the XMPPConnection which is used

initiator - the initiator JID

responder - the responder JID

sessionid - the session ID

jingleMediaManagers - the jingleMediaManager

JingleSession

public JingleSession(org.jivesoftware.smack.XMPPConnection conn,
                     JingleSessionRequest request,
                     java.lang.String initiator,
                     java.lang.String responder,
                     java.util.List<JingleMediaManager> jingleMediaManagers)

JingleSession constructor (for an outgoing Jingle session)

Parameters:

conn - Connection

initiator - the initiator JID

responder - the responder JID

jingleMediaManagers - the jingleMediaManager

Method Detail

getInitiator

public java.lang.String getInitiator()

Get the session initiator

Returns:

the initiator

getConnection

public org.jivesoftware.smack.XMPPConnection getConnection()

Overrides:

getConnection in class JingleNegotiator

setInitiator

public void setInitiator(java.lang.String initiator)

Set the session initiator

Parameters:

initiator - the initiator to set

getMediaManagers

public java.util.List<JingleMediaManager> getMediaManagers()

Get the Media Manager of this Jingle Session

Returns:

the JingleMediaManagers

setMediaManagers

public void setMediaManagers(java.util.List<JingleMediaManager> jingleMediaManagers)

Set the Media Manager of this Jingle Session

Parameters:

jingleMediaManagers -

getResponder

public java.lang.String getResponder()

Get the session responder

Returns:

the responder

setResponder

public void setResponder(java.lang.String responder)

Set the session responder.

Parameters:

responder - the receptor to set

getSid

public java.lang.String getSid()

Get the session ID

Returns:

the sid

setSid

protected void setSid(java.lang.String sessionId)

Set the session ID

Parameters:

sessionId - the sid to set

generateSessionId

protected static java.lang.String generateSessionId()

Generate a unique session ID.

setSessionState

public void setSessionState(JingleSessionState stateIs)

Validate the state changes.

getSessionState

public JingleSessionState getSessionState()

isFullyEstablished

public boolean isFullyEstablished()

Return true if all of the media managers have finished

receivePacketAndRespond

public void receivePacketAndRespond(org.jivesoftware.smack.packet.IQ iq)
                             throws org.jivesoftware.smack.XMPPException,
                                    org.jivesoftware.smack.SmackException

Process and respond to an incoming packet.

This method is called from the stanza(/packet) listener dispatcher when a new stanza(/packet) has arrived. The method is responsible for recognizing the stanza(/packet) type and, depending on the current state, delivering it to the right event handler and wait for a response. The response will be another Jingle stanza(/packet) that will be sent to the other end point.

Parameters:

iq - the stanza(/packet) received

Throws:

org.jivesoftware.smack.XMPPException

org.jivesoftware.smack.SmackException

dispatchIncomingPacket

public java.util.List<org.jivesoftware.smack.packet.IQ> dispatchIncomingPacket(org.jivesoftware.smack.packet.IQ iq,
                                                                               java.lang.String id)
                                                                        throws org.jivesoftware.smack.XMPPException,
                                                                               org.jivesoftware.smack.SmackException

Dispatch an incoming packet. The method is responsible for recognizing the stanza(/packet) type and, depending on the current state, delivering the stanza(/packet) to the right event handler and wait for a response.

Specified by:

dispatchIncomingPacket in class JingleNegotiator

Parameters:

iq - the stanza(/packet) received

id - the ID of the response that will be sent

Returns:

the new Jingle stanza(/packet) to send.

Throws:

org.jivesoftware.smack.XMPPException

org.jivesoftware.smack.SmackException

addContentNegotiator

public void addContentNegotiator(ContentNegotiator inContentNegotiator)

Add a new content negotiator on behalf of a section received.

sendStanza

public void sendStanza(org.jivesoftware.smack.packet.IQ iq)
                throws org.jivesoftware.smack.SmackException.NotConnectedException

Throws:

org.jivesoftware.smack.SmackException.NotConnectedException

sendFormattedJingle

public Jingle sendFormattedJingle(Jingle jout)
                           throws org.jivesoftware.smack.SmackException.NotConnectedException

Complete and send a packet. Complete all the null fields in a Jingle reponse, using the session information we have.

Parameters:

jout - the Jingle stanza(/packet) we want to complete and send

Throws:

org.jivesoftware.smack.SmackException.NotConnectedException

sendFormattedJingle

public Jingle sendFormattedJingle(org.jivesoftware.smack.packet.IQ iq,
                                  Jingle jout)
                           throws org.jivesoftware.smack.SmackException.NotConnectedException

Complete and send a packet. Complete all the null fields in a Jingle reponse, using the session information we have or some info from the incoming packet.

Parameters:

iq - The Jingle stanza(/packet) we are responing to

jout - the Jingle stanza(/packet) we want to complete and send

Throws:

org.jivesoftware.smack.SmackException.NotConnectedException

createAck

public org.jivesoftware.smack.packet.IQ createAck(org.jivesoftware.smack.packet.IQ iq)

Acknowledge a IQ packet.

Parameters:

iq - The IQ to acknowledge

hashCode

public int hashCode()

Send a content info message.

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

getInstanceFor

public static JingleSession getInstanceFor(org.jivesoftware.smack.XMPPConnection con)

Returns the JingleSession related to a particular connection.

Parameters:

con - A XMPP connection

Returns:

a Jingle session

removeAsyncPacketListener

protected void removeAsyncPacketListener()

Remove the stanza(/packet) listener used for processing packet.

updatePacketListener

protected void updatePacketListener()

Install the stanza(/packet) listener. The listener is responsible for responding to any stanza(/packet) that we receive...

addMediaListener

public void addMediaListener(JingleMediaListener li)

Add a listener for jmf negotiation events

Parameters:

li - The listener

removeMediaListener

public void removeMediaListener(JingleMediaListener li)

Remove a listener for jmf negotiation events

Parameters:

li - The listener

addTransportListener

public void addTransportListener(JingleTransportListener li)

Add a listener for transport negotiation events

Parameters:

li - The listener

removeTransportListener

public void removeTransportListener(JingleTransportListener li)

Remove a listener for transport negotiation events

Parameters:

li - The listener

setupListeners

public void setupListeners()

Setup the listeners that act on events coming from the lower level negotiators.

triggerSessionClosed

protected void triggerSessionClosed(java.lang.String reason)

Trigger a session closed event.

triggerSessionClosedOnError

protected void triggerSessionClosedOnError(org.jivesoftware.smack.XMPPException exc)

Trigger a session closed event due to an error.

triggerMediaReceived

protected void triggerMediaReceived(java.lang.String participant)

Trigger a media received event.

terminate

public void terminate()
               throws org.jivesoftware.smack.XMPPException,
                      org.jivesoftware.smack.SmackException.NotConnectedException

Terminates the session with default reason.

Throws:

org.jivesoftware.smack.XMPPException

org.jivesoftware.smack.SmackException.NotConnectedException

terminate

public void terminate(java.lang.String reason)
               throws org.jivesoftware.smack.XMPPException,
                      org.jivesoftware.smack.SmackException.NotConnectedException

Terminates the session with a custom reason.

Throws:

org.jivesoftware.smack.XMPPException

org.jivesoftware.smack.SmackException.NotConnectedException

close

public void close()

Terminate negotiations.

Overrides:

close in class JingleNegotiator

isClosed

public boolean isClosed()

createJingleError

public org.jivesoftware.smack.packet.IQ createJingleError(org.jivesoftware.smack.packet.IQ iq,
                                                          JingleError jingleError)

Complete and send an error. Complete all the null fields in an IQ error reponse, using the sesssion information we have or some info from the incoming packet.

Parameters:

iq - The Jingle stanza(/packet) we are responing to

jingleError - the IQ stanza(/packet) we want to complete and send

mediaReceived

public void mediaReceived(java.lang.String participant)

Called when new Media is received.

Specified by:

mediaReceived in interface MediaReceivedListener

startOutgoing

public void startOutgoing()
                   throws java.lang.IllegalStateException,
                          org.jivesoftware.smack.SmackException

This is the starting point for intitiating a new session.

Throws:

java.lang.IllegalStateException

org.jivesoftware.smack.SmackException

startIncoming

public void startIncoming()

This is the starting point for responding to a new session.

doStart

protected void doStart()

Description copied from class: JingleNegotiator

Each of the negotiators has their individual behavior when they start.

Specified by:

doStart in class JingleNegotiator

addJingleMediaSession

public void addJingleMediaSession(java.lang.String mediaManagerName,
                                  JingleMediaSession mediaSession)

The jingle session may have one or more media managers that are trying to establish media sessions. When the media manager succeeds in creating a media session is registers it with the session by the media manager's static name. This routine is where the media manager does the registering.

getMediaSession

public JingleMediaSession getMediaSession(java.lang.String mediaManagerName)

The jingle session may have one or more media managers that are trying to establish media sessions. When the media manager succeeds in creating a media session is registers it with the session by the media manager's static name. This routine is where other objects can access the registered media sessions. NB: If the media manager has not succeeded in establishing a media session then this could return null.