org.jivesoftware.smackx.jingle.nat

Class TransportNegotiator

java.lang.Object

org.jivesoftware.smackx.jingle.JingleNegotiator

org.jivesoftware.smackx.jingle.nat.TransportNegotiator

Direct Known Subclasses:

TransportNegotiator.Ice, TransportNegotiator.RawUdp

public abstract class TransportNegotiator
extends JingleNegotiator

Transport negotiator.

This class is responsible for managing the transport negotiation process, handling all the packet interchange and the stage control.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TransportNegotiator.Ice Ice transport negotiator.
static class	TransportNegotiator.RawUdp Raw-UDP transport negotiator

Field Summary

Fields

Modifier and Type	Field and Description
static int	CANDIDATES_ACCEPT_PERIOD

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

session

Constructor Summary

Constructors

Constructor and Description
TransportNegotiator(JingleSession session, TransportResolver transResolver, ContentNegotiator parentNegotiator) Default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
abstract boolean	acceptableTransportCandidate(TransportCandidate tc, List<TransportCandidate> localCandidates) Return true if the transport candidate is acceptable for the current negotiator.
void	close() Called from above to session-terminate.
List<IQ>	dispatchIncomingPacket(IQ iq, String id) Dispatch an incoming packet.
protected void	doStart() Called from above to start the negotiator during a session-initiate.
TransportCandidate	getAcceptedLocalCandidate() Get the best accepted local candidate we have offered.
TransportCandidate	getBestLocalCandidate() Obtain the best local candidate we want to offer.
abstract TransportCandidate	getBestRemoteCandidate() Obtain the best common transport candidate obtained in the negotiation.
JingleTransport	getJingleTransport() Return a JingleTransport that best reflects this transport negotiator.
abstract JingleTransport	getJingleTransport(TransportCandidate cand) Get a new instance of the right TransportNegotiator class with this candidate.
List<TransportCandidate>	getOfferedCandidates()
Iterator<TransportCandidate>	getValidRemoteCandidates() Get an iterator for the list of valid (ie, checked) remote candidates.
boolean	isFullyEstablished() Return true if the transport is fully established.

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

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

Methods inherited from class java.lang.Object

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

Field Detail

CANDIDATES_ACCEPT_PERIOD

public static final int CANDIDATES_ACCEPT_PERIOD

See Also:

Constant Field Values

Constructor Detail

TransportNegotiator

public TransportNegotiator(JingleSession session,
                   TransportResolver transResolver,
                   ContentNegotiator parentNegotiator)

Default constructor.

Parameters:

session - The Jingle session

transResolver - The JingleTransportManager to use

Method Detail

getJingleTransport

public abstract JingleTransport getJingleTransport(TransportCandidate cand)

Get a new instance of the right TransportNegotiator class with this candidate.

Returns:

A TransportNegotiator instance

acceptableTransportCandidate

public abstract boolean acceptableTransportCandidate(TransportCandidate tc,
                                   List<TransportCandidate> localCandidates)

Return true if the transport candidate is acceptable for the current negotiator.

Returns:

true if the transport candidate is acceptable

getBestLocalCandidate

public final TransportCandidate getBestLocalCandidate()

Obtain the best local candidate we want to offer.

Returns:

the best local candidate

getAcceptedLocalCandidate

public TransportCandidate getAcceptedLocalCandidate()

Get the best accepted local candidate we have offered.

Returns:

a transport candidate we have offered.

doStart

protected void doStart()

Called from above to start the negotiator during a session-initiate.

Specified by:

doStart in class JingleNegotiator

close

public void close()

Called from above to session-terminate.

Overrides:

close in class JingleNegotiator

getJingleTransport

public JingleTransport getJingleTransport()

Return a JingleTransport that best reflects this transport negotiator.

getOfferedCandidates

public List<TransportCandidate> getOfferedCandidates()

getBestRemoteCandidate

public abstract TransportCandidate getBestRemoteCandidate()

Obtain the best common transport candidate obtained in the negotiation.

Returns:

the bestRemoteCandidate

isFullyEstablished

public final boolean isFullyEstablished()

Return true if the transport is fully established.

Returns:

true if the transport is fully established.

getValidRemoteCandidates

public final Iterator<TransportCandidate> getValidRemoteCandidates()

Get an iterator for the list of valid (ie, checked) remote candidates.

Returns:

The iterator for the list of valid (ie, already checked) remote candidates.

dispatchIncomingPacket

public final List<IQ> dispatchIncomingPacket(IQ iq,
                              String id)
                                      throws XMPPException,
                                             SmackException

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

Specified by:

dispatchIncomingPacket in class JingleNegotiator

Parameters:

iq - the packet received

id - the ID of the response that will be sent

Returns:

the new Jingle packet to send.

Throws:

XMPPException

SmackException