Package org.apache.sshd.scp.common

Class ScpHelper

java.lang.Object

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

org.apache.sshd.scp.common.ScpHelper

All Implemented Interfaces:

org.apache.sshd.common.session.SessionContextHolder, org.apache.sshd.common.session.SessionHolder<org.apache.sshd.common.session.Session>

public class ScpHelper
extends org.apache.sshd.common.util.logging.AbstractLoggingBean
implements org.apache.sshd.common.session.SessionHolder<org.apache.sshd.common.session.Session>

Author:

Apache MINA SSHD Project

Field Summary

Fields

Modifier and Type	Field	Description
protected final Charset	csIn
protected final Charset	csOut
static final int	DEFAULT_COPY_BUFFER_SIZE	Default size (in bytes) of send / receive buffer size
static final int	DEFAULT_RECEIVE_BUFFER_SIZE
static final int	DEFAULT_SEND_BUFFER_SIZE
protected final FileSystem	fileSystem
protected final InputStream	in
protected final ScpTransferEventListener	listener
static final int	MIN_COPY_BUFFER_SIZE	The minimum size for sending / receiving files
static final int	MIN_RECEIVE_BUFFER_SIZE
static final int	MIN_SEND_BUFFER_SIZE
protected final ScpFileOpener	opener
protected final OutputStream	out
static final String	SCP_COMMAND_PREFIX	Command prefix used to identify SCP commands

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

log

Constructor Summary

Constructors

Constructor	Description
ScpHelper(org.apache.sshd.common.session.Session session, InputStream in, OutputStream out, FileSystem fileSystem, ScpFileOpener opener, ScpTransferEventListener eventListener)
ScpHelper(org.apache.sshd.common.session.Session session, InputStream in, Charset csIn, OutputStream out, Charset csOut, FileSystem fileSystem, ScpFileOpener opener, ScpTransferEventListener eventListener)

Method Summary

Modifier and Type	Method	Description
org.apache.sshd.common.session.Session	getSession()
ScpAckInfo	readAck(boolean canEof)
void	readAndValidateOperationAck(String cmd, Object location)
String	readLine()
String	readLine(boolean canEof)
void	receive(String cmd, Path local, boolean recursive, boolean shouldBeDir, boolean preserve, int bufferSize)
protected void	receive(String cmd, ScpReceiveLineHandler handler)	Reads command line(s) and invokes the handler until EOF or and "E" command is received
void	receiveDir(String header, Path local, ScpTimestampCommandDetails time, boolean preserve, int bufferSize)
void	receiveFile(String header, Path local, ScpTimestampCommandDetails time, boolean preserve, int bufferSize)
void	receiveFileStream(String command, OutputStream local, int bufferSize)
protected ScpAckInfo	receiveNextCmd()
void	receiveStream(String header, ScpTargetStreamResolver resolver, ScpTimestampCommandDetails time, boolean preserve, int bufferSize)
Path	resolveLocalPath(String commandPath)
Path	resolveLocalPath(String basedir, String subpath)
protected void	send(Path local, boolean recursive, boolean preserve, int bufferSize, LinkOption... options)
void	send(Collection<String> paths, boolean recursive, boolean preserve, int bufferSize)
protected ScpAckInfo	sendAcknowledgedCommand(String cmd)
void	sendDir(Path local, boolean preserve, int bufferSize)
protected void	sendError(String message)
void	sendFile(Path local, boolean preserve, int bufferSize)
void	sendOk()
void	sendPaths(Collection<? extends Path> paths, boolean recursive, boolean preserve, int bufferSize)
protected void	sendResponseMessage(int level, String message)
void	sendStream(ScpSourceStreamResolver resolver, boolean preserve, int bufferSize)
protected void	sendWarning(String message)
String	toString()
protected void	validateAckReplyCode(String command, Object location, ScpAckInfo ackInfo)
protected void	validateCommandStatusCode(String command, Object location, ScpAckInfo ackInfo, boolean eofAllowed)
protected void	validateFileOperationAckReplyCode(String command, org.apache.sshd.common.session.Session session, ScpTransferEventListener.FileOperation op, Path file, long fileSize, Set<PosixFilePermission> perms, ScpAckInfo ackInfo)
protected void	validateOperationReadyCode(String command, Object location, ScpAckInfo ackInfo)

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, wait, wait, wait

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

getSessionContext

Field Details

SCP_COMMAND_PREFIX

public static final String SCP_COMMAND_PREFIX

Command prefix used to identify SCP commands

See Also:

• Constant Field Values

DEFAULT_COPY_BUFFER_SIZE

public static final int DEFAULT_COPY_BUFFER_SIZE

Default size (in bytes) of send / receive buffer size

See Also:

• Constant Field Values

DEFAULT_RECEIVE_BUFFER_SIZE

public static final int DEFAULT_RECEIVE_BUFFER_SIZE

See Also:

• Constant Field Values

DEFAULT_SEND_BUFFER_SIZE

public static final int DEFAULT_SEND_BUFFER_SIZE

See Also:

• Constant Field Values

MIN_COPY_BUFFER_SIZE

public static final int MIN_COPY_BUFFER_SIZE

The minimum size for sending / receiving files

See Also:

• Constant Field Values

MIN_RECEIVE_BUFFER_SIZE

public static final int MIN_RECEIVE_BUFFER_SIZE

See Also:

• Constant Field Values

MIN_SEND_BUFFER_SIZE

public static final int MIN_SEND_BUFFER_SIZE

See Also:

• Constant Field Values

in

protected final InputStream in

csIn

protected final Charset csIn

out

protected final OutputStream out

csOut

protected final Charset csOut

fileSystem

protected final FileSystem fileSystem

opener

protected final ScpFileOpener opener

listener

protected final ScpTransferEventListener listener

Constructor Details

ScpHelper

public ScpHelper(org.apache.sshd.common.session.Session session,
 InputStream in,
 OutputStream out,
 FileSystem fileSystem,
 ScpFileOpener opener,
 ScpTransferEventListener eventListener)

ScpHelper

public ScpHelper(org.apache.sshd.common.session.Session session,
 InputStream in,
 Charset csIn,
 OutputStream out,
 Charset csOut,
 FileSystem fileSystem,
 ScpFileOpener opener,
 ScpTransferEventListener eventListener)

Method Details

getSession

public org.apache.sshd.common.session.Session getSession()

Specified by:

getSession in interface org.apache.sshd.common.session.SessionHolder<org.apache.sshd.common.session.Session>

receiveFileStream

public void receiveFileStream(String command,
 OutputStream local,
 int bufferSize)
                       throws IOException

Throws:

IOException

receive

public void receive(String cmd,
 Path local,
 boolean recursive,
 boolean shouldBeDir,
 boolean preserve,
 int bufferSize)
             throws IOException

Throws:

IOException

receive

protected void receive(String cmd,
 ScpReceiveLineHandler handler)
                throws IOException

Reads command line(s) and invokes the handler until EOF or and "E" command is received

Parameters:

cmd - The receive command being attempted

handler - The ScpReceiveLineHandler to invoke when a command has been read

Throws:

IOException - If failed to read/write

receiveNextCmd

protected ScpAckInfo receiveNextCmd()
                             throws IOException

Throws:

IOException

receiveDir

public void receiveDir(String header,
 Path local,
 ScpTimestampCommandDetails time,
 boolean preserve,
 int bufferSize)
                throws IOException

Throws:

IOException

receiveFile

public void receiveFile(String header,
 Path local,
 ScpTimestampCommandDetails time,
 boolean preserve,
 int bufferSize)
                 throws IOException

Throws:

IOException

receiveStream

public void receiveStream(String header,
 ScpTargetStreamResolver resolver,
 ScpTimestampCommandDetails time,
 boolean preserve,
 int bufferSize)
                   throws IOException

Throws:

IOException

readLine

public String readLine()
                throws IOException

Throws:

IOException

readLine

public String readLine(boolean canEof)
                throws IOException

Throws:

IOException

send

public void send(Collection<String> paths,
 boolean recursive,
 boolean preserve,
 int bufferSize)
          throws IOException

Throws:

IOException

sendPaths

public void sendPaths(Collection<? extends Path> paths,
 boolean recursive,
 boolean preserve,
 int bufferSize)
               throws IOException

Throws:

IOException

send

protected void send(Path local,
 boolean recursive,
 boolean preserve,
 int bufferSize,
 LinkOption... options)
             throws IOException

Throws:

IOException

resolveLocalPath

public Path resolveLocalPath(String basedir,
 String subpath)
                      throws IOException

Throws:

IOException

resolveLocalPath

public Path resolveLocalPath(String commandPath)
                      throws IOException,
InvalidPathException

Parameters:

commandPath - The command path using the local file separator

Returns:

The resolved absolute and normalized local Path

Throws:

IOException - If failed to resolve the path

InvalidPathException - If invalid local path value

sendFile

public void sendFile(Path local,
 boolean preserve,
 int bufferSize)
              throws IOException

Throws:

IOException

sendStream

public void sendStream(ScpSourceStreamResolver resolver,
 boolean preserve,
 int bufferSize)
                throws IOException

Throws:

IOException

validateOperationReadyCode

protected void validateOperationReadyCode(String command,
 Object location,
 ScpAckInfo ackInfo)
                                   throws IOException

Throws:

IOException

validateFileOperationAckReplyCode

protected void validateFileOperationAckReplyCode(String command,
 org.apache.sshd.common.session.Session session,
 ScpTransferEventListener.FileOperation op,
 Path file,
 long fileSize,
 Set<PosixFilePermission> perms,
 ScpAckInfo ackInfo)
                                          throws IOException

Throws:

IOException

validateAckReplyCode

protected void validateAckReplyCode(String command,
 Object location,
 ScpAckInfo ackInfo)
                             throws IOException

Throws:

IOException

validateCommandStatusCode

protected void validateCommandStatusCode(String command,
 Object location,
 ScpAckInfo ackInfo,
 boolean eofAllowed)
                                  throws IOException

Throws:

IOException

sendDir

public void sendDir(Path local,
 boolean preserve,
 int bufferSize)
             throws IOException

Throws:

IOException

sendAcknowledgedCommand

protected ScpAckInfo sendAcknowledgedCommand(String cmd)
                                      throws IOException

Throws:

IOException

sendOk

public void sendOk()
            throws IOException

Throws:

IOException

sendWarning

protected void sendWarning(String message)
                    throws IOException

Throws:

IOException

sendError

protected void sendError(String message)
                  throws IOException

Throws:

IOException

sendResponseMessage

protected void sendResponseMessage(int level,
 String message)
                            throws IOException

Throws:

IOException

readAck

public ScpAckInfo readAck(boolean canEof)
                   throws IOException

Throws:

IOException

readAndValidateOperationAck

public void readAndValidateOperationAck(String cmd,
 Object location)
                                 throws IOException

Throws:

IOException

toString

public String toString()

Overrides:

toString in class Object