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

Class SftpDirEntryIterator

java.lang.Object

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

org.apache.sshd.sftp.client.impl.SftpDirEntryIterator

All Implemented Interfaces:

Closeable, AutoCloseable, Channel, Iterator<SftpClient.DirEntry>, SftpClientHolder

public class SftpDirEntryIterator
extends org.apache.sshd.common.util.logging.AbstractLoggingBean
implements SftpClientHolder, Iterator<SftpClient.DirEntry>, Channel

Iterates over the available directory entries for a given path. Note: if the iteration is carried out until no more entries are available, then no need to close the iterator. Otherwise, it is recommended to close it so as to release the internal handle.

Author:

Apache MINA SSHD Project

Field Summary

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

log

Constructor Summary

Constructors

Constructor	Description
SftpDirEntryIterator(SftpClient client, String path)
SftpDirEntryIterator(SftpClient client, String path, SftpClient.Handle dirHandle, boolean closeOnFinished)
SftpDirEntryIterator(SftpClient client, SftpClient.Handle dirHandle)

Method Summary

Modifier and Type	Method	Description
void	close()
final SftpClient	getClient()
final SftpClient.Handle	getHandle()
final String	getPath()	The remotely accessed directory path
boolean	hasNext()
boolean	isCloseOnFinished()
boolean	isOpen()
protected List<SftpClient.DirEntry>	load(SftpClient.Handle handle)
SftpClient.DirEntry	next()
void	remove()

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

Methods inherited from interface java.util.Iterator

forEachRemaining

Constructor Details

SftpDirEntryIterator

public SftpDirEntryIterator(SftpClient client,
 String path)
                     throws IOException

Parameters:

client - The SftpClient instance to use for the iteration

path - The remote directory path

Throws:

IOException - If failed to gain access to the remote directory path

SftpDirEntryIterator

public SftpDirEntryIterator(SftpClient client,
 SftpClient.Handle dirHandle)

Parameters:

client - The SftpClient instance to use for the iteration

dirHandle - The directory SftpClient.Handle to use for listing the entries

SftpDirEntryIterator

public SftpDirEntryIterator(SftpClient client,
 String path,
 SftpClient.Handle dirHandle,
 boolean closeOnFinished)

Parameters:

client - The SftpClient instance to use for the iteration

path - A hint as to the remote directory path - used only for logging

dirHandle - The directory SftpClient.Handle to use for listing the entries

closeOnFinished - If true then close the directory handle when all entries have been exhausted

Method Details

getClient

public final SftpClient getClient()

Specified by:

getClient in interface SftpClientHolder

getPath

public final String getPath()

The remotely accessed directory path

Returns:

Remote directory hint - may be the handle's value if accessed directly via a SftpClient.Handle instead of via a path - used only for logging

getHandle

public final SftpClient.Handle getHandle()

Returns:

The directory SftpClient.Handle used to access the remote directory

hasNext

public boolean hasNext()

Specified by:

hasNext in interface Iterator<SftpClient.DirEntry>

next

public SftpClient.DirEntry next()

Specified by:

next in interface Iterator<SftpClient.DirEntry>

isOpen

public boolean isOpen()

Specified by:

isOpen in interface Channel

isCloseOnFinished

public boolean isCloseOnFinished()

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Channel

Specified by:

close in interface Closeable

Throws:

IOException

load

protected List<SftpClient.DirEntry> load(SftpClient.Handle handle)

remove

public void remove()

Specified by:

remove in interface Iterator<SftpClient.DirEntry>