com.sshtools.scp

Class ScpClient

java.lang.Object

com.sshtools.scp.ScpClientIO

com.sshtools.scp.ScpClient

All Implemented Interfaces:

Client

public class ScpClient
extends ScpClientIO
implements Client

Implements an SCP (Secure Copy) client which may be useful for SSH1 connections and SSH2 where SFTP is not available.

Author:

Lee David Painter

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	ScpClient.ScpEngine Implements an SCP Engine by extending J2SSH Mavericjs ScpEngineIO

Nested classes/interfaces inherited from class com.sshtools.scp.ScpClientIO

ScpClientIO.ScpEngineIO

Field Summary

Fields inherited from class com.sshtools.scp.ScpClientIO

ssh

Constructor Summary

Constructors

Constructor and Description
ScpClient(File cwd, SshClient ssh) Creates an SCP client.
ScpClient(SshClient ssh) Creates an SCP client.

Method Summary

Modifier and Type	Method and Description
void	exit()
void	get(String localDir, String[] remoteFiles, boolean recursive) Downloads an array of remote files to the local computer.
void	get(String localFile, String[] remoteFiles, boolean recursive, FileTransferProgress progress)
void	get(String localFile, String remoteFile, boolean recursive) Downloads a remote file onto the local computer.
void	get(String localFile, String remoteFile, boolean recursive, FileTransferProgress progress)
void	put(String[] localFiles, String remoteFile, boolean recursive) Uploads an array of local files onto the remote server.
void	put(String[] localFiles, String remoteFile, boolean recursive, FileTransferProgress progress) Uploads an array of local files onto the remote server.
void	put(String localFile, String remoteFile, boolean recursive) Uploads a local file onto the remote server.
void	put(String localFileRegExp, String remoteFile, boolean recursive, FileTransferProgress progress) pattern matches the files in the local directory using "local" as a glob Regular Expression.
void	putFile(String localFile, String remoteFile, boolean recursive, FileTransferProgress progress, boolean remoteIsDir)

Methods inherited from class com.sshtools.scp.ScpClientIO

get, get, put, put

Methods inherited from class java.lang.Object

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

Constructor Detail

ScpClient

public ScpClient(SshClient ssh)

Creates an SCP client. CWD (Current working directory) will be the users home directory.

Parameters:

ssh - A connected SshClient

ScpClient

public ScpClient(File cwd,
                 SshClient ssh)

Creates an SCP client.

Parameters:

cwd - The current local directory

ssh - A connected SshClient

Method Detail

put

public void put(String localFile,
                String remoteFile,
                boolean recursive)
         throws SshException,
                ChannelOpenException,
                SftpStatusException

Uploads a local file onto the remote server.

Treats localFile as a glob regular expression, and puts the files that match into the remote directory.

Code examples can be found in ScpConnect.java

Code Example

 // put all .doc files with 'rfc' in their names, in the 'docs/unsorted/' folder
 // relative to the local cwd, and copy them to remoteFile. If remoteFile is a
 // filename then the remote file will have this name unless multiple local files
 // are matched in which case an exception will be thrown.
 scp.put("docs/unsorted/*rfc*.doc");
 

Parameters:

localFile - The path to the local file relative to the local current directory; may be a file or directory

remoteFile - The path on the remote server, may be a file or directory

recursive - Copy the contents of a directory recursivly

Throws:

SshException - if an IO error occurs during the operation

SftpStatusException

ChannelOpenException

putFile

public void putFile(String localFile,
                    String remoteFile,
                    boolean recursive,
                    FileTransferProgress progress,
                    boolean remoteIsDir)
             throws SshException,
                    ChannelOpenException

Parameters:

localFile -

remoteFile -

recursive -

progress -

remoteIsDir - if called by put(string[]...) then remoteFile must be a directory so need -d option.

Throws:

SshException

ChannelOpenException

put

public void put(String localFileRegExp,
                String remoteFile,
                boolean recursive,
                FileTransferProgress progress)
         throws SshException,
                ChannelOpenException

pattern matches the files in the local directory using "local" as a glob Regular Expression. For the matching file array put is called to copy the file to the remote directory.

Parameters:

localFileRegExp -

remoteFile -

recursive -

progress -

Throws:

SshException

ChannelOpenException

put

public void put(String[] localFiles,
                String remoteFile,
                boolean recursive)
         throws SshException,
                ChannelOpenException

Uploads an array of local files onto the remote server.

Parameters:

localFiles - an array of local files; may be files or directories

remoteFile - the path on the remote server, may be a file or directory.

recursive - Copy the contents of directorys recursivly

Throws:

IOException - if an IO error occurs during the operation

SshException

ChannelOpenException

put

public void put(String[] localFiles,
                String remoteFile,
                boolean recursive,
                FileTransferProgress progress)
         throws SshException,
                ChannelOpenException

Uploads an array of local files onto the remote server.

Parameters:

localFiles - an array of local files; may be files or directories

remoteFile - the path on the remote server, may be a file or directory1

recursive - Copy the contents of directorys recursivly

Throws:

IOException - if an IO error occurs during the operation

SshException

ChannelOpenException

get

public void get(String localDir,
                String[] remoteFiles,
                boolean recursive)
         throws SshException,
                ChannelOpenException

Downloads an array of remote files to the local computer.

Parameters:

localDir - The local path to place the files

remoteFiles - The path of the remote files

recursive - recursively copy the contents of a directory

Throws:

IOException - if an IO error occurs during the operation

SshException

ChannelOpenException

get

public void get(String localFile,
                String[] remoteFiles,
                boolean recursive,
                FileTransferProgress progress)
         throws SshException,
                ChannelOpenException

Throws:

SshException

ChannelOpenException

get

public void get(String localFile,
                String remoteFile,
                boolean recursive)
         throws SshException,
                ChannelOpenException

Downloads a remote file onto the local computer.

Parameters:

localFile - The path to place the file

remoteFile - The path of the file on the remote server

recursive - recursivly copy the contents of a directory

Throws:

IOException - if an IO error occurs during the operation

SshException

ChannelOpenException

get

public void get(String localFile,
                String remoteFile,
                boolean recursive,
                FileTransferProgress progress)
         throws SshException,
                ChannelOpenException

Throws:

SshException

ChannelOpenException

exit

public void exit()
          throws SshException,
                 IOException

Specified by:

exit in interface Client

Throws:

SshException

IOException