public abstract class AbstractSftpEventListenerAdapter extends AbstractLoggingBean implements SftpEventListener
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 parameterslog
Modifier | Constructor and Description |
---|---|
protected |
AbstractSftpEventListenerAdapter() |
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 |
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)
Result of reading 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,
Boolean result,
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 |
write(ServerSession session,
String remoteHandle,
FileHandle localHandle,
long offset,
byte[] data,
int dataOffset,
int dataLen)
Result of writing to a file
|
public void initialized(ServerSession session, int version)
SftpEventListener
initialized
in interface SftpEventListener
session
- The ServerSession
through which the request was handledversion
- The negotiated SFTP versionpublic void destroying(ServerSession session)
SftpEventListener
destroying
in interface SftpEventListener
session
- The associated ServerSession
public void open(ServerSession session, String remoteHandle, Handle localHandle)
SftpEventListener
open
in interface SftpEventListener
session
- The ServerSession
through which the request was handledremoteHandle
- The (opaque) assigned handle for the file / directorylocalHandle
- The associated file / directory Handle
public void read(ServerSession session, String remoteHandle, DirectoryHandle localHandle, Map<String,Path> entries)
SftpEventListener
read
in interface SftpEventListener
session
- The ServerSession
through which the request was handledremoteHandle
- The (opaque) assigned handle for the directorylocalHandle
- The associated DirectoryHandle
entries
- A Map
of the listed entries - key = short name,
value = Path
of the sub-entrypublic void read(ServerSession session, String remoteHandle, FileHandle localHandle, long offset, byte[] data, int dataOffset, int dataLen, int readLen)
SftpEventListener
read
in interface SftpEventListener
session
- The ServerSession
through which the request was handledremoteHandle
- The (opaque) assigned handle for the filelocalHandle
- The associated FileHandle
offset
- Offset in file from which to readdata
- Buffer holding the read datadataOffset
- Offset of read data in bufferdataLen
- Requested read lengthreadLen
- Actual read lengthpublic void write(ServerSession session, String remoteHandle, FileHandle localHandle, long offset, byte[] data, int dataOffset, int dataLen)
SftpEventListener
write
in interface SftpEventListener
session
- The ServerSession
through which the request was handledremoteHandle
- The (opaque) assigned handle for the filelocalHandle
- The associated FileHandle
offset
- Offset in file to which to writedata
- Buffer holding the written datadataOffset
- Offset of write data in bufferdataLen
- Requested write lengthpublic void blocking(ServerSession session, String remoteHandle, FileHandle localHandle, long offset, long length, int mask)
SftpEventListener
blocking
in interface SftpEventListener
session
- The ServerSession
through which the request was handledremoteHandle
- The (opaque) assigned handle for the filelocalHandle
- The associated FileHandle
offset
- Offset in file for lockinglength
- Section size for lockingmask
- Lock mask flags - see SSH_FXP_BLOCK
messageSftpEventListener.blocked(ServerSession, String, FileHandle, long, long, int, Throwable)
public void blocked(ServerSession session, String remoteHandle, FileHandle localHandle, long offset, long length, int mask, Throwable thrown)
SftpEventListener
blocked
in interface SftpEventListener
session
- The ServerSession
through which the request was handledremoteHandle
- The (opaque) assigned handle for the filelocalHandle
- The associated FileHandle
offset
- Offset in file for lockinglength
- Section size for lockingmask
- Lock mask flags - see SSH_FXP_BLOCK
messagethrown
- If not-null
then the reason for the failure to executepublic void unblocking(ServerSession session, String remoteHandle, FileHandle localHandle, long offset, long length)
SftpEventListener
unblocking
in interface SftpEventListener
session
- The ServerSession
through which the request was handledremoteHandle
- The (opaque) assigned handle for the filelocalHandle
- The associated FileHandle
offset
- Offset in file for un-lockinglength
- Section size for un-lockingpublic void unblocked(ServerSession session, String remoteHandle, FileHandle localHandle, long offset, long length, Boolean result, Throwable thrown)
SftpEventListener
unblocked
in interface SftpEventListener
session
- The ServerSession
through which the request was handledremoteHandle
- The (opaque) assigned handle for the filelocalHandle
- The associated FileHandle
offset
- Offset in file for un-lockinglength
- Section size for un-lockingresult
- If successful (i.e., thrown is null
, then whether
section was un-blockedthrown
- If not-null
then the reason for the failure to executepublic void close(ServerSession session, String remoteHandle, Handle localHandle)
SftpEventListener
close
in interface SftpEventListener
session
- The ServerSession
through which the request was handledremoteHandle
- The (opaque) assigned handle for the file / directorylocalHandle
- The associated file / directory Handle
public void creating(ServerSession session, Path path, Map<String,?> attrs)
SftpEventListener
creating
in interface SftpEventListener
session
- The ServerSession
through which the request was handledpath
- Directory Path
to be createdattrs
- Requested associated attributes to setSftpEventListener.created(ServerSession, Path, Map, Throwable)
public void created(ServerSession session, Path path, Map<String,?> attrs, Throwable thrown)
SftpEventListener
created
in interface SftpEventListener
session
- The ServerSession
through which the request was handledpath
- Directory Path
to be createdattrs
- Requested associated attributes to setthrown
- If not-null
then the reason for the failure to executepublic void moving(ServerSession session, Path srcPath, Path dstPath, Collection<CopyOption> opts)
SftpEventListener
moving
in interface SftpEventListener
session
- The ServerSession
through which the request was handledsrcPath
- The source Path
dstPath
- The target Path
opts
- The resolved renaming optionsSftpEventListener.moved(ServerSession, Path, Path, Collection, Throwable)
public void moved(ServerSession session, Path srcPath, Path dstPath, Collection<CopyOption> opts, Throwable thrown)
SftpEventListener
moved
in interface SftpEventListener
session
- The ServerSession
through which the request was handledsrcPath
- The source Path
dstPath
- The target Path
opts
- The resolved renaming optionsthrown
- If not-null
then the reason for the failure to executepublic void removing(ServerSession session, Path path)
SftpEventListener
removing
in interface SftpEventListener
session
- The ServerSession
through which the request was handledpath
- The Path
about to be removedSftpEventListener.removed(ServerSession, Path, Throwable)
public void removed(ServerSession session, Path path, Throwable thrown)
SftpEventListener
removed
in interface SftpEventListener
session
- The ServerSession
through which the request was handledpath
- The Path
to be removedthrown
- If not-null
then the reason for the failure to executepublic void linking(ServerSession session, Path source, Path target, boolean symLink)
SftpEventListener
linking
in interface SftpEventListener
session
- The ServerSession
through which the request was handledsource
- The source Path
target
- The target Path
symLink
- true
= symbolic linkSftpEventListener.linked(ServerSession, Path, Path, boolean, Throwable)
public void linked(ServerSession session, Path source, Path target, boolean symLink, Throwable thrown)
SftpEventListener
linked
in interface SftpEventListener
session
- The ServerSession
through which the request was handledsource
- The source Path
target
- The target Path
symLink
- true
= symbolic linkthrown
- If not-null
then the reason for the failure to executepublic void modifyingAttributes(ServerSession session, Path path, Map<String,?> attrs)
SftpEventListener
modifyingAttributes
in interface SftpEventListener
session
- The ServerSession
through which the request was handledpath
- The file / directory Path
to be modifiedattrs
- The attributes Map
- names and values depend on the
O/S, view, type, etc...SftpEventListener.modifiedAttributes(ServerSession, Path, Map, Throwable)
public void modifiedAttributes(ServerSession session, Path path, Map<String,?> attrs, Throwable thrown)
SftpEventListener
modifiedAttributes
in interface SftpEventListener
session
- The ServerSession
through which the request was handledpath
- The file / directory Path
to be modifiedattrs
- 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 executeCopyright © 2008–2016 The Apache Software Foundation. All rights reserved.