org.apache.sshd.server.subsystem.sftp

Class AbstractSftpEventListenerAdapter

java.lang.Object

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

org.apache.sshd.server.subsystem.sftp.AbstractSftpEventListenerAdapter

All Implemented Interfaces:

EventListener, SshdEventListener, SftpEventListener

public abstract class AbstractSftpEventListenerAdapter
extends AbstractLoggingBean
implements SftpEventListener

A no-op implementation of SftpEventListener for those who wish to implement only a small number of methods. By default, all non-overridden methods simply log at TRACE level their invocation parameters

Author:

Apache MINA SSHD Project

Field Summary

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

log

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractSftpEventListenerAdapter()

Method Summary

Modifier and Type	Method and Description
void	blocked(ServerSession session, String remoteHandle, FileHandle localHandle, long offset, long length, int mask, Throwable thrown) Called after blocking a file section
void	blocking(ServerSession session, String remoteHandle, FileHandle localHandle, long offset, long length, int mask) Called prior to blocking a file section
void	close(ServerSession session, String remoteHandle, Handle localHandle) Specified file / directory has been closed
void	created(ServerSession session, Path path, Map<String,?> attrs, Throwable thrown) Called after creating a directory
void	creating(ServerSession session, Path path, Map<String,?> attrs) Called prior to creating a directory
void	destroying(ServerSession session) Called when subsystem is destroyed since it was closed
void	initialized(ServerSession session, int version) Called when the SFTP protocol has been initialized
void	linked(ServerSession session, Path source, Path target, boolean symLink, Throwable thrown) Called after creating a link
void	linking(ServerSession session, Path source, Path target, boolean symLink) Called prior to creating a link
void	modifiedAttributes(ServerSession session, Path path, Map<String,?> attrs, Throwable thrown) Called after modifying the attributes of a file / directory
void	modifyingAttributes(ServerSession session, Path path, Map<String,?> attrs) Called prior to modifying the attributes of a file / directory
void	moved(ServerSession session, Path srcPath, Path dstPath, Collection<CopyOption> opts, Throwable thrown) Called after renaming a file / directory
void	moving(ServerSession session, Path srcPath, Path dstPath, Collection<CopyOption> opts) Called prior to renaming a file / directory
void	open(ServerSession session, String remoteHandle, Handle localHandle) Specified file / directory has been opened
void	opening(ServerSession session, String remoteHandle, Handle localHandle) Specified file / directory is being opened
void	read(ServerSession session, String remoteHandle, DirectoryHandle localHandle, Map<String,Path> entries) Result of reading entries from a directory - Note: it may be a partial result if the directory contains more entries than can be accommodated in the response
void	read(ServerSession session, String remoteHandle, FileHandle localHandle, long offset, byte[] data, int dataOffset, int dataLen, int readLen, Throwable thrown) Result of reading from a file
void	reading(ServerSession session, String remoteHandle, FileHandle localHandle, long offset, byte[] data, int dataOffset, int dataLen) Preparing to read from a file
void	removed(ServerSession session, Path path, Throwable thrown) Called after a file / directory has been removed
void	removing(ServerSession session, Path path) Called prior to removing a file / directory
void	unblocked(ServerSession session, String remoteHandle, FileHandle localHandle, long offset, long length, Throwable thrown) Called prior to un-blocking a file section
void	unblocking(ServerSession session, String remoteHandle, FileHandle localHandle, long offset, long length) Called prior to un-blocking a file section
void	writing(ServerSession session, String remoteHandle, FileHandle localHandle, long offset, byte[] data, int dataOffset, int dataLen) Preparing to write to file
void	written(ServerSession session, String remoteHandle, FileHandle localHandle, long offset, byte[] data, int dataOffset, int dataLen, Throwable thrown) Finished to writing to file

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.server.subsystem.sftp.SftpEventListener

validateListener

Methods inherited from interface org.apache.sshd.common.util.SshdEventListener

validateListener

Constructor Detail

AbstractSftpEventListenerAdapter

protected AbstractSftpEventListenerAdapter()

Method Detail

initialized

public void initialized(ServerSession session,
                        int version)

Description copied from interface: SftpEventListener

Called when the SFTP protocol has been initialized

Specified by:

initialized in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

version - The negotiated SFTP version

destroying

public void destroying(ServerSession session)

Description copied from interface: SftpEventListener

Called when subsystem is destroyed since it was closed

Specified by:

destroying in interface SftpEventListener

Parameters:

session - The associated ServerSession

opening

public void opening(ServerSession session,
                    String remoteHandle,
                    Handle localHandle)
             throws IOException

Description copied from interface: SftpEventListener

Specified file / directory is being opened

Specified by:

opening in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

remoteHandle - The (opaque) assigned handle for the file / directory

localHandle - The associated file / directory Handle

Throws:

IOException - If failed to handle the call

open

public void open(ServerSession session,
                 String remoteHandle,
                 Handle localHandle)

Description copied from interface: SftpEventListener

Specified file / directory has been opened

Specified by:

open in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

remoteHandle - The (opaque) assigned handle for the file / directory

localHandle - The associated file / directory Handle

read

public void read(ServerSession session,
                 String remoteHandle,
                 DirectoryHandle localHandle,
                 Map<String,Path> entries)
          throws IOException

Description copied from interface: SftpEventListener

Result of reading entries from a directory - Note: it may be a partial result if the directory contains more entries than can be accommodated in the response

Specified by:

read in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

remoteHandle - The (opaque) assigned handle for the directory

localHandle - The associated DirectoryHandle

entries - A Map of the listed entries - key = short name, value = Path of the sub-entry

Throws:

IOException - If failed to handle the call

reading

public void reading(ServerSession session,
                    String remoteHandle,
                    FileHandle localHandle,
                    long offset,
                    byte[] data,
                    int dataOffset,
                    int dataLen)
             throws IOException

Description copied from interface: SftpEventListener

Preparing to read from a file

Specified by:

reading in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

remoteHandle - The (opaque) assigned handle for the file

localHandle - The associated FileHandle

offset - Offset in file from which to read

data - Buffer holding the read data

dataOffset - Offset of read data in buffer

dataLen - Requested read length

Throws:

IOException - If failed to handle the call

read

public void read(ServerSession session,
                 String remoteHandle,
                 FileHandle localHandle,
                 long offset,
                 byte[] data,
                 int dataOffset,
                 int dataLen,
                 int readLen,
                 Throwable thrown)
          throws IOException

Description copied from interface: SftpEventListener

Result of reading from a file

Specified by:

read in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

remoteHandle - The (opaque) assigned handle for the file

localHandle - The associated FileHandle

offset - Offset in file from which to read

data - Buffer holding the read data

dataOffset - Offset of read data in buffer

dataLen - Requested read length

readLen - Actual read length - negative if thrown exception provided

thrown - Non-null if read failed due to this exception

Throws:

IOException - If failed to handle the call

writing

public void writing(ServerSession session,
                    String remoteHandle,
                    FileHandle localHandle,
                    long offset,
                    byte[] data,
                    int dataOffset,
                    int dataLen)
             throws IOException

Description copied from interface: SftpEventListener

Preparing to write to file

Specified by:

writing in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

remoteHandle - The (opaque) assigned handle for the file

localHandle - The associated FileHandle

offset - Offset in file to which to write

data - Buffer holding the written data

dataOffset - Offset of write data in buffer

dataLen - Requested write length

Throws:

IOException - If failed to handle the call

written

public void written(ServerSession session,
                    String remoteHandle,
                    FileHandle localHandle,
                    long offset,
                    byte[] data,
                    int dataOffset,
                    int dataLen,
                    Throwable thrown)
             throws IOException

Description copied from interface: SftpEventListener

Finished to writing to file

Specified by:

written in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

remoteHandle - The (opaque) assigned handle for the file

localHandle - The associated FileHandle

offset - Offset in file to which to write

data - Buffer holding the written data

dataOffset - Offset of write data in buffer

dataLen - Requested write length

thrown - The reason for failing to write - null if successful

Throws:

IOException - If failed to handle the call

blocking

public void blocking(ServerSession session,
                     String remoteHandle,
                     FileHandle localHandle,
                     long offset,
                     long length,
                     int mask)
              throws IOException

Description copied from interface: SftpEventListener

Called prior to blocking a file section

Specified by:

blocking in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

remoteHandle - The (opaque) assigned handle for the file

localHandle - The associated FileHandle

offset - Offset in file for locking

length - Section size for locking

mask - Lock mask flags - see SSH_FXP_BLOCK message

Throws:

IOException - If failed to handle the call

See Also:

SftpEventListener.blocked(ServerSession, String, FileHandle, long, long, int, Throwable)

blocked

public void blocked(ServerSession session,
                    String remoteHandle,
                    FileHandle localHandle,
                    long offset,
                    long length,
                    int mask,
                    Throwable thrown)
             throws IOException

Description copied from interface: SftpEventListener

Called after blocking a file section

Specified by:

blocked in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

remoteHandle - The (opaque) assigned handle for the file

localHandle - The associated FileHandle

offset - Offset in file for locking

length - Section size for locking

mask - Lock mask flags - see SSH_FXP_BLOCK message

thrown - If not-null then the reason for the failure to execute

Throws:

IOException - If failed to handle the call

unblocking

public void unblocking(ServerSession session,
                       String remoteHandle,
                       FileHandle localHandle,
                       long offset,
                       long length)
                throws IOException

Description copied from interface: SftpEventListener

Called prior to un-blocking a file section

Specified by:

unblocking in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

remoteHandle - The (opaque) assigned handle for the file

localHandle - The associated FileHandle

offset - Offset in file for un-locking

length - Section size for un-locking

Throws:

IOException - If failed to handle the call

unblocked

public void unblocked(ServerSession session,
                      String remoteHandle,
                      FileHandle localHandle,
                      long offset,
                      long length,
                      Throwable thrown)
               throws IOException

Description copied from interface: SftpEventListener

Called prior to un-blocking a file section

Specified by:

unblocked in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

remoteHandle - The (opaque) assigned handle for the file

localHandle - The associated FileHandle

offset - Offset in file for un-locking

length - Section size for un-locking

thrown - If not-null then the reason for the failure to execute

Throws:

IOException - If failed to handle the call

close

public void close(ServerSession session,
                  String remoteHandle,
                  Handle localHandle)

Description copied from interface: SftpEventListener

Specified file / directory has been closed

Specified by:

close in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

remoteHandle - The (opaque) assigned handle for the file / directory

localHandle - The associated file / directory Handle

creating

public void creating(ServerSession session,
                     Path path,
                     Map<String,?> attrs)
              throws IOException

Description copied from interface: SftpEventListener

Called prior to creating a directory

Specified by:

creating in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

path - Directory Path to be created

attrs - Requested associated attributes to set

Throws:

IOException - If failed to handle the call

See Also:

SftpEventListener.created(ServerSession, Path, Map, Throwable)

created

public void created(ServerSession session,
                    Path path,
                    Map<String,?> attrs,
                    Throwable thrown)
             throws IOException

Description copied from interface: SftpEventListener

Called after creating a directory

Specified by:

created in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

path - Directory Path to be created

attrs - Requested associated attributes to set

thrown - If not-null then the reason for the failure to execute

Throws:

IOException - If failed to handle the call

moving

public void moving(ServerSession session,
                   Path srcPath,
                   Path dstPath,
                   Collection<CopyOption> opts)
            throws IOException

Description copied from interface: SftpEventListener

Called prior to renaming a file / directory

Specified by:

moving in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

srcPath - The source Path

dstPath - The target Path

opts - The resolved renaming options

Throws:

IOException - If failed to handle the call

See Also:

SftpEventListener.moved(ServerSession, Path, Path, Collection, Throwable)

moved

public void moved(ServerSession session,
                  Path srcPath,
                  Path dstPath,
                  Collection<CopyOption> opts,
                  Throwable thrown)
           throws IOException

Description copied from interface: SftpEventListener

Called after renaming a file / directory

Specified by:

moved in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

srcPath - The source Path

dstPath - The target Path

opts - The resolved renaming options

thrown - If not-null then the reason for the failure to execute

Throws:

IOException - If failed to handle the call

removing

public void removing(ServerSession session,
                     Path path)
              throws IOException

Description copied from interface: SftpEventListener

Called prior to removing a file / directory

Specified by:

removing in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

path - The Path about to be removed

Throws:

IOException - If failed to handle the call

See Also:

SftpEventListener.removed(ServerSession, Path, Throwable)

removed

public void removed(ServerSession session,
                    Path path,
                    Throwable thrown)
             throws IOException

Description copied from interface: SftpEventListener

Called after a file / directory has been removed

Specified by:

removed in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

path - The Path to be removed

thrown - If not-null then the reason for the failure to execute

Throws:

IOException - If failed to handle the call

linking

public void linking(ServerSession session,
                    Path source,
                    Path target,
                    boolean symLink)
             throws IOException

Description copied from interface: SftpEventListener

Called prior to creating a link

Specified by:

linking in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

source - The source Path

target - The target Path

symLink - true = symbolic link

Throws:

IOException - If failed to handle the call

See Also:

SftpEventListener.linked(ServerSession, Path, Path, boolean, Throwable)

linked

public void linked(ServerSession session,
                   Path source,
                   Path target,
                   boolean symLink,
                   Throwable thrown)
            throws IOException

Description copied from interface: SftpEventListener

Called after creating a link

Specified by:

linked in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

source - The source Path

target - The target Path

symLink - true = symbolic link

thrown - If not-null then the reason for the failure to execute

Throws:

IOException - If failed to handle the call

modifyingAttributes

public void modifyingAttributes(ServerSession session,
                                Path path,
                                Map<String,?> attrs)
                         throws IOException

Description copied from interface: SftpEventListener

Called prior to modifying the attributes of a file / directory

Specified by:

modifyingAttributes in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

path - The file / directory Path to be modified

attrs - The attributes Map - names and values depend on the O/S, view, type, etc...

Throws:

IOException - If failed to handle the call

See Also:

SftpEventListener.modifiedAttributes(ServerSession, Path, Map, Throwable)

modifiedAttributes

public void modifiedAttributes(ServerSession session,
                               Path path,
                               Map<String,?> attrs,
                               Throwable thrown)
                        throws IOException

Description copied from interface: SftpEventListener

Called after modifying the attributes of a file / directory

Specified by:

modifiedAttributes in interface SftpEventListener

Parameters:

session - The ServerSession through which the request was handled

path - The file / directory Path to be modified

attrs - The attributes Map - names and values depend on the O/S, view, type, etc...

thrown - If not-null then the reason for the failure to execute

Throws:

IOException - If failed to handle the call