Package org.apache.sshd.scp.client

Class AbstractScpClient

java.lang.Object

org.apache.sshd.common.util.logging.AbstractLoggingBean

org.apache.sshd.scp.client.AbstractScpClient

All Implemented Interfaces:

ClientSessionHolder, SessionContextHolder, SessionHolder<ClientSession>, ScpClient

Direct Known Subclasses:

DefaultScpClient

public abstract class AbstractScpClient
extends org.apache.sshd.common.util.logging.AbstractLoggingBean
implements ScpClient

Author:

Apache MINA SSHD Project

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	AbstractScpClient.ScpOperationExecutor<T>

Nested classes/interfaces inherited from interface org.apache.sshd.scp.client.ScpClient

ScpClient.Option

Field Summary

Fields inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

log

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractScpClient()

Method Summary

Modifier and Type	Method	Description
protected Collection<ScpClient.Option>	addTargetIsDirectory(Collection<ScpClient.Option> options)
void	download(String[] remote, String local, Collection<ScpClient.Option> options)
void	download(String[] remote, Path local, Collection<ScpClient.Option> options)
void	download(String remote, String local, Collection<ScpClient.Option> options)
protected abstract void	download(String remote, FileSystem fs, Path local, Collection<ScpClient.Option> options)
void	download(String remote, Path local, Collection<ScpClient.Option> options)
protected void	handleCommandExitStatus(String cmd, Integer exitStatus)	Invoked by the various upload/download methods after having successfully completed the remote copy command and (optionally) having received an exit status from the remote server
protected void	handleCommandExitStatus(String cmd, ClientChannel channel)	Invoked by the various upload/download methods after having successfully completed the remote copy command and (optionally) having received an exit status from the remote server.
boolean	isOpen()
protected ChannelExec	openCommandChannel(ClientSession session, String cmd)
protected abstract <T> void	runUpload(String remote, Collection<ScpClient.Option> options, Collection<T> local, AbstractScpClient.ScpOperationExecutor<T> executor)
void	upload(String[] local, String remote, Collection<ScpClient.Option> options)
void	upload(Path[] local, String remote, Collection<ScpClient.Option> options)

Methods inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

debug, debug, debug, debug, debug, error, error, error, error, error, getSimplifiedLogger, info, info, warn, warn, warn, warn, warn, warn, warn, warn

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.sshd.client.session.ClientSessionHolder

getClientSession

Methods inherited from interface org.apache.sshd.scp.client.ScpClient

download, download, download, download, download, downloadBytes, getSession, upload, upload, upload, upload, upload, upload, upload, upload, upload

Methods inherited from interface org.apache.sshd.common.session.SessionHolder

getSessionContext

Constructor Details

AbstractScpClient

protected AbstractScpClient()

Method Details

isOpen

public boolean isOpen()

download

public void download(String[] remote,
 String local,
 Collection<ScpClient.Option> options)
              throws IOException

Specified by:

download in interface ScpClient

Throws:

IOException

download

public void download(String[] remote,
 Path local,
 Collection<ScpClient.Option> options)
              throws IOException

Specified by:

download in interface ScpClient

Throws:

IOException

download

public void download(String remote,
 Path local,
 Collection<ScpClient.Option> options)
              throws IOException

Specified by:

download in interface ScpClient

Throws:

IOException

download

public void download(String remote,
 String local,
 Collection<ScpClient.Option> options)
              throws IOException

Specified by:

download in interface ScpClient

Throws:

IOException

download

protected abstract void download(String remote,
 FileSystem fs,
 Path local,
 Collection<ScpClient.Option> options)
                          throws IOException

Throws:

IOException

upload

public void upload(String[] local,
 String remote,
 Collection<ScpClient.Option> options)
            throws IOException

Specified by:

upload in interface ScpClient

Throws:

IOException

upload

public void upload(Path[] local,
 String remote,
 Collection<ScpClient.Option> options)
            throws IOException

Specified by:

upload in interface ScpClient

Throws:

IOException

runUpload

protected abstract <T> void runUpload(String remote,
 Collection<ScpClient.Option> options,
 Collection<T> local,
 AbstractScpClient.ScpOperationExecutor<T> executor)
                               throws IOException

Throws:

IOException

handleCommandExitStatus

protected void handleCommandExitStatus(String cmd,
 ClientChannel channel)
                                throws IOException

Invoked by the various upload/download methods after having successfully completed the remote copy command and (optionally) having received an exit status from the remote server. If no exit status received within CoreModuleProperties.CHANNEL_CLOSE_TIMEOUT the no further action is taken. Otherwise, the exit status is examined to ensure it is either OK or WARNING - if not, an ScpException is thrown

Parameters:

cmd - The attempted remote copy command

channel - The ClientChannel through which the command was sent - Note: then channel may be in the process of being closed

Throws:

IOException - If failed the command

See Also:

• handleCommandExitStatus(String, Integer)

handleCommandExitStatus

protected void handleCommandExitStatus(String cmd,
 Integer exitStatus)
                                throws IOException

Invoked by the various upload/download methods after having successfully completed the remote copy command and (optionally) having received an exit status from the remote server

Parameters:

cmd - The attempted remote copy command

exitStatus - The exit status - if null then no status was reported

Throws:

IOException - If received non-OK exit status

addTargetIsDirectory

protected Collection<ScpClient.Option> addTargetIsDirectory(Collection<ScpClient.Option> options)

openCommandChannel

protected ChannelExec openCommandChannel(ClientSession session,
 String cmd)
                                  throws IOException

Throws:

IOException