org.apache.sshd.client.scp

Class AbstractScpClient

java.lang.Object

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

org.apache.sshd.client.scp.AbstractScpClient

All Implemented Interfaces:

ScpClient, ClientSessionHolder, SessionHolder<ClientSession>

Direct Known Subclasses:

DefaultScpClient

public abstract class AbstractScpClient
extends AbstractLoggingBean
implements ScpClient

Author:

Apache MINA SSHD Project

Nested Class Summary

Nested Classes

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

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

ScpClient.Option

Field Summary

Fields

Modifier and Type	Field and Description
static Set<ClientChannelEvent>	COMMAND_WAIT_EVENTS

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

log

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

DEFAULT_EXEC_CHANNEL_EXIT_STATUS_TIMEOUT, DEFAULT_EXEC_CHANNEL_OPEN_TIMEOUT, SCP_EXEC_CHANNEL_EXIT_STATUS_TIMEOUT, SCP_EXEC_CHANNEL_OPEN_TIMEOUT

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractScpClient()

Method Summary

Modifier and Type	Method and Description
protected Collection<ScpClient.Option>	addTargetIsDirectory(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)
void	download(String remote, String local, Collection<ScpClient.Option> options)
ClientSession	getSession()
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.
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 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(Path[] local, String remote, Collection<ScpClient.Option> options)
void	upload(String[] local, String remote, Collection<ScpClient.Option> options)

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

getSimplifiedLogger

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.scp.ScpClient

createReceiveCommand, createSendCommand, download, download, download, download, download, downloadBytes, upload, upload, upload, upload, upload, upload, upload, upload, upload

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

getClientSession

Field Detail

COMMAND_WAIT_EVENTS

public static final Set<ClientChannelEvent> COMMAND_WAIT_EVENTS

Constructor Detail

AbstractScpClient

protected AbstractScpClient()

Method Detail

getSession

public final ClientSession getSession()

Specified by:

getSession in interface SessionHolder<ClientSession>

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 FactoryManager.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 failed the command

addTargetIsDirectory

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

openCommandChannel

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

Throws:

IOException