net.java.sip.communicator.impl.protocol.msn
Class OperationSetFileTransferMsnImpl

java.lang.Object
  net.java.sip.communicator.impl.protocol.msn.OperationSetFileTransferMsnImpl

All Implemented Interfaces:

OperationSet, OperationSetFileTransfer

public class OperationSetFileTransferMsnImpl
extends Object
implements OperationSetFileTransfer

The Msn protocol filetransfer OperationSet.

Author:

Damian Minkov

Constructor Summary

OperationSetFileTransferMsnImpl(ProtocolProviderServiceMsnImpl msnProvider)
Create a new FileTransfer OperationSet over the specified Msn provider

Method Summary

void	addFileTransferListener(FileTransferListener listener) Adds the given FileTransferListener that would listen for file transfer requests and created file transfers.
(package private) void	fireFileTransferCreated(FileTransferCreatedEvent event) Delivers the file transfer to all registered listeners.
(package private) void	fireFileTransferRequestCanceled(FileTransferRequestEvent event) Delivers the specified event to all registered file transfer listeners.
(package private) void	fireFileTransferRequestRejected(FileTransferRequestEvent event) Delivers the specified event to all registered file transfer listeners.
long	getMaximumFileLength() Returns the maximum file length supported by the protocol in bytes.
void	removeFileTransferListener(FileTransferListener listener) Removes the given FileTransferListener that listens for file transfer requests and created file transfers.
FileTransfer	sendFile(Contact toContact, Contact fromContact, String remotePath, String localPath) Sends a file transfer request to the given toContact by specifying the local and remote file path and the fromContact, sending the file.
FileTransfer	sendFile(Contact toContact, File file) Sends a file transfer request to the given toContact by specifying the local and remote file path and the fromContact, sending the file.

Methods inherited from class java.lang.Object

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

Constructor Detail

OperationSetFileTransferMsnImpl

public OperationSetFileTransferMsnImpl(ProtocolProviderServiceMsnImpl msnProvider)

Create a new FileTransfer OperationSet over the specified Msn provider

Parameters:

msnProvider - MSN protocol provider service

Method Detail

sendFile

public FileTransfer sendFile(Contact toContact,
                             File file)
                      throws IllegalStateException,
                             IllegalArgumentException

Sends a file transfer request to the given toContact by specifying the local and remote file path and the fromContact, sending the file.

Specified by:

sendFile in interface OperationSetFileTransfer

Parameters:

toContact - the contact that should receive the file

file - the file to send

Returns:

the transfer object

Throws:

IllegalStateException - if the protocol provider is not registered or connected

IllegalArgumentException - if some of the arguments doesn't fit the protocol requirements

sendFile

public FileTransfer sendFile(Contact toContact,
                             Contact fromContact,
                             String remotePath,
                             String localPath)
                      throws IllegalStateException,
                             IllegalArgumentException

Sends a file transfer request to the given toContact by specifying the local and remote file path and the fromContact, sending the file.

Specified by:

sendFile in interface OperationSetFileTransfer

Parameters:

toContact - the contact that should receive the file

fromContact - the contact sending the file

remotePath - the remote file path

localPath - the local file path

Returns:

the transfer object

Throws:

IllegalStateException - if the protocol provider is not registered or connected

IllegalArgumentException - if some of the arguments doesn't fit the protocol requirements

addFileTransferListener

public void addFileTransferListener(FileTransferListener listener)

Adds the given FileTransferListener that would listen for file transfer requests and created file transfers.

Specified by:

addFileTransferListener in interface OperationSetFileTransfer

Parameters:

listener - the FileTransferListener to add

removeFileTransferListener

public void removeFileTransferListener(FileTransferListener listener)

Removes the given FileTransferListener that listens for file transfer requests and created file transfers.

Specified by:

removeFileTransferListener in interface OperationSetFileTransfer

Parameters:

listener - the FileTransferListener to remove

fireFileTransferRequestRejected

void fireFileTransferRequestRejected(FileTransferRequestEvent event)

Delivers the specified event to all registered file transfer listeners.

Parameters:

event - the EventObject that we'd like delivered to all registered file transfer listeners.

fireFileTransferRequestCanceled

void fireFileTransferRequestCanceled(FileTransferRequestEvent event)

Delivers the specified event to all registered file transfer listeners.

Parameters:

event - the EventObject that we'd like delivered to all registered file transfer listeners.

fireFileTransferCreated

void fireFileTransferCreated(FileTransferCreatedEvent event)

Delivers the file transfer to all registered listeners.

Parameters:

event - the FileTransferEvent that we'd like delivered to all registered file transfer listeners.

getMaximumFileLength

public long getMaximumFileLength()

Returns the maximum file length supported by the protocol in bytes. Supports up to 2GB.

Specified by:

getMaximumFileLength in interface OperationSetFileTransfer

Returns:

the file length that is supported.