Your browser does not allow this site to store cookies and other data. Some functionality on this site may not work without them. See Privacy Policy for details on how we would use cookies.


com.ssh.sft
Class Session

java.lang.Object
  extended bycom.ssh.sft.SftLib
      extended bycom.ssh.sft.SftBase
          extended bycom.ssh.sft.ObjectBase
              extended bycom.ssh.sft.Session
All Implemented Interfaces:
com.ssh.sft.SftLibConstants

public class Session
extends com.ssh.sft.ObjectBase

An ongoing SFTP session in a remote or local host. Each Session object represents a connection to an SFTP server or to a virtual server that can be used to access the local filesystem. There may be several sessions to a single server, and each session supports multiple concurrent operations.


Field Summary
static intSSH_SFT_DIR_RECURSIVE
           
static intSSH_SFT_HASH_MAX_BLOCK_SIZE
           
static intSSH_SFT_HASH_MAX_ITERATIONS
           
static intSSH_SFT_HASH_MIN_BLOCK_SIZE
           
static intSSH_SFT_REQUEST_MAX_NUM
           
static intSSH_SFT_REQUEST_MAX_SIZE
           
 
Method Summary
 voidabort()
          Aborts the session.
 voidclose()
          Releases the resources used by this object.
 byte[]getExtensionData(String type)
          Returns SFTP protocol extension data that the server has sent.
 FilegetFile(String path)
          Returns a File object representing the file at the named path.
 LocationgetLocation(String path)
          Returns a Location representing the named path.
 longgetProtocolVersion()
          Returns the version of the SFTP protocol that is used in this session for communicating with the SFTP server.
 URIgetURI()
          Returns the URI for this session's SFTP server.
 booleanisClosed()
          Tests if this object has been closed.
 booleanisConnected()
           
 voidresume()
          Resumes the session.
 voidsetFileCopyPrefix(String prefix)
           
 voidsetForceLowerCase(boolean force)
           
 voidsetIncrementalChecksums()
           
 voidsuspend()
          Suspends the session.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

SSH_SFT_REQUEST_MAX_SIZE

public static final int SSH_SFT_REQUEST_MAX_SIZE
See Also:
Constant Field Values

SSH_SFT_REQUEST_MAX_NUM

public static final int SSH_SFT_REQUEST_MAX_NUM
See Also:
Constant Field Values

SSH_SFT_HASH_MAX_ITERATIONS

public static final int SSH_SFT_HASH_MAX_ITERATIONS
See Also:
Constant Field Values

SSH_SFT_HASH_MIN_BLOCK_SIZE

public static final int SSH_SFT_HASH_MIN_BLOCK_SIZE
See Also:
Constant Field Values

SSH_SFT_HASH_MAX_BLOCK_SIZE

public static final int SSH_SFT_HASH_MAX_BLOCK_SIZE
See Also:
Constant Field Values

SSH_SFT_DIR_RECURSIVE

public static final int SSH_SFT_DIR_RECURSIVE
See Also:
Constant Field Values
Method Detail

getProtocolVersion

public long getProtocolVersion()
Returns the version of the SFTP protocol that is used in this session for communicating with the SFTP server.

Returns:
the protocol version

getExtensionData

public byte[] getExtensionData(String type)
                        throws SftException
Returns SFTP protocol extension data that the server has sent.

Parameters:
type - the type of the data to get
Returns:
the extension data associated with the given type
Throws:
SftException

getLocation

public Location getLocation(String path)
Returns a Location representing the named path.

Parameters:
path - the path to access
Returns:
a Location object representing the named path accessed through this session

getFile

public File getFile(String path)
             throws NoSuchFileException,
                    SftException
Returns a File object representing the file at the named path.

Parameters:
path - the path to access
Returns:
a File object representing the file currently found at the named path
Throws:
NoSuchFileException - if no file exists at the named path
SftException

suspend

public void suspend()
Suspends the session. All currently active file operations in this session are paused until suspend() is called. If the session is already suspended, invoking this method has no effect.


resume

public void resume()
Resumes the session. If the session was suspended, all paused operations are now resumed. Otherwise, this method has no effect.


abort

public void abort()
Aborts the session. All currently active file operations are terminated and they throw an AbortedException.


setForceLowerCase

public void setForceLowerCase(boolean force)

setFileCopyPrefix

public void setFileCopyPrefix(String prefix)

setIncrementalChecksums

public void setIncrementalChecksums()

getURI

public URI getURI()
Returns the URI for this session's SFTP server. The URI is of the form "sftp://user@host".


isConnected

public boolean isConnected()

close

public void close()
           throws SftException
Releases the resources used by this object. After this method has been called, all further operations on this object will throw a IllegalStateException.

Throws:
SftException

isClosed

public boolean isClosed()
Tests if this object has been closed.

Returns:
true if ObjectBase.close() has been called on this object, false otherwise


===AUTO_SCHEMA_MARKUP===