com.ssh.sft
Class Directory

java.lang.Object
  com.ssh.sft.SftLib
      com.ssh.sft.SftBase
          com.ssh.sft.File
              com.ssh.sft.Directory

All Implemented Interfaces:

SftLibConstants, com.ssh.sft.SshSftFileType, com.ssh.sft.SshSftSetstatMode

public class Directory

extends File

implements com.ssh.sft.SshSftSetstatMode

A remote directory.

SSH_SFT_SETSTAT_MODE_OCTAL

public static final int SSH_SFT_SETSTAT_MODE_OCTAL

See Also:

Constant Field Values

SSH_SFT_SETSTAT_MODE_ADD

public static final int SSH_SFT_SETSTAT_MODE_ADD

See Also:

Constant Field Values

SSH_SFT_SETSTAT_MODE_SUB

public static final int SSH_SFT_SETSTAT_MODE_SUB

See Also:

Constant Field Values

getLocation

public Location getLocation(String path)
                     throws SftException

Throws:

SftException

getFile

public File getFile(String path)
             throws SftException

Returns a File object representing the file at a named path.

Parameters:

path - the path to the desired file relative to this directory

Returns:

a File object representing the file at the named path

Throws:

NoSuchFileException - if no file exists at the named path

SftException

open

public DirHandle open()
               throws SftException

Returns an iterator over this directory's entries. The returned object can be used to traverse the contents of this directory in some unspecified order.

Returns:

an iterator over this directory's entries

Throws:

SftException

copy

public File copy(Location dst)
          throws SftException

Copies the directory and its contents recursively. This method overrides the default method File.copy(Location) and copies this directory and its contents to the destination location.

Overrides:

copy in class File

Parameters:

dst - the location to copy this directory to

Returns:

a Directory object representing the newly created directory

Throws:

SftException

copy

public File copy(Location dst,
                 Policies.CopyDir policy)
          throws SftException

Copies the directory and its contents recursively using the specified policy.

Parameters:

dst - the location to copy this directory to

policy - the policy to use to decide which files to copy, and to notify about errors

Returns:

a Directory object representing the newly created directory where this directory was moved

Throws:

SftException

copy

public Directory copy(Location dst,
                      Policies.CopyDir policy,
                      ProgressFactory factory)
               throws SftException

Copies the directory and its contents recursively using the specified policy and progresslistener factory.

Parameters:

dst - the location to copy this directory to

policy - the policy to use to decide which files to copy, and to notify about errors

factory - a progresslistener factory for tracking the progress of individual file copyings

Returns:

a Directory object representing the newly created directory where this directory was moved

Throws:

SftException

move

public File move(Location dst)
          throws SftException

Moves the directory and its contents recursively. This method overrides the default method File.move(Location) and copies this directory and its contents to the destination location, after which the original directory and its contents are removed. After the method returns, the directory represented by this object is removed and no further operations should be invoked on this object.

Overrides:

move in class File

Parameters:

dst - the location to move this directory to

Returns:

a Directory object representing the newly created directory

Throws:

SftException

move

public Directory move(Location dst,
                      Policies.MoveDir policy)
               throws SftException

Moves the directory and its contents recursively using the specified policy. This method moves this directory this directory and its contents to the destination location, after which the original directory and its contents are removed. After the method returns, the directory represented by this object is removed and no further operations should be invoked on this object.

Parameters:

dst - the location to move this directory to

policy - the policy to use to decide which files to copy and remove, and to notify about errors

Returns:

a Directory object representing the newly created directory where this directory was moved

Throws:

SftException

move

public Directory move(Location dst,
                      Policies.MoveDir policy,
                      ProgressFactory factory)
               throws SftException

Moves the directory and its contents recursively using the specified policy and progresslistener factory. This method moves this directory this directory and its contents to the destination location, after which the original directory and its contents are removed. After the method returns, the directory represented by this object is removed and no further operations should be invoked on this object.

Parameters:

dst - the location to move this directory to

policy - the policy to use to decide which files to copy and remove, and to notify about errors

factory - a progresslistener factory for tracking the progress of individual file copyings

Returns:

a Directory object representing the newly created directory where this directory was moved

Throws:

SftException

remove

public void remove()
            throws SftException

Removes the directory and its contents recursively. This method overrides the default method File.remove() and removes all the contents of this directory before removing the directory itself.

Overrides:

remove in class File

Throws:

SftException - if removing either the directory or its contents fails

remove

public void remove(Policies.RemoveDir policy)
            throws SftException

Removes the directory and its contents recursively using the specified policy. This method removes all the contents of this directory before removing the directory itself.

Throws:

SftException - if removing either the directory or its contents fails

traverse

public void traverse(Policies.Dir policy)
              throws SftException

Traverses the directory and its contents recursively. The order of the traversal is unspecified, and multiple entries may even be traversed concurrently. The given policy is used to relay information about the traversed files and to determine where the traversal should proceed.

Parameters:

policy - the directory traversal policy to use

Throws:

SftException

setstat

public void setstat(long permissions,
                    int mode,
                    Policies.Dir policy)
             throws SftException

Sets the permissions of all files under this directory.

Parameters:

permissions - the permissions as a standard Unix bitfield

mode - the mode to use when applying the permissions. Possible values are SshSftSetstatMode.SSH_SFT_SETSTAT_MODE_OCTAL for setting the permissions verbatim, SshSftSetstatMode.SSH_SFT_SETSTAT_MODE_ADD for combining the new permissions with the existing ones with a bitwise OR operation, and SshSftSetstatMode.SSH_SFT_SETSTAT_MODE_SUB for a bitwise AND NOT operation.

policy - the directory traversal policy to use

Throws:

SftException