org.jivesoftware.smackx.filetransfer

Class StreamNegotiator

java.lang.Object

org.jivesoftware.smackx.filetransfer.StreamNegotiator

Direct Known Subclasses:

FaultTolerantNegotiator, IBBTransferNegotiator, Socks5TransferNegotiator

public abstract class StreamNegotiator
extends java.lang.Object

After the file transfer negotiation process is completed according to XEP-0096, the negotiation process is passed off to a particular stream negotiator. The stream negotiator will then negotiate the chosen stream and return the stream to transfer the file.

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.jivesoftware.smack.util.EventManger<java.lang.String,org.jivesoftware.smack.packet.IQ,org.jivesoftware.smack.SmackException.NotConnectedException>	initationSetEvents A event manager for stream initiation requests send to us.

Constructor Summary

Constructors

Constructor and Description
StreamNegotiator()

Method Summary

Modifier and Type	Method and Description
abstract java.io.InputStream	createIncomingStream(StreamInitiation initiation) This method handles the file stream download negotiation process.
protected static StreamInitiation	createInitiationAccept(StreamInitiation streamInitiationOffer, java.lang.String[] namespaces) Creates the initiation acceptance stanza(/packet) to forward to the stream initiator.
abstract java.io.OutputStream	createOutgoingStream(java.lang.String streamID, java.lang.String initiator, java.lang.String target) This method handles the file upload stream negotiation process.
abstract java.lang.String[]	getNamespaces() Returns the XMPP namespace reserved for this particular type of file transfer.
protected org.jivesoftware.smack.packet.IQ	initiateIncomingStream(org.jivesoftware.smack.XMPPConnection connection, StreamInitiation initiation)
protected abstract void	newStreamInitiation(java.lang.String from, java.lang.String streamID) Signal that a new stream initiation arrived.
static void	signal(java.lang.String eventKey, org.jivesoftware.smack.packet.IQ eventValue)

Methods inherited from class java.lang.Object

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

Field Detail

initationSetEvents

protected static final org.jivesoftware.smack.util.EventManger<java.lang.String,org.jivesoftware.smack.packet.IQ,org.jivesoftware.smack.SmackException.NotConnectedException> initationSetEvents

A event manager for stream initiation requests send to us.

Those are typical XEP-45 Open or XEP-65 Bytestream IQ requests. The even key is in the format "initiationFrom + '\t' + streamId"

Constructor Detail

StreamNegotiator

public StreamNegotiator()

Method Detail

createInitiationAccept

protected static StreamInitiation createInitiationAccept(StreamInitiation streamInitiationOffer,
                                                         java.lang.String[] namespaces)

Creates the initiation acceptance stanza(/packet) to forward to the stream initiator.

Parameters:

streamInitiationOffer - The offer from the stream initiator to connect for a stream.

namespaces - The namespace that relates to the accepted means of transfer.

Returns:

The response to be forwarded to the initiator.

initiateIncomingStream

protected final org.jivesoftware.smack.packet.IQ initiateIncomingStream(org.jivesoftware.smack.XMPPConnection connection,
                                                                        StreamInitiation initiation)
                                                                 throws org.jivesoftware.smack.SmackException.NoResponseException,
                                                                        org.jivesoftware.smack.XMPPException.XMPPErrorException,
                                                                        org.jivesoftware.smack.SmackException.NotConnectedException

Throws:

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NotConnectedException

newStreamInitiation

protected abstract void newStreamInitiation(java.lang.String from,
                                            java.lang.String streamID)

Signal that a new stream initiation arrived. The negotiator may needs to prepare for it.

Parameters:

from - The initiator of the file transfer.

streamID - The stream ID related to the transfer.

createIncomingStream

public abstract java.io.InputStream createIncomingStream(StreamInitiation initiation)
                                                  throws org.jivesoftware.smack.XMPPException.XMPPErrorException,
                                                         java.lang.InterruptedException,
                                                         org.jivesoftware.smack.SmackException.NoResponseException,
                                                         org.jivesoftware.smack.SmackException

This method handles the file stream download negotiation process. The appropriate stream negotiator's initiate incoming stream is called after an appropriate file transfer method is selected. The manager will respond to the initiator with the selected means of transfer, then it will handle any negotiation specific to the particular transfer method. This method returns the InputStream, ready to transfer the file.

Parameters:

initiation - The initiation that triggered this download.

Returns:

After the negotiation process is complete, the InputStream to write a file to is returned.

Throws:

org.jivesoftware.smack.XMPPException.XMPPErrorException - If an error occurs during this process an XMPPException is thrown.

java.lang.InterruptedException - If thread is interrupted.

org.jivesoftware.smack.SmackException

org.jivesoftware.smack.SmackException.NoResponseException

createOutgoingStream

public abstract java.io.OutputStream createOutgoingStream(java.lang.String streamID,
                                                          java.lang.String initiator,
                                                          java.lang.String target)
                                                   throws org.jivesoftware.smack.XMPPException.XMPPErrorException,
                                                          org.jivesoftware.smack.SmackException.NoResponseException,
                                                          org.jivesoftware.smack.SmackException,
                                                          org.jivesoftware.smack.XMPPException

This method handles the file upload stream negotiation process. The particular stream negotiator is determined during the file transfer negotiation process. This method returns the OutputStream to transmit the file to the remote user.

Parameters:

streamID - The streamID that uniquely identifies the file transfer.

initiator - The fully-qualified JID of the initiator of the file transfer.

target - The fully-qualified JID of the target or receiver of the file transfer.

Returns:

The negotiated stream ready for data.

Throws:

org.jivesoftware.smack.XMPPException.XMPPErrorException - If an error occurs during the negotiation process an exception will be thrown.

org.jivesoftware.smack.SmackException

org.jivesoftware.smack.XMPPException

org.jivesoftware.smack.SmackException.NoResponseException

getNamespaces

public abstract java.lang.String[] getNamespaces()

Returns the XMPP namespace reserved for this particular type of file transfer.

Returns:

Returns the XMPP namespace reserved for this particular type of file transfer.

signal

public static void signal(java.lang.String eventKey,
                          org.jivesoftware.smack.packet.IQ eventValue)