eu.unicore.uftp.server

Interface FileAccess

All Known Implementing Classes:

DefaultFileAccess, SetUIDFileAccess

public interface FileAccess

wraps file access (read/write operations) and other operations which need to be performed as a different user using setuid

Author:

schuller

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_BUFFERSIZE default file read/write buffersize in bytes

Method Summary

Modifier and Type	Method and Description
void	asUser(Runnable runnable, String user, String group) execute the given Runnable as given user
String	getHome(String user) gets the user's home directory
RandomAccessFile	getRandomAccessFile(File file, String userID, String groupID, String mode) create a RandomAccessFile for accessing the given path
FileInfo[]	listFiles(File directory, String userID, String groupID) lists files in the given directory
void	mkdir(String canonicalPath, String user, String group) create a directory.
InputStream	readFile(String canonicalPath, String userID, String groupID, int bufferSize) create a InputStream for reading
void	rm(String canonicalPath, String user, String group) delete a file or directory
void	setUser(String canonicalPath, String user, String group) set user/group on the given file
FileInfo	stat(String path, String userID, String groupID) get info on a single file
OutputStream	writeFile(String canonicalPath, boolean append, String userID, String groupID, int bufferSize) create a OutputStream for writing

Field Detail

DEFAULT_BUFFERSIZE

static final int DEFAULT_BUFFERSIZE

default file read/write buffersize in bytes

See Also:

Constant Field Values

Method Detail

readFile

InputStream readFile(String canonicalPath,
                     String userID,
                     String groupID,
                     int bufferSize)
              throws Exception

create a InputStream for reading

Parameters:

canonicalPath - - the canonical path to the file

userID - - the user id

groupID - - the group id

bufferSize - - the buffer size for reading from

Returns:

a InputStream

Throws:

Exception

getRandomAccessFile

RandomAccessFile getRandomAccessFile(File file,
                                     String userID,
                                     String groupID,
                                     String mode)
                              throws IOException

create a RandomAccessFile for accessing the given path

Parameters:

file - - the path

userID - - the user id

groupID - - the group id

mode - - the mode (see RandomAccessFile.RandomAccessFile(java.io.File, String)

Returns:

RandomAccessFile

Throws:

IOException

Exception

listFiles

FileInfo[] listFiles(File directory,
                     String userID,
                     String groupID)

lists files in the given directory

Parameters:

parent - - the parent file

userID - - the user id

groupID - - the group id

Returns:

list of FileInfo objects

stat

FileInfo stat(String path,
              String userID,
              String groupID)

get info on a single file

Parameters:

path - - the file

userID - - the user id

groupID - - the group id

writeFile

OutputStream writeFile(String canonicalPath,
                       boolean append,
                       String userID,
                       String groupID,
                       int bufferSize)
                throws Exception

create a OutputStream for writing

Parameters:

canonicalPath - - the canonical path to the file

userID - - the user id

groupID - - the group id

bufferSize - - the buffer size for writing to disk

Returns:

OutputStream

Throws:

Exception

setUser

void setUser(String canonicalPath,
             String user,
             String group)
      throws Exception

set user/group on the given file

Parameters:

canonicalPath -

user -

group -

Throws:

Exception

mkdir

void mkdir(String canonicalPath,
           String user,
           String group)
    throws Exception

create a directory. all parent directories must exist

Parameters:

canonicalPath - - the directory to create

user - - user ID

group - - group IP

Throws:

Exception

rm

void rm(String canonicalPath,
        String user,
        String group)
 throws Exception

delete a file or directory

Parameters:

canonicalPath - - the file/directory to delete

user - - user ID

group - - group IP

Throws:

Exception

getHome

String getHome(String user)

gets the user's home directory

Parameters:

user -

Returns:

user's home directory

Throws:

Exception

asUser

void asUser(Runnable runnable,
            String user,
            String group)
     throws Exception

execute the given Runnable as given user

Parameters:

runnable - - a very SHORT task

user - - user ID

group - - group ID

Throws:

Exception