Interface Wagon

public void addSessionListener(SessionListener listener)

public void addTransferListener(TransferListener listener)

public void connect(Repository source)
            throws ConnectionException,
                   AuthenticationException

public void connect(Repository source,
                    AuthenticationInfo authenticationInfo)
            throws ConnectionException,
                   AuthenticationException

public void connect(Repository source,
                    AuthenticationInfo authenticationInfo,
                    ProxyInfo proxyInfo)
            throws ConnectionException,
                   AuthenticationException

public void connect(Repository source,
                    ProxyInfo proxyInfo)
            throws ConnectionException,
                   AuthenticationException

public void disconnect()
            throws ConnectionException

public void get(String resourceName,
                File destination)
            throws TransferFailedException,
                   ResourceDoesNotExistException,
                   AuthorizationException

Downloads specified resource from the repository to given file.

Parameters:

resourceName -

destination -

Throws:

TransferFailedException -

ResourceDoesNotExistException -

AuthorizationException -

public List getFileList(String destinationDirectory)
            throws TransferFailedException,
                   ResourceDoesNotExistException,
                   AuthorizationException

Returns a List of strings naming the files and directories in the directory denoted by this abstract pathname.

If this abstract pathname does not denote a directory, or does not exist, then this method throws ResourceDoesNotExistException. Otherwise a List of strings is returned, one for each file or directory in the directory. Names denoting the directory itself and the directory's parent directory are not included in the result. Each string is a file name rather than a complete path.

There is no guarantee that the name strings in the resulting list will appear in any specific order; they are not, in particular, guaranteed to appear in alphabetical order.

Parameters:

destinationDirectory - directory to list contents of

Returns:

A List of strings naming the files and directories in the directory denoted by this abstract pathname. The List will be empty if the directory is empty.

Throws:

TransferFailedException - if there's an error trying to access the remote side

ResourceDoesNotExistException - if destinationDirectory does not exist or is not a directory

AuthorizationException - if not authorized to list the contents of the directory

public boolean getIfNewer(String resourceName,
                          File destination,
                          long timestamp)
            throws TransferFailedException,
                   ResourceDoesNotExistException,
                   AuthorizationException

Downloads specified resource from the repository if it was modfified since specified date. The date is measured in milliseconds, between the current time and midnight, January 1, 1970 UTC and aliged to GMT timezone.

Parameters:

resourceName -

destination -

timestamp -

Returns:

true if newer resource has been downloaded, false if resource in the repository is older or has the same age.

Throws:

TransferFailedException -

ResourceDoesNotExistException -

AuthorizationException -

public Repository getRepository()

public boolean hasSessionListener(SessionListener listener)

public boolean hasTransferListener(TransferListener listener)

public void openConnection()
            throws ConnectionException,
                   AuthenticationException

public void put(File source,
                String destination)
            throws TransferFailedException,
                   ResourceDoesNotExistException,
                   AuthorizationException

Copy a file from local system to remote

Parameters:

source - the local file

destination - the remote destination

Throws:

TransferFailedException -

ResourceDoesNotExistException -

AuthorizationException -

public void putDirectory(File sourceDirectory,
                         String destinationDirectory)
            throws TransferFailedException,
                   ResourceDoesNotExistException,
                   AuthorizationException

Copy a directory from local system to remote

Parameters:

sourceDirectory - the local directory

destinationDirectory - the remote destination

Throws:

TransferFailedException -

ResourceDoesNotExistException -

AuthorizationException -

public void removeSessionListener(SessionListener listener)

public void removeTransferListener(TransferListener listener)

public boolean resourceExists(String resourceName)
            throws TransferFailedException,
                   AuthorizationException

Check if a remote resource exists

Parameters:

resourceName -

Returns:

whether the resource exists or not

Throws:

TransferFailedException - if there's an error trying to access the remote side

AuthorizationException - if not authorized to verify the existence of the resource