Package org.apache.commons.vfs2.provider.sftp

Class SftpFileSystem

java.lang.Object

org.apache.commons.vfs2.provider.AbstractVfsComponent

org.apache.commons.vfs2.provider.AbstractFileSystem

org.apache.commons.vfs2.provider.sftp.SftpFileSystem

All Implemented Interfaces:

FileSystem, VfsComponent

public class SftpFileSystem
extends AbstractFileSystem

Represents the files on an SFTP server.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	SftpFileSystem(GenericFileName rootName, com.jcraft.jsch.Session session, FileSystemOptions fileSystemOptions)

Method Summary

Modifier and Type	Method	Description
protected void	addCapabilities(Collection<Capability> caps)	Adds the capabilities of this file system.
protected FileObject	createFile(AbstractFileName name)	Creates a file object.
protected void	doCloseCommunicationLink()	Close the underlying link used to access the files
protected com.jcraft.jsch.ChannelSftp	getChannel()	Returns an SFTP channel to the server.
int[]	getGroupsIds()	Gets the (numeric) group IDs.
double	getLastModTimeAccuracy()	Last modification time is only an int and in seconds, thus can be off by 999.
int	getUId()	Get the (numeric) group IDs.
protected void	putChannel(com.jcraft.jsch.ChannelSftp channel)	Returns a channel to the pool.

Methods inherited from class org.apache.commons.vfs2.provider.AbstractFileSystem

addJunction, addListener, close, closeCommunicationLink, decorateFileObject, doReplicateFile, fireFileChanged, fireFileCreated, fireFileDeleted, getAttribute, getFileFromCache, getFileSystemManager, getFileSystemOptions, getParentLayer, getRoot, getRootName, getRootURI, hasCapability, init, isOpen, isReleaseable, notifyAllStreamsClosed, putFileToCache, removeFileFromCache, removeJunction, removeListener, replicateFile, resolveFile, resolveFile, setAttribute

Methods inherited from class org.apache.commons.vfs2.provider.AbstractVfsComponent

getContext, getLogger, setContext, setLogger

Methods inherited from class java.lang.Object

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

Constructor Details

SftpFileSystem

protected SftpFileSystem(GenericFileName rootName,
 com.jcraft.jsch.Session session,
 FileSystemOptions fileSystemOptions)

Method Details

doCloseCommunicationLink

protected void doCloseCommunicationLink()

Description copied from class: AbstractFileSystem

Close the underlying link used to access the files

Overrides:

doCloseCommunicationLink in class AbstractFileSystem

getChannel

protected com.jcraft.jsch.ChannelSftp getChannel()
                                          throws IOException

Returns an SFTP channel to the server.

Returns:

new or reused channel, never null.

Throws:

FileSystemException - if a session cannot be created.

IOException - if an I/O error is detected.

putChannel

protected void putChannel(com.jcraft.jsch.ChannelSftp channel)

Returns a channel to the pool.

Parameters:

channel - the used channel.

addCapabilities

protected void addCapabilities(Collection<Capability> caps)

Adds the capabilities of this file system.

Specified by:

addCapabilities in class AbstractFileSystem

Parameters:

caps - collections of Capabilities, can be immutable.

createFile

protected FileObject createFile(AbstractFileName name)
                         throws FileSystemException

Creates a file object. This method is called only if the requested file is not cached.

Specified by:

createFile in class AbstractFileSystem

Parameters:

name - name referencing the new file.

Returns:

new created FileObject.

Throws:

FileSystemException

getLastModTimeAccuracy

public double getLastModTimeAccuracy()

Last modification time is only an int and in seconds, thus can be off by 999.

Specified by:

getLastModTimeAccuracy in interface FileSystem

Overrides:

getLastModTimeAccuracy in class AbstractFileSystem

Returns:

1000

getGroupsIds

public int[] getGroupsIds()
                   throws com.jcraft.jsch.JSchException,
IOException

Gets the (numeric) group IDs.

Returns:

the (numeric) group IDs.

Throws:

com.jcraft.jsch.JSchException - If a problem occurs while retrieving the group IDs.

IOException - if an I/O error is detected.

Since:

2.1

getUId

public int getUId()
           throws com.jcraft.jsch.JSchException,
IOException

Get the (numeric) group IDs.

Returns:

The numeric user ID

Throws:

com.jcraft.jsch.JSchException - If a problem occurs while retrieving the group ID.

IOException - if an I/O error is detected.

Since:

2.1