Method Detail

• offerFile

  public void offerFile(URL url,
               String description,
               Jid recipient,
               long timeout)
                 throws XmppException

  Offers a file to another user in form of an URL. The file can be downloaded by the recipient via an HTTP GET request. If this method returns without exception you can assume, that the file has been successfully downloaded by the recipient.

  Parameters:

  url - The URL of the file.

  description - The description of the file.

  recipient - The recipient's JID (must be a full JID).

  timeout - The timeout (indicates how long to wait until the file has been downloaded).

  Throws:

  FileTransferRejectedException - If the recipient rejected the file.

  StanzaException - If the user is unavailable or failed to download the file.

  NoResponseException - If the recipient did not downloaded the file within the timeout.

  XmppException

  See Also:

  XEP-0066: Out of Band Data

• offerFile

  public final FileTransfer offerFile(File file,
                       String description,
                       Jid recipient,
                       long timeout)
                               throws XmppException,
                                      IOException

  Offers a file to another user. If this method returns successfully, the recipient has accepted the offer, the stream method has been negotiated and the file is ready to be transferred. Call FileTransfer.transfer() to start the file transfer.

  Parameters:

  file - The file.

  description - The description of the file.

  recipient - The recipient's JID (must be a full JID, i. e. including resource).

  timeout - The timeout (indicates how long to wait until the file offer has either been accepted or rejected).

  Returns:

  The file transfer object.

  Throws:

  FileTransferRejectedException - If the recipient rejected the file.

  StanzaException - If the user is unavailable or failed to download the file.

  NoResponseException - If the recipient did not downloaded the file within the timeout.

  IOException - If the file could not be read.

  XmppException

• offerFile

  public final FileTransfer offerFile(Path source,
                       String description,
                       Jid recipient,
                       long timeout)
                               throws XmppException,
                                      IOException

  Offers a file to another user. If this method returns successfully, the recipient has accepted the offer, the stream method has been negotiated and the file is ready to be transferred. Call FileTransfer.transfer() to start the file transfer.

  Parameters:

  source - The file.

  description - The description of the file.

  recipient - The recipient's JID (must be a full JID, i. e. including resource).

  timeout - The timeout (indicates how long to wait until the file offer has either been accepted or rejected).

  Returns:

  The file transfer object.

  Throws:

  FileTransferRejectedException - If the recipient rejected the file.

  StanzaException - If the user is unavailable or failed to download the file.

  NoResponseException - If the recipient did not downloaded the file within the timeout.

  IOException - If the file could not be read.

  XmppException

• offerFile

  public final FileTransfer offerFile(InputStream source,
                       String fileName,
                       long fileSize,
                       Date lastModified,
                       String description,
                       Jid recipient,
                       long timeout)
                               throws XmppException,
                                      IOException

  Offers a stream to another user. If this method returns successfully, the recipient has accepted the offer, the stream method has been negotiated and the file is ready to be transferred. Call FileTransfer.transfer() to start the file transfer.

  Parameters:

  source - The stream.

  fileName - The file name.

  fileSize - The file size.

  lastModified - The last modified date.

  description - The description of the file.

  recipient - The recipient's JID (must be a full JID, i. e. including resource).

  timeout - The timeout (indicates how long to wait until the file offer has either been accepted or rejected).

  Returns:

  The file transfer object.

  Throws:

  FileTransferRejectedException - If the recipient rejected the file.

  StanzaException - If the user is unavailable or failed to download the file.

  NoResponseException - If the recipient did not downloaded the file within the timeout.

  IOException - If the file could not be read.

  XmppException

• fileTransferOffered

  public void fileTransferOffered(IQ iq,
                         String sessionId,
                         String mimeType,
                         FileTransferOffer fileTransferOffer,
                         Object protocol,
                         FileTransferNegotiator fileTransferNegotiator)

• addFileTransferOfferListener

  public void addFileTransferOfferListener(FileTransferOfferListener fileTransferOfferListener)

  Adds a file transfer listener, which allows to listen for inbound file transfer requests.

  Parameters:

  fileTransferOfferListener - The listener.

  See Also:

  removeFileTransferOfferListener(FileTransferOfferListener)

• removeFileTransferOfferListener

  public void removeFileTransferOfferListener(FileTransferOfferListener fileTransferOfferListener)

  Removes a previously added file transfer listener.

  Parameters:

  fileTransferOfferListener - The listener.

  See Also:

  addFileTransferOfferListener(FileTransferOfferListener)