org.jitsi.impl.fileaccess

Class FileAccessServiceImpl

java.lang.Object

org.jitsi.impl.fileaccess.FileAccessServiceImpl

All Implemented Interfaces:

FileAccessService

public class FileAccessServiceImpl
extends Object
implements FileAccessService

Default FileAccessService implementation.

Author:

Alexander Pelov, Lyubomir Marinov

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FileAccessServiceImpl.GUID

Field Summary

Fields

Modifier and Type	Field and Description
static String	TEMP_FILE_PREFIX The file prefix for all temp files.
static String	TEMP_FILE_SUFFIX The file suffix for all temp files.

Constructor Summary

Constructors

Constructor and Description
FileAccessServiceImpl()

Method Summary

Modifier and Type	Method and Description
FailSafeTransaction	createFailSafeTransaction(File file) Creates a failsafe transaction which can be used to safely store informations into a file.
File	getDefaultDownloadDirectory() Returns the default download directory.
File	getPrivatePersistentDirectory(String dirName) Deprecated.
File	getPrivatePersistentDirectory(String dirName, FileCategory category) This method creates a directory specific to the current user.
File	getPrivatePersistentFile(String fileName) Deprecated.
File	getPrivatePersistentFile(String fileName, FileCategory category) This method returns a file specific to the current user.
File	getTemporaryDirectory() Returns the temporary directory.
File	getTemporaryFile() This method returns a created temporary file.

Methods inherited from class java.lang.Object

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

Field Detail

TEMP_FILE_PREFIX

public static final String TEMP_FILE_PREFIX

The file prefix for all temp files.

See Also:

Constant Field Values

TEMP_FILE_SUFFIX

public static final String TEMP_FILE_SUFFIX

The file suffix for all temp files.

See Also:

Constant Field Values

Constructor Detail

FileAccessServiceImpl

public FileAccessServiceImpl()

Method Detail

getTemporaryFile

public File getTemporaryFile()
                      throws IOException

This method returns a created temporary file. After you close this file it is not guaranteed that you will be able to open it again nor that it will contain any information. Note: DO NOT store unencrypted sensitive information in this file

Specified by:

getTemporaryFile in interface FileAccessService

Returns:

The created temporary file

Throws:

IOException - If the file cannot be created

getTemporaryDirectory

public File getTemporaryDirectory()
                           throws IOException

Returns the temporary directory.

Specified by:

getTemporaryDirectory in interface FileAccessService

Returns:

the created temporary directory

Throws:

IOException - if the temporary directory cannot not be created

getPrivatePersistentFile

@Deprecated
public File getPrivatePersistentFile(String fileName)
                                          throws Exception

Deprecated.

Please use getPrivatePersistentFile(String, FileCategory).

Specified by:

getPrivatePersistentFile in interface FileAccessService

Throws:

Exception

getPrivatePersistentFile

public File getPrivatePersistentFile(String fileName,
                                     FileCategory category)
                              throws Exception

This method returns a file specific to the current user. It may not exist, but it is guaranteed that you will have the sufficient rights to create it. This file should not be considered secure because the implementor may return a file accessible to everyone. Generally it will reside in current user's homedir, but it may as well reside in a shared directory. Note: DO NOT store unencrypted sensitive information in this file

Specified by:

getPrivatePersistentFile in interface FileAccessService

Parameters:

fileName - The name of the private file you wish to access

category - The classification of the file.

Returns:

The file

Throws:

Exception - if we faile to create the file.

getPrivatePersistentDirectory

@Deprecated
public File getPrivatePersistentDirectory(String dirName)
                                               throws Exception

Deprecated.

Please use getPrivatePersistentDirectory(String, FileCategory)

Specified by:

getPrivatePersistentDirectory in interface FileAccessService

Throws:

Exception

getPrivatePersistentDirectory

public File getPrivatePersistentDirectory(String dirName,
                                          FileCategory category)
                                   throws Exception

This method creates a directory specific to the current user. This directory should not be considered secure because the implementor may return a directory accessible to everyone. Generally it will reside in current user's homedir, but it may as well reside in a shared directory. It is guaranteed that you will be able to create files in it. Note: DO NOT store unencrypted sensitive information in this file

Specified by:

getPrivatePersistentDirectory in interface FileAccessService

Parameters:

dirName - The name of the private directory you wish to access.

category - The classification of the directory.

Returns:

The created directory.

Throws:

Exception - Thrown if there is no suitable location for the persistent directory.

getDefaultDownloadDirectory

public File getDefaultDownloadDirectory()
                                 throws IOException

Returns the default download directory.

Specified by:

getDefaultDownloadDirectory in interface FileAccessService

Returns:

the default download directory

Throws:

IOException - if it I/O error occurred

createFailSafeTransaction

public FailSafeTransaction createFailSafeTransaction(File file)

Creates a failsafe transaction which can be used to safely store informations into a file.

Specified by:

createFailSafeTransaction in interface FileAccessService

Parameters:

file - The file concerned by the transaction, null if file is null.

Returns:

A new failsafe transaction related to the given file.