xapi.file.impl

Class FileServiceImpl

java.lang.Object

xapi.file.impl.FileServiceImpl

All Implemented Interfaces:

FileService

Direct Known Subclasses:

FileServiceJava7

@SingletonDefault(implFor=FileService.class)
public class FileServiceImpl
extends Object
implements FileService

Constructor Summary

Constructors

Constructor and Description
FileServiceImpl()

Method Summary

Modifier and Type	Method and Description
protected void	assertValidChmod(int chmod)
File	chmod(int chmod, File file) Performs a chmod-like operation on a file.
File	createTempDir(String prefix, boolean deleteOnExit)
void	delete(String kill, boolean recursive)
String	getFileMaybeUnzip(String file, int chmod)
String	getPath(String path) Return the canonical (fully resolved) path of the given path segment.
String	getResourceMaybeUnzip(String resource, ClassLoader cl, int chmod)
protected static boolean	isHexadecimalChmod(int chmod) This test is an APPROXIMATION of whether a given integer is hexadecimal, and is used only in an assertion statement warding off malformed permissions.
void	mkdirsTransient(File dest)
boolean	saveFile(String path, String fileName, String contents)
boolean	saveFile(String path, String fileName, String contents, String charset)
String	unzip(String resource, JarFile jarFile, int chmod)

Methods inherited from class java.lang.Object

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

Constructor Detail

FileServiceImpl

public FileServiceImpl()

Method Detail

chmod

public File chmod(int chmod,
                  File file)

Description copied from interface: FileService

Performs a chmod-like operation on a file. Special group permissions are ignored by java 6 and <, but owner/all permissions are settable via HEXADECIMAL integer flags. 0x755 != 755. A java 7 implementation will fully respect PosixFilePermission. A method may be provided to translate decimal input, but for now, there is an assertion guarding this method.

Specified by:

chmod in interface FileService

Parameters:

chmod - - A HEXADECIMAL value < 0x777

file - - The file to apply the setting upon

Returns:

That same file.

delete

public void delete(String kill,
                   boolean recursive)

Specified by:

delete in interface FileService

createTempDir

public File createTempDir(String prefix,
                          boolean deleteOnExit)

Specified by:

createTempDir in interface FileService

getPath

public String getPath(String path)

Description copied from interface: FileService

Return the canonical (fully resolved) path of the given path segment.

Specified by:

getPath in interface FileService

getFileMaybeUnzip

public String getFileMaybeUnzip(String file,
                                int chmod)

Specified by:

getFileMaybeUnzip in interface FileService

getResourceMaybeUnzip

public String getResourceMaybeUnzip(String resource,
                                    ClassLoader cl,
                                    int chmod)

Specified by:

getResourceMaybeUnzip in interface FileService

saveFile

public boolean saveFile(String path,
                        String fileName,
                        String contents)

Specified by:

saveFile in interface FileService

saveFile

public boolean saveFile(String path,
                        String fileName,
                        String contents,
                        String charset)

Specified by:

saveFile in interface FileService

unzip

public String unzip(String resource,
                    JarFile jarFile,
                    int chmod)

Specified by:

unzip in interface FileService

assertValidChmod

protected void assertValidChmod(int chmod)

isHexadecimalChmod

protected static boolean isHexadecimalChmod(int chmod)

This test is an APPROXIMATION of whether a given integer is hexadecimal, and is used only in an assertion statement warding off malformed permissions. Any value > 777 and < 0x777 is automatically deemed valid; after that, all we can do is check each number's 4th bit, (chmod & 888 == 0)

Parameters:

chmod - - The chmod value to check

Returns:

true is this value COULD be a valid hexadecimal chmod. returns chmod < 0x778 && (chmod & 888) == 0;

mkdirsTransient

public void mkdirsTransient(File dest)

Specified by:

mkdirsTransient in interface FileService