Package org.apache.sshd.sftp.client.fs

Class SftpClientDirectoryScanner

java.lang.Object

org.apache.sshd.common.util.io.PathScanningMatcher

org.apache.sshd.sftp.client.fs.SftpClientDirectoryScanner

public class SftpClientDirectoryScanner
extends org.apache.sshd.common.util.io.PathScanningMatcher

Uses an SftpClient to scan a directory (possibly recursively) and find files that match a given set of inclusion patterns.

Author:

Apache MINA SSHD Project

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SftpClientDirectoryScanner.ScanDirEntry	The result of a scan

Field Summary

Fields

Modifier and Type	Field	Description
protected String	basedir

Fields inherited from class org.apache.sshd.common.util.io.PathScanningMatcher

caseSensitive, includePatterns, separator

Constructor Summary

Constructors

Constructor	Description
SftpClientDirectoryScanner()
SftpClientDirectoryScanner(boolean caseSensitive)
SftpClientDirectoryScanner(String dir)
SftpClientDirectoryScanner(String dir, String... includes)
SftpClientDirectoryScanner(String dir, Collection<String> includes)

Method Summary

Modifier and Type	Method	Description
protected String	createRelativePath(String parent, String name)
String	getBasedir()
String	getSeparator()
Collection<SftpClientDirectoryScanner.ScanDirEntry>	scan(SftpClient client)	Scans the current basedir
<C extends Collection<SftpClientDirectoryScanner.ScanDirEntry>> C	scan(SftpClient client, Supplier<? extends C> factory)
protected <C extends Collection<SftpClientDirectoryScanner.ScanDirEntry>> C	scandir(SftpClient client, String rootDir, String parent, C filesList)
void	setBasedir(String basedir)
void	setIncludes(Collection<String> includes)
void	setSeparator(String separator)

Methods inherited from class org.apache.sshd.common.util.io.PathScanningMatcher

couldHoldIncluded, getIncludes, isCaseSensitive, isIncluded, normalizePattern, setCaseSensitive, setIncludes

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

basedir

protected String basedir

Constructor Detail

SftpClientDirectoryScanner

public SftpClientDirectoryScanner()

SftpClientDirectoryScanner

public SftpClientDirectoryScanner(boolean caseSensitive)

SftpClientDirectoryScanner

public SftpClientDirectoryScanner(String dir)

SftpClientDirectoryScanner

public SftpClientDirectoryScanner(String dir,
                                  String... includes)

SftpClientDirectoryScanner

public SftpClientDirectoryScanner(String dir,
                                  Collection<String> includes)

Method Detail

getBasedir

public String getBasedir()

setBasedir

public void setBasedir(String basedir)

Parameters:

basedir - The base directory from which to start scanning. Note: it is converted to its canonical form when scanning. May not be null/empty

getSeparator

public String getSeparator()

Overrides:

getSeparator in class org.apache.sshd.common.util.io.PathScanningMatcher

setSeparator

public void setSeparator(String separator)

Overrides:

setSeparator in class org.apache.sshd.common.util.io.PathScanningMatcher

setIncludes

public void setIncludes(Collection<String> includes)

Overrides:

setIncludes in class org.apache.sshd.common.util.io.PathScanningMatcher

scan

public Collection<SftpClientDirectoryScanner.ScanDirEntry> scan(SftpClient client)
                                                         throws IOException,
                                                                IllegalStateException

Scans the current basedir

Parameters:

client - The SftpClient instance to use

Returns:

A Collection of SftpClientDirectoryScanner.ScanDirEntry-ies matching the inclusion patterns

Throws:

IOException - If failed to access the remote file system

IllegalStateException - If illegal/missing base directory, or missing inclusion patterns, or specified base path is not a directory

scan

public <C extends Collection<SftpClientDirectoryScanner.ScanDirEntry>> C scan(SftpClient client,
                                                                              Supplier<? extends C> factory)
                                                                       throws IOException,
                                                                              IllegalStateException

Throws:

IOException

IllegalStateException

scandir

protected <C extends Collection<SftpClientDirectoryScanner.ScanDirEntry>> C scandir(SftpClient client,
                                                                                    String rootDir,
                                                                                    String parent,
                                                                                    C filesList)
                                                                             throws IOException

Type Parameters:

C - Generic collection type

Parameters:

client - The SftpClient instance to use

rootDir - The absolute path of the folder to read

parent - The relative parent of the folder to read - may be empty for base directory

filesList - The (never null) Collection of SftpClientDirectoryScanner.ScanDirEntry-ies to update

Returns:

The updated Collection of SftpClientDirectoryScanner.ScanDirEntry-ies

Throws:

IOException - If failed to access remote file system

createRelativePath

protected String createRelativePath(String parent,
                                    String name)