Package org.apache.sshd.sftp.client.impl

Class AbstractSftpClient

java.lang.Object

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

org.apache.sshd.client.subsystem.AbstractSubsystemClient

org.apache.sshd.sftp.client.impl.AbstractSftpClient

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, java.nio.channels.Channel, ClientChannelHolder, ClientSessionHolder, SubsystemClient, ChannelHolder, NamedResource, SessionContextHolder, SessionHolder<ClientSession>, FullAccessSftpClient, RawSftpClient, SftpClient, SftpErrorDataHandler

Direct Known Subclasses:

DefaultSftpClient, SftpFileSystem.Wrapper

public abstract class AbstractSftpClient
extends AbstractSubsystemClient
implements FullAccessSftpClient, SftpErrorDataHandler

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.sshd.sftp.client.SftpClient

SftpClient.Attribute, SftpClient.Attributes, SftpClient.CloseableHandle, SftpClient.CopyMode, SftpClient.DirEntry, SftpClient.Handle, SftpClient.OpenMode

Field Summary

Fields

Modifier and Type	Field	Description
protected SftpErrorDataHandler	errorDataHandler
private SftpClient.Attributes	fileOpenAttributes
static int	INIT_COMMAND_SIZE
private java.util.concurrent.atomic.AtomicReference<java.util.Map<java.lang.String,java.lang.Object>>	parsedExtensionsHolder
static Property<java.time.Duration>	SFTP_CLIENT_CMD_TIMEOUT	Property that can be used on the FactoryManager to control the internal timeout used by the client to complete the buffer sending in RawSftpClient.send(int, Buffer).

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

log

Fields inherited from interface org.apache.sshd.common.NamedResource

BY_NAME_COMPARATOR, NAME_EXTRACTOR

Fields inherited from interface org.apache.sshd.sftp.client.SftpClient

DEFAULT_CHANNEL_MODES, EMPTY_DIR_ENTRIES, IO_BUFFER_SIZE, MIN_BUFFER_SIZE, MIN_READ_BUFFER_SIZE, MIN_WRITE_BUFFER_SIZE

Fields inherited from interface org.apache.sshd.sftp.client.SftpErrorDataHandler

EMPTY

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractSftpClient(SftpErrorDataHandler delegateHandler)

Method Summary

Modifier and Type	Method	Description
java.lang.String	canonicalPath(java.lang.String path)	The effective "normalized" remote path
protected SftpClient.Attributes	checkAttributes(int cmd, Buffer request)
protected SftpClient.Attributes	checkAttributesResponse(SftpResponse response)
protected void	checkCommandStatus(int cmd, Buffer request)	Sends the specified command, waits for the response and then invokes checkResponseStatus(SftpResponse)
protected Buffer	checkDataResponse(SftpAckData ack, SftpResponse response, java.util.concurrent.atomic.AtomicReference<java.lang.Boolean> eofSignalled)	Processes a response to an SSH_FXP_READ request.
protected java.util.List<SftpClient.DirEntry>	checkDirResponse(SftpResponse response, java.util.concurrent.atomic.AtomicReference<java.lang.Boolean> eolIndicator)
protected byte[]	checkHandle(int cmd, Buffer request)
protected byte[]	checkHandleResponse(SftpResponse response)
protected java.lang.String	checkOneName(int cmd, Buffer request)
protected java.lang.String	checkOneNameResponse(SftpResponse response)
protected void	checkResponseStatus(int cmd, int id, SftpStatus status)
protected void	checkResponseStatus(SftpResponse response)	Checks if the incoming response is an SSH_FXP_STATUS one, and if so whether the substatus is SSH_FX_OK.
void	close(SftpClient.Handle handle)	Close the handle obtained from one of the open methods
void	errorData(byte[] buf, int start, int len)	Receive binary data from server error stream
Channel	getChannel()
<E extends SftpClientExtension> E	getExtension(java.lang.Class<? extends E> extensionType)
SftpClientExtension	getExtension(SftpClientExtensionFactory factory)
protected java.util.Map<java.lang.String,java.lang.Object>	getParsedServerExtensions()
protected java.util.Map<java.lang.String,java.lang.Object>	getParsedServerExtensions(java.util.Map<java.lang.String,byte[]> extensions)
protected int	getReadBufferSize()
protected java.lang.String	getReferencedName(int cmd, Buffer buf, int nameIndex)
protected int	getWriteBufferSize()
protected SftpClient.Attributes	handleUnexpectedAttributesPacket(SftpResponse response)
protected byte[]	handleUnexpectedHandlePacket(SftpResponse response)
protected java.io.IOException	handleUnexpectedPacket(int expected, SftpResponse response)
protected int	handleUnknownDataPacket(SftpResponse response)
protected java.util.List<SftpClient.DirEntry>	handleUnknownDirListingPacket(SftpResponse response)
protected java.lang.String	handleUnknownOneNamePacket(SftpResponse response)
void	link(java.lang.String linkPath, java.lang.String targetPath, boolean symbolic)	Create a link
java.lang.Iterable<SftpClient.DirEntry>	listDir(SftpClient.Handle handle)
void	lock(SftpClient.Handle handle, long offset, long length, int mask)
SftpClient.Attributes	lstat(java.lang.String path)	Retrieve remote path meta-data - do not follow symbolic links
void	mkdir(java.lang.String path)	Create remote directory
SftpClient.CloseableHandle	open(java.lang.String path, java.util.Collection<SftpClient.OpenMode> options)	Opens a remote file with the specified mode(s)
SftpClient.CloseableHandle	openDir(java.lang.String path)	Obtain a handle for a directory
java.nio.channels.FileChannel	openRemoteFileChannel(java.lang.String path, java.util.Collection<SftpClient.OpenMode> modes)	Opens an FileChannel on the specified remote path
void	put(java.io.InputStream stream, int bufferSize, java.lang.String path, java.util.Collection<SftpClient.OpenMode> modes)	Write data from an InputStream to a remote file.
protected <B extends Buffer> B	putReferencedName(int cmd, B buf, java.lang.String name, int nameIndex)
java.io.InputStream	read(java.lang.String path, int bufferSize, java.util.Collection<SftpClient.OpenMode> mode)	Read a remote file's data via an input stream
int	read(SftpClient.Handle handle, long fileOffset, byte[] dst, int dstOffset, int len, java.util.concurrent.atomic.AtomicReference<java.lang.Boolean> eofSignalled)	Reads data from the open (file) handle
protected SftpClient.Attributes	readAttributes(int cmd, Buffer buffer, java.util.concurrent.atomic.AtomicInteger nameIndex)
java.lang.Iterable<SftpClient.DirEntry>	readDir(java.lang.String path)
java.util.List<SftpClient.DirEntry>	readDir(SftpClient.Handle handle, java.util.concurrent.atomic.AtomicReference<java.lang.Boolean> eolIndicator)
java.lang.String	readLink(java.lang.String path)	Retrieve target of a link
void	remove(java.lang.String path)
void	rename(java.lang.String oldPath, java.lang.String newPath, java.util.Collection<SftpClient.CopyMode> options)
protected SftpResponse	response(int cmd, int requestId)	Receives a response buffer, validates and returns it as a SftpResponse.
void	rmdir(java.lang.String path)	Remove remote directory
protected SftpResponse	rpc(int cmd, Buffer request)	Perform an SFTP request and wait until the response has been received.
private SftpClient.Attributes	safeStat(java.lang.String path)
void	setStat(java.lang.String path, SftpClient.Attributes attributes)	Update remote node meta-data
void	setStat(SftpClient.Handle handle, SftpClient.Attributes attributes)	Update remote node meta-data
SftpClient.Attributes	stat(java.lang.String path)	Retrieve remote path meta-data - follow symbolic links if encountered
SftpClient.Attributes	stat(SftpClient.Handle handle)	Retrieve file/directory handle meta-data
protected void	throwStatusException(int cmd, int id, SftpStatus status)
void	unlock(SftpClient.Handle handle, long offset, long length)
SftpOutputStreamAsync	write(java.lang.String path, int bufferSize, java.util.Collection<SftpClient.OpenMode> mode)	Write to a remote file via an output stream
void	write(SftpClient.Handle handle, long fileOffset, byte[] src, int srcOffset, int len)	Write data to (open) file handle
protected <B extends Buffer> B	writeAttributes(int cmd, B buffer, SftpClient.Attributes attributes)

Methods inherited from class org.apache.sshd.client.subsystem.AbstractSubsystemClient

toString

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 java.nio.channels.Channel

close, isOpen

Methods inherited from interface org.apache.sshd.client.channel.ClientChannelHolder

getClientChannel

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

getClientSession

Methods inherited from interface org.apache.sshd.sftp.client.RawSftpClient

receive, receive, receive, send, write

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

getSessionContext

Methods inherited from interface org.apache.sshd.sftp.client.SftpClient

getExtension, getName, getNameDecodingCharset, getServerExtensions, getVersion, isClosing, open, open, openRemoteFileChannel, openRemotePathChannel, openRemotePathChannel, put, put, put, put, put, put, put, put, put, put, put, read, read, read, read, read, read, read, read, readDir, readEntries, rename, rename, setNameDecodingCharset, singleSessionInstance, symLink, write, write, write, write, write, write

Methods inherited from interface org.apache.sshd.client.subsystem.SubsystemClient

getSession

Field Detail

INIT_COMMAND_SIZE

public static final int INIT_COMMAND_SIZE

See Also:

Constant Field Values

SFTP_CLIENT_CMD_TIMEOUT

public static final Property<java.time.Duration> SFTP_CLIENT_CMD_TIMEOUT

Property that can be used on the FactoryManager to control the internal timeout used by the client to complete the buffer sending in RawSftpClient.send(int, Buffer).

errorDataHandler

protected final SftpErrorDataHandler errorDataHandler

fileOpenAttributes

private final SftpClient.Attributes fileOpenAttributes

parsedExtensionsHolder

private final java.util.concurrent.atomic.AtomicReference<java.util.Map<java.lang.String,java.lang.Object>> parsedExtensionsHolder

Constructor Detail

AbstractSftpClient

protected AbstractSftpClient(SftpErrorDataHandler delegateHandler)

Method Detail

getChannel

public Channel getChannel()

Specified by:

getChannel in interface ChannelHolder

Specified by:

getChannel in interface ClientChannelHolder

Returns:

The associated Channel instance

getExtension

public <E extends SftpClientExtension> E getExtension(java.lang.Class<? extends E> extensionType)

Specified by:

getExtension in interface SftpClient

Type Parameters:

E - The generic extension type

Parameters:

extensionType - The extension type

Returns:

The extension instance - Note: it is up to the caller to invoke OptionalFeature.isSupported() - null if this extension type is not implemented by the client

See Also:

SftpClient.getServerExtensions()

getExtension

public SftpClientExtension getExtension(SftpClientExtensionFactory factory)

Specified by:

getExtension in interface SftpClient

Parameters:

factory - The SftpClientExtensionFactory instance to use - ignored if null

Returns:

The extension instance - Note: it is up to the caller to invoke OptionalFeature.isSupported() - null if this extension type is not implemented by the client

getParsedServerExtensions

protected java.util.Map<java.lang.String,java.lang.Object> getParsedServerExtensions()

getParsedServerExtensions

protected java.util.Map<java.lang.String,java.lang.Object> getParsedServerExtensions(java.util.Map<java.lang.String,byte[]> extensions)

getReferencedName

protected java.lang.String getReferencedName(int cmd,
                                             Buffer buf,
                                             int nameIndex)

Parameters:

cmd - The command that was sent whose response contains the name to be decoded

buf - The Buffer containing the encoded name

nameIndex - The zero-based order of the requested names for the command - e.g.,

• When listing a directory's contents each successive name will have an increasing index.
• For SFTP version 3, when retrieving a single name, short name will have index=0 and the long one index=1.

Returns:

The decoded referenced name

putReferencedName

protected <B extends Buffer> B putReferencedName(int cmd,
                                                 B buf,
                                                 java.lang.String name,
                                                 int nameIndex)

Type Parameters:

B - Type of Buffer being updated

Parameters:

cmd - The command for which this name is being added

buf - The buffer instance to update

name - The name to place in the buffer

nameIndex - The zero-based order of the name for the specific command if more than one name required - e.g., rename, link/symbolic link

Returns:

The updated buffer

rpc

protected SftpResponse rpc(int cmd,
                           Buffer request)
                    throws java.io.IOException

Perform an SFTP request and wait until the response has been received.

Parameters:

cmd - the SFTP command code

request - a Buffer containing the request data

Returns:

the SftpResponse for the request

Throws:

java.io.IOException - if an error occurs

response

protected SftpResponse response(int cmd,
                                int requestId)
                         throws java.io.IOException

Receives a response buffer, validates and returns it as a SftpResponse.

Parameters:

cmd - the command of the request the response is for

requestId - the id of the request

Returns:

the SftpResponse

Throws:

java.io.IOException - if the received buffer is malformed

checkCommandStatus

protected void checkCommandStatus(int cmd,
                                  Buffer request)
                           throws java.io.IOException

Sends the specified command, waits for the response and then invokes checkResponseStatus(SftpResponse)

Parameters:

cmd - The command to send

request - The request Buffer

Throws:

java.io.IOException - If failed to send, receive or check the returned status

See Also:

RawSftpClient.send(int, Buffer), RawSftpClient.receive(int), checkResponseStatus(SftpResponse)

checkResponseStatus

protected void checkResponseStatus(SftpResponse response)
                            throws java.io.IOException

Checks if the incoming response is an SSH_FXP_STATUS one, and if so whether the substatus is SSH_FX_OK.

Parameters:

response - The received SftpResponse

Throws:

java.io.IOException - If response does not carry a status or carries a bad status code

See Also:

checkResponseStatus(int, int, SftpStatus)

checkResponseStatus

protected void checkResponseStatus(int cmd,
                                   int id,
                                   SftpStatus status)
                            throws java.io.IOException

Parameters:

cmd - The sent command opcode

id - The request id

status - The SftpStatus

Throws:

java.io.IOException - if !status.isOk()

See Also:

throwStatusException(int, int, SftpStatus)

throwStatusException

protected void throwStatusException(int cmd,
                                    int id,
                                    SftpStatus status)
                             throws java.io.IOException

Throws:

java.io.IOException

checkHandle

protected byte[] checkHandle(int cmd,
                             Buffer request)
                      throws java.io.IOException

Parameters:

cmd - Command to be sent

request - The Buffer containing the request

Returns:

The received handle identifier

Throws:

java.io.IOException - If failed to send/receive or process the response

See Also:

RawSftpClient.send(int, Buffer), RawSftpClient.receive(int), checkHandleResponse(SftpResponse)

checkHandleResponse

protected byte[] checkHandleResponse(SftpResponse response)
                              throws java.io.IOException

Throws:

java.io.IOException

handleUnexpectedHandlePacket

protected byte[] handleUnexpectedHandlePacket(SftpResponse response)
                                       throws java.io.IOException

Throws:

java.io.IOException

checkAttributes

protected SftpClient.Attributes checkAttributes(int cmd,
                                                Buffer request)
                                         throws java.io.IOException

Parameters:

cmd - Command to be sent

request - Request Buffer

Returns:

The decoded response Attributes

Throws:

java.io.IOException - If failed to send/receive or process the response

See Also:

RawSftpClient.send(int, Buffer), RawSftpClient.receive(int), checkAttributesResponse(SftpResponse)

checkAttributesResponse

protected SftpClient.Attributes checkAttributesResponse(SftpResponse response)
                                                 throws java.io.IOException

Throws:

java.io.IOException

handleUnexpectedAttributesPacket

protected SftpClient.Attributes handleUnexpectedAttributesPacket(SftpResponse response)
                                                          throws java.io.IOException

Throws:

java.io.IOException

checkOneName

protected java.lang.String checkOneName(int cmd,
                                        Buffer request)
                                 throws java.io.IOException

Parameters:

cmd - Command to be sent

request - The request Buffer

Returns:

The retrieved name

Throws:

java.io.IOException - If failed to send/receive or process the response

See Also:

RawSftpClient.send(int, Buffer), RawSftpClient.receive(int), checkOneNameResponse(SftpResponse)

checkOneNameResponse

protected java.lang.String checkOneNameResponse(SftpResponse response)
                                         throws java.io.IOException

Throws:

java.io.IOException

handleUnknownOneNamePacket

protected java.lang.String handleUnknownOneNamePacket(SftpResponse response)
                                               throws java.io.IOException

Throws:

java.io.IOException

readAttributes

protected SftpClient.Attributes readAttributes(int cmd,
                                               Buffer buffer,
                                               java.util.concurrent.atomic.AtomicInteger nameIndex)
                                        throws java.io.IOException

Throws:

java.io.IOException

writeAttributes

protected <B extends Buffer> B writeAttributes(int cmd,
                                               B buffer,
                                               SftpClient.Attributes attributes)

open

public SftpClient.CloseableHandle open(java.lang.String path,
                                       java.util.Collection<SftpClient.OpenMode> options)
                                throws java.io.IOException

Description copied from interface: SftpClient

Opens a remote file with the specified mode(s)

Specified by:

open in interface SftpClient

Parameters:

path - The remote path

options - The desired mode - if none specified then SftpClient.OpenMode.Read is assumed

Returns:

The file's SftpClient.CloseableHandle

Throws:

java.io.IOException - If failed to open the remote file

close

public void close(SftpClient.Handle handle)
           throws java.io.IOException

Description copied from interface: SftpClient

Close the handle obtained from one of the open methods

Specified by:

close in interface SftpClient

Parameters:

handle - The Handle to close

Throws:

java.io.IOException - If failed to execute

remove

public void remove(java.lang.String path)
            throws java.io.IOException

Specified by:

remove in interface SftpClient

Parameters:

path - The remote path to remove

Throws:

java.io.IOException - If failed to execute

rename

public void rename(java.lang.String oldPath,
                   java.lang.String newPath,
                   java.util.Collection<SftpClient.CopyMode> options)
            throws java.io.IOException

Specified by:

rename in interface SftpClient

Throws:

java.io.IOException

read

public int read(SftpClient.Handle handle,
                long fileOffset,
                byte[] dst,
                int dstOffset,
                int len,
                java.util.concurrent.atomic.AtomicReference<java.lang.Boolean> eofSignalled)
         throws java.io.IOException

Description copied from interface: SftpClient

Reads data from the open (file) handle

Specified by:

read in interface SftpClient

Parameters:

handle - The file SftpClient.Handle to read from

fileOffset - The file offset to read from

dst - The destination buffer

dstOffset - Offset in destination buffer to place the read data

len - Available destination buffer size to read

eofSignalled - If not null then upon return holds a value indicating whether EOF was reached due to the read. If null indicator value then this indication is not available

Returns:

Number of read bytes - -1 if EOF reached

Throws:

java.io.IOException - If failed to read the data

See Also:

SFTP v6 - section 9.3

checkDataResponse

protected Buffer checkDataResponse(SftpAckData ack,
                                   SftpResponse response,
                                   java.util.concurrent.atomic.AtomicReference<java.lang.Boolean> eofSignalled)
                            throws java.io.IOException

Processes a response to an SSH_FXP_READ request.

Parameters:

ack - describing the SSH_FXP_READ request

response - SFTP response received

eofSignalled - if non-null, set to true if an EOF was received

Returns:

a Buffer containing the data received (may be empty), or null if the response was an SSH_FXP_EOF status

Throws:

java.io.IOException - on errors

handleUnknownDataPacket

protected int handleUnknownDataPacket(SftpResponse response)
                               throws java.io.IOException

Throws:

java.io.IOException

errorData

public void errorData(byte[] buf,
                      int start,
                      int len)
               throws java.io.IOException

Description copied from interface: SftpErrorDataHandler

Receive binary data from server error stream

Specified by:

errorData in interface SftpErrorDataHandler

Parameters:

buf - The buffer of the incoming data

start - Offset in buffer to read the data

len - Available data in buffer

Throws:

java.io.IOException - If failed to receive incoming data

write

public void write(SftpClient.Handle handle,
                  long fileOffset,
                  byte[] src,
                  int srcOffset,
                  int len)
           throws java.io.IOException

Description copied from interface: SftpClient

Write data to (open) file handle

Specified by:

write in interface SftpClient

Parameters:

handle - The file SftpClient.Handle

fileOffset - Zero-based offset to write in file

src - Data buffer

srcOffset - Offset of valid data in buffer

len - Number of bytes to write

Throws:

java.io.IOException - If failed to write the data

mkdir

public void mkdir(java.lang.String path)
           throws java.io.IOException

Description copied from interface: SftpClient

Create remote directory

Specified by:

mkdir in interface SftpClient

Parameters:

path - Remote directory path

Throws:

java.io.IOException - If failed to execute

rmdir

public void rmdir(java.lang.String path)
           throws java.io.IOException

Description copied from interface: SftpClient

Remove remote directory

Specified by:

rmdir in interface SftpClient

Parameters:

path - Remote directory path

Throws:

java.io.IOException - If failed to execute

openDir

public SftpClient.CloseableHandle openDir(java.lang.String path)
                                   throws java.io.IOException

Description copied from interface: SftpClient

Obtain a handle for a directory

Specified by:

openDir in interface SftpClient

Parameters:

path - Remote directory path

Returns:

The associated directory SftpClient.Handle

Throws:

java.io.IOException - If failed to execute

readDir

public java.util.List<SftpClient.DirEntry> readDir(SftpClient.Handle handle,
                                                   java.util.concurrent.atomic.AtomicReference<java.lang.Boolean> eolIndicator)
                                            throws java.io.IOException

Specified by:

readDir in interface SftpClient

Parameters:

handle - Directory SftpClient.Handle to read from

eolIndicator - An indicator that can be used to get information whether end of list has been reached - ignored if null. Upon return, set value indicates whether all entries have been exhausted - a null value means that this information cannot be provided and another call to readDir is necessary in order to verify that no more entries are pending

Returns:

A List of entries - null to indicate no more entries

Throws:

java.io.IOException - If failed to access the remote site

See Also:

SFTP v6 - section 9.4

checkDirResponse

protected java.util.List<SftpClient.DirEntry> checkDirResponse(SftpResponse response,
                                                               java.util.concurrent.atomic.AtomicReference<java.lang.Boolean> eolIndicator)
                                                        throws java.io.IOException

Throws:

java.io.IOException

handleUnknownDirListingPacket

protected java.util.List<SftpClient.DirEntry> handleUnknownDirListingPacket(SftpResponse response)
                                                                     throws java.io.IOException

Throws:

java.io.IOException

handleUnexpectedPacket

protected java.io.IOException handleUnexpectedPacket(int expected,
                                                     SftpResponse response)
                                              throws java.io.IOException

Parameters:

expected - The expected packet type

response - The actual SftpResponse received

Returns:

The exception to throw - if null then implementor assumed to handle the exception internal. Otherwise, the exception is re-thrown

Throws:

java.io.IOException - If failed to handle the exception internally

canonicalPath

public java.lang.String canonicalPath(java.lang.String path)
                               throws java.io.IOException

Description copied from interface: SftpClient

The effective "normalized" remote path

Specified by:

canonicalPath in interface SftpClient

Parameters:

path - The requested path - may be relative, and/or contain dots - e.g., ".", "..", "./foo", "../bar"

Returns:

The effective "normalized" remote path

Throws:

java.io.IOException - If failed to execute

stat

public SftpClient.Attributes stat(java.lang.String path)
                           throws java.io.IOException

Description copied from interface: SftpClient

Retrieve remote path meta-data - follow symbolic links if encountered

Specified by:

stat in interface SftpClient

Parameters:

path - The remote path

Returns:

The associated SftpClient.Attributes

Throws:

java.io.IOException - If failed to execute

lstat

public SftpClient.Attributes lstat(java.lang.String path)
                            throws java.io.IOException

Description copied from interface: SftpClient

Retrieve remote path meta-data - do not follow symbolic links

Specified by:

lstat in interface SftpClient

Parameters:

path - The remote path

Returns:

The associated SftpClient.Attributes

Throws:

java.io.IOException - If failed to execute

stat

public SftpClient.Attributes stat(SftpClient.Handle handle)
                           throws java.io.IOException

Description copied from interface: SftpClient

Retrieve file/directory handle meta-data

Specified by:

stat in interface SftpClient

Parameters:

handle - The SftpClient.Handle obtained via one of the open calls

Returns:

The associated SftpClient.Attributes

Throws:

java.io.IOException - If failed to execute

setStat

public void setStat(java.lang.String path,
                    SftpClient.Attributes attributes)
             throws java.io.IOException

Description copied from interface: SftpClient

Update remote node meta-data

Specified by:

setStat in interface SftpClient

Parameters:

path - The remote path

attributes - The SftpClient.Attributes to update

Throws:

java.io.IOException - If failed to execute

setStat

public void setStat(SftpClient.Handle handle,
                    SftpClient.Attributes attributes)
             throws java.io.IOException

Description copied from interface: SftpClient

Update remote node meta-data

Specified by:

setStat in interface SftpClient

Parameters:

handle - The SftpClient.Handle obtained via one of the open calls

attributes - The SftpClient.Attributes to update

Throws:

java.io.IOException - If failed to execute

readLink

public java.lang.String readLink(java.lang.String path)
                          throws java.io.IOException

Description copied from interface: SftpClient

Retrieve target of a link

Specified by:

readLink in interface SftpClient

Parameters:

path - Remote path that represents a link

Returns:

The link target

Throws:

java.io.IOException - If failed to execute

link

public void link(java.lang.String linkPath,
                 java.lang.String targetPath,
                 boolean symbolic)
          throws java.io.IOException

Description copied from interface: SftpClient

Create a link

Specified by:

link in interface SftpClient

Parameters:

linkPath - The link location

targetPath - The referenced target by the link

symbolic - If true then make this a symbolic link, otherwise a hard one

Throws:

java.io.IOException - If failed to execute

lock

public void lock(SftpClient.Handle handle,
                 long offset,
                 long length,
                 int mask)
          throws java.io.IOException

Specified by:

lock in interface SftpClient

Throws:

java.io.IOException

unlock

public void unlock(SftpClient.Handle handle,
                   long offset,
                   long length)
            throws java.io.IOException

Specified by:

unlock in interface SftpClient

Throws:

java.io.IOException

readDir

public java.lang.Iterable<SftpClient.DirEntry> readDir(java.lang.String path)
                                                throws java.io.IOException

Specified by:

readDir in interface SftpClient

Parameters:

path - The remote directory path

Returns:

An Iterable that can be used to iterate over all the directory entries (unlike SftpClient.readDir(Handle))

Throws:

java.io.IOException - If failed to access the remote site

See Also:

SftpClient.readDir(Handle)

listDir

public java.lang.Iterable<SftpClient.DirEntry> listDir(SftpClient.Handle handle)
                                                throws java.io.IOException

Specified by:

listDir in interface SftpClient

Parameters:

handle - A directory SftpClient.Handle

Returns:

An Iterable that can be used to iterate over all the directory entries (like SftpClient.readDir(String)). Note: the iterable instance is not re-usable - i.e., files can be iterated only once

Throws:

java.io.IOException - If failed to access the directory

openRemoteFileChannel

public java.nio.channels.FileChannel openRemoteFileChannel(java.lang.String path,
                                                           java.util.Collection<SftpClient.OpenMode> modes)
                                                    throws java.io.IOException

Description copied from interface: SftpClient

Opens an FileChannel on the specified remote path

Specified by:

openRemoteFileChannel in interface SftpClient

Parameters:

path - The remote path

modes - The access mode(s) - if null/empty then the SftpClient.DEFAULT_CHANNEL_MODES are used

Returns:

The open FileChannel - Note: do not close this owner client instance until the channel is no longer needed since it uses the client for providing the channel's functionality.

Throws:

java.io.IOException - If failed to open the channel

See Also:

Channels.newInputStream(java.nio.channels.ReadableByteChannel), Channels.newOutputStream(java.nio.channels.WritableByteChannel)

read

public java.io.InputStream read(java.lang.String path,
                                int bufferSize,
                                java.util.Collection<SftpClient.OpenMode> mode)
                         throws java.io.IOException

Description copied from interface: SftpClient

Read a remote file's data via an input stream

Specified by:

read in interface SftpClient

Parameters:

path - The remote file path

bufferSize - The internal read buffer size

mode - The remote file SftpClient.OpenModes

Returns:

An InputStream for reading the remote file data

Throws:

java.io.IOException - If failed to execute

write

public SftpOutputStreamAsync write(java.lang.String path,
                                   int bufferSize,
                                   java.util.Collection<SftpClient.OpenMode> mode)
                            throws java.io.IOException

Description copied from interface: SftpClient

Write to a remote file via an output stream

Specified by:

write in interface SftpClient

Parameters:

path - The remote file path

bufferSize - The internal write buffer size

mode - The remote file SftpClient.OpenModes

Returns:

An OutputStream for writing the data

Throws:

java.io.IOException - If failed to execute

safeStat

private SftpClient.Attributes safeStat(java.lang.String path)
                                throws java.io.IOException

Throws:

java.io.IOException

put

public void put(java.io.InputStream stream,
                int bufferSize,
                java.lang.String path,
                java.util.Collection<SftpClient.OpenMode> modes)
         throws java.io.IOException

Description copied from interface: SftpClient

Write data from an InputStream to a remote file.

Specified by:

put in interface SftpClient

Parameters:

stream - InputStream to read from

bufferSize - SFTP packet size; i.e., amount of data to send in a single SFTP request. Most servers have a limit of 256kB. If zero, a default buffer size is chosen depending on the peer's channel packet size; so typically about 32kB.

path - The remote file path

modes - The remote file SftpClient.OpenModes

Throws:

java.io.IOException - if data cannot be read, or cannot be written

getReadBufferSize

protected int getReadBufferSize()

getWriteBufferSize

protected int getWriteBufferSize()