com.sun.enterprise.util.io
Class FileUtils

java.lang.Object
  com.sun.enterprise.util.io.FileUtils

public class FileUtils
extends java.lang.Object

Constructor Summary

FileUtils()

Method Summary

static void	appendText(java.lang.String fileName, java.lang.String line) Appends the given line at the end of given text file.
static void	appendText(java.lang.String fileName, java.lang.StringBuffer buffer)
static void	copy(java.io.File fin, java.io.File fout) Copies a file.
static void	copy(java.io.InputStream in, java.io.FileOutputStream out, long size)
static void	copy(java.io.InputStream in, java.io.OutputStream os, long size)
static void	copy(java.lang.String from, java.lang.String to) Copies a file.
static void	copyFile(java.io.File fin, java.io.File fout) This method is used to copy a given file to another file using the buffer sixe specified
static void	copyTree(java.io.File din, java.io.File dout) Copies the entire tree to a new location.
static void	copyWithoutClose(java.io.InputStream in, java.io.FileOutputStream out, long size)
static java.io.File	createTempFile(java.io.File directory)
static boolean	deleteFile(java.io.File f) Delete a file.
static java.io.File[]	findFilesInDir(java.io.File dir, java.lang.String regexp) Find files matching the regular expression in the given directory
static java.lang.String	formatFileCollection(java.util.Collection<java.io.File> files) Creates a String listing the absolute paths of files, separated by the platform's line separator.
static java.util.Set	getAllFilesAndDirectoriesUnder(java.io.File directory)
static java.util.Set	getAllFilesUnder(java.io.File directory, java.io.FilenameFilter filenameFilter) Return a set of all the files (File objects) under the directory specified, with relative pathnames filtered with the filename filter (can be null for all files).
static java.util.Set	getAllFilesUnder(java.io.File directory, java.io.FilenameFilter filenameFilter, boolean relativize)
static java.io.File	getDirectory(java.io.File f)
static java.lang.String	getIllegalFilenameCharacters()
static java.io.File	getManagedFile(java.lang.String file, java.io.File dir) If the path dir/file does not exist, look for it in the classpath.
static boolean	hasExtension(java.io.File f, java.lang.String ext)
static boolean	hasExtension(java.lang.String filename, java.lang.String ext)
static boolean	hasExtensionIgnoreCase(java.io.File f, java.lang.String ext)
static boolean	hasExtensionIgnoreCase(java.lang.String filename, java.lang.String ext)
static boolean	isFriendlyFilename(java.lang.String filename)
static boolean	isJar(java.io.File f)
static boolean	isJar(java.lang.String filename)
static boolean	isLegalFilename(java.lang.String filename)
static boolean	isZip(java.io.File f)
static boolean	isZip(java.lang.String filename)
static void	liquidate(java.io.File parent)
static java.io.File[]	listAllFiles(java.io.File dirName, java.lang.String ext) Returns an array of abstract pathnames that matches with the given file extension.
static java.io.File[]	listFiles(java.io.File f)
static java.io.File[]	listFiles(java.io.File f, java.io.FileFilter ff)
static java.io.File[]	listFiles(java.io.File f, java.io.FilenameFilter fnf)
static java.lang.String	makeForwardSlashes(java.lang.String inputStr) Returns a String with uniform slashes such that all the occurances of '\\' are replaced with '/'.
static java.lang.String	makeFriendlyFilename(java.lang.String filename)
static java.lang.String	makeFriendlyFilenameExtension(java.lang.String filename)
static java.lang.String	makeFriendlyFilenameNoExtension(java.lang.String filename)
static java.lang.String	makeLegalFilename(java.lang.String filename)
static java.lang.String	makeLegalNoBlankFileName(java.lang.String filename)
static java.io.FileOutputStream	openFileOutputStream(java.io.File out) Opens a stream to the specified output file, retrying if necessary.
static java.lang.String	quoteString(java.lang.String s) Given a string (typically a path), quote the string such that spaces are protected from interpretation by a Unix or Windows command shell.
static java.lang.String	readSmallFile(java.io.File file)
static java.lang.String	readSmallFile(java.lang.String fileName) A utility routine to read a text file efficiently and return the contents as a String.
static java.io.File	relativize(java.io.File parent, java.io.File child) Given a directory and a fully-qualified file somewhere under that directory, return the portion of the child that is relative to the parent.
static boolean	renameFile(java.io.File fromFile, java.io.File toFile) Rename, running gc on Windows if needed to try to force open streams to close.
static java.lang.String	revertFriendlyFilename(java.lang.String filename)
static java.lang.String	revertFriendlyFilenameExtension(java.lang.String filename)
static java.io.File	safeGetCanonicalFile(java.io.File f)
static java.lang.String	safeGetCanonicalPath(java.io.File f)
static boolean	safeIsDirectory(java.io.File f)
static boolean	safeIsDirectory(java.lang.String s)
static boolean	safeIsRealDirectory(java.io.File f)
static boolean	safeIsRealDirectory(java.lang.String s)
static java.util.List	searchDir(java.io.File dirName, java.lang.String ext) Returns a list of abstract pathnames that matches with the given file extension.
static boolean	whack(java.io.File parent) Deletes a directory and its contents.
static boolean	whack(java.io.File parent, java.util.Collection<java.io.File> undeletedFiles) Deletes a directory and its contents.
static void	writeStringToFile(java.lang.String s, java.io.File f) Write the String to a file.

Methods inherited from class java.lang.Object

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

Constructor Detail

FileUtils

public FileUtils()

Method Detail

listFiles

public static java.io.File[] listFiles(java.io.File f)

listFiles

public static java.io.File[] listFiles(java.io.File f,
                                       java.io.FileFilter ff)

listFiles

public static java.io.File[] listFiles(java.io.File f,
                                       java.io.FilenameFilter fnf)

safeIsDirectory

public static boolean safeIsDirectory(java.io.File f)

safeIsRealDirectory

public static boolean safeIsRealDirectory(java.lang.String s)

safeIsRealDirectory

public static boolean safeIsRealDirectory(java.io.File f)

safeIsDirectory

public static boolean safeIsDirectory(java.lang.String s)

safeGetCanonicalPath

public static java.lang.String safeGetCanonicalPath(java.io.File f)

safeGetCanonicalFile

public static java.io.File safeGetCanonicalFile(java.io.File f)

hasExtension

public static boolean hasExtension(java.lang.String filename,
                                   java.lang.String ext)

hasExtension

public static boolean hasExtension(java.io.File f,
                                   java.lang.String ext)

hasExtensionIgnoreCase

public static boolean hasExtensionIgnoreCase(java.lang.String filename,
                                             java.lang.String ext)

hasExtensionIgnoreCase

public static boolean hasExtensionIgnoreCase(java.io.File f,
                                             java.lang.String ext)

isLegalFilename

public static boolean isLegalFilename(java.lang.String filename)

isFriendlyFilename

public static boolean isFriendlyFilename(java.lang.String filename)

makeLegalFilename

public static java.lang.String makeLegalFilename(java.lang.String filename)

makeLegalNoBlankFileName

public static java.lang.String makeLegalNoBlankFileName(java.lang.String filename)

makeFriendlyFilename

public static java.lang.String makeFriendlyFilename(java.lang.String filename)

makeFriendlyFilenameNoExtension

public static java.lang.String makeFriendlyFilenameNoExtension(java.lang.String filename)

makeFriendlyFilenameExtension

public static java.lang.String makeFriendlyFilenameExtension(java.lang.String filename)

revertFriendlyFilenameExtension

public static java.lang.String revertFriendlyFilenameExtension(java.lang.String filename)

revertFriendlyFilename

public static java.lang.String revertFriendlyFilename(java.lang.String filename)

liquidate

public static void liquidate(java.io.File parent)

isJar

public static boolean isJar(java.lang.String filename)

isZip

public static boolean isZip(java.lang.String filename)

isJar

public static boolean isJar(java.io.File f)

isZip

public static boolean isZip(java.io.File f)

whack

public static boolean whack(java.io.File parent)

Deletes a directory and its contents.

If this method encounters a symbolic link in the subtree below "parent" then it deletes the link but not any of the files pointed to by the link. Note that whack will delete files if a symbolic link appears in the path above the specified parent directory in the path.

Parameters:

parent - the File at the top of the subtree to delete

Returns:

success or failure of deleting the directory

whack

public static boolean whack(java.io.File parent,
                            java.util.Collection<java.io.File> undeletedFiles)

Deletes a directory and its contents.

If this method encounters a symbolic link in the subtree below "parent" then it deletes the link but not any of the files pointed to by the link. Note that whack will delete files if a symbolic link appears in the path above the specified parent directory in the path.

Parameters:

parent - the File at the top of the subtree to delete

Returns:

success or failure of deleting the directory

deleteFile

public static boolean deleteFile(java.io.File f)

Delete a file. If on Windows and the delete fails, run the gc and retry the deletion.

Parameters:

f - file to delete

Returns:

boolean indicating success or failure of the deletion atttempt; returns true if file is absent

openFileOutputStream

public static java.io.FileOutputStream openFileOutputStream(java.io.File out)
                                                     throws java.io.IOException

Opens a stream to the specified output file, retrying if necessary.

Parameters:

out - the output File for which a stream is needed

Returns:

the FileOutputStream

Throws:

java.io.IOException - for any errors opening the stream

getAllFilesUnder

public static java.util.Set getAllFilesUnder(java.io.File directory,
                                             java.io.FilenameFilter filenameFilter)
                                      throws java.io.IOException

Return a set of all the files (File objects) under the directory specified, with relative pathnames filtered with the filename filter (can be null for all files).

Throws:

java.io.IOException

getAllFilesUnder

public static java.util.Set getAllFilesUnder(java.io.File directory,
                                             java.io.FilenameFilter filenameFilter,
                                             boolean relativize)
                                      throws java.io.IOException

Throws:

java.io.IOException

getAllFilesAndDirectoriesUnder

public static java.util.Set getAllFilesAndDirectoriesUnder(java.io.File directory)
                                                    throws java.io.IOException

Throws:

java.io.IOException

relativize

public static java.io.File relativize(java.io.File parent,
                                      java.io.File child)

Given a directory and a fully-qualified file somewhere under that directory, return the portion of the child that is relative to the parent.

formatFileCollection

public static java.lang.String formatFileCollection(java.util.Collection<java.io.File> files)

Creates a String listing the absolute paths of files, separated by the platform's line separator.

Parameters:

files - the Collection of File objects to be listed

Returns:

String containing the absolute paths of the files with the line separator between them

getDirectory

public static java.io.File getDirectory(java.io.File f)

createTempFile

public static java.io.File createTempFile(java.io.File directory)

listAllFiles

public static java.io.File[] listAllFiles(java.io.File dirName,
                                          java.lang.String ext)

Returns an array of abstract pathnames that matches with the given file extension. If the given abstract pathname does not denote a directory, then this method returns null. If there is no matching file under the given directory and its sub directories, it returns null;

Parameters:

dirName - dir name under which search will begin

ext - file extension to look for

Returns:

an array of abstract pathnames that matches with the extension

searchDir

public static java.util.List searchDir(java.io.File dirName,
                                       java.lang.String ext)

Returns a list of abstract pathnames that matches with the given file extension. If the given abstract pathname does not denote a directory, then this method returns null. If there is no matching file under the given directory and its sub directories, it returns an empty list.

Parameters:

dirName - dir name under which search will begin

ext - file extension to look for

Returns:

a list of abstract pathnames of type java.io.File that matches with the given extension

copy

public static void copy(java.lang.String from,
                        java.lang.String to)
                 throws java.io.IOException

Copies a file.

Parameters:

from - Name of file to copy

to - Name of new file

Throws:

java.io.IOException - if an error while copying the content

copy

public static void copy(java.io.File fin,
                        java.io.File fout)
                 throws java.io.IOException

Copies a file.

Parameters:

fin - File to copy

fout - New file

Throws:

java.io.IOException - if an error while copying the content

copyTree

public static void copyTree(java.io.File din,
                            java.io.File dout)
                     throws java.io.IOException

Copies the entire tree to a new location.

Parameters:

din - File pointing at root of tree to copy

dout - File pointing at root of new tree

Throws:

java.io.IOException - if an error while copying the content

makeForwardSlashes

public static java.lang.String makeForwardSlashes(java.lang.String inputStr)

Returns a String with uniform slashes such that all the occurances of '\\' are replaced with '/'. In other words, the returned string will have all forward slashes. Accepts non-null strings only.

Parameters:

inputStr - non null String

Returns:

a String which does not contain `\\` character

quoteString

public static java.lang.String quoteString(java.lang.String s)

Given a string (typically a path), quote the string such that spaces are protected from interpretation by a Unix or Windows command shell. Note that this method does not handle quoting for all styles of special characters. Just for the basic case of strings with spaces.

Parameters:

s - input string

Returns:

a String which is quoted to protect spaces

getIllegalFilenameCharacters

public static java.lang.String getIllegalFilenameCharacters()

copyFile

public static void copyFile(java.io.File fin,
                            java.io.File fout)
                     throws java.io.IOException

This method is used to copy a given file to another file using the buffer sixe specified

Parameters:

fin - the source file

fout - the destination file

Throws:

java.io.IOException

copy

public static void copy(java.io.InputStream in,
                        java.io.FileOutputStream out,
                        long size)
                 throws java.io.IOException

Throws:

java.io.IOException

copyWithoutClose

public static void copyWithoutClose(java.io.InputStream in,
                                    java.io.FileOutputStream out,
                                    long size)
                             throws java.io.IOException

Throws:

java.io.IOException

copy

public static void copy(java.io.InputStream in,
                        java.io.OutputStream os,
                        long size)
                 throws java.io.IOException

Throws:

java.io.IOException

renameFile

public static boolean renameFile(java.io.File fromFile,
                                 java.io.File toFile)

Rename, running gc on Windows if needed to try to force open streams to close.

Parameters:

fromFile - to be renamed

toFile - name for the renamed file

Returns:

boolean result of the rename attempt

appendText

public static void appendText(java.lang.String fileName,
                              java.lang.String line)
                       throws java.lang.RuntimeException

Appends the given line at the end of given text file. If the given file does not exist, an attempt is made to create it. Note that this method can handle only text files.

Parameters:

fileName - name of the text file that needs to be appended to

line - the line to append to

Throws:

java.lang.RuntimeException - in case of any error - that makes it callable from a code not within try-catch. Note that NPE will be thrown if either argument is null. Note that this method is not tested with String containing characters with 2 bytes.

appendText

public static void appendText(java.lang.String fileName,
                              java.lang.StringBuffer buffer)
                       throws java.io.IOException,
                              java.io.FileNotFoundException

Throws:

java.io.IOException

java.io.FileNotFoundException

readSmallFile

public static java.lang.String readSmallFile(java.lang.String fileName)
                                      throws java.io.IOException,
                                             java.io.FileNotFoundException

A utility routine to read a text file efficiently and return the contents as a String. Sometimes while reading log files of spawned processes this kind of facility is handy. Instead of opening files, coding FileReaders etc. this method could be employed. It is expected that the file to be read is small .

Parameters:

fileName - String representing absolute path of the file

Returns:

String representing the contents of the file, empty String for an empty file

Throws:

java.io.IOException - if there is an i/o error.

java.io.FileNotFoundException - if the file could not be found

readSmallFile

public static java.lang.String readSmallFile(java.io.File file)
                                      throws java.io.IOException

Throws:

java.io.IOException

getManagedFile

public static java.io.File getManagedFile(java.lang.String file,
                                          java.io.File dir)
                                   throws java.io.IOException

If the path dir/file does not exist, look for it in the classpath. If found in classpath, create dir/file.

Parameters:

file - - path to look for

dir - - directory where the path file should exist

Returns:

the File representing dir/file. If that does not exist, return null.

Throws:

java.io.IOException

writeStringToFile

public static void writeStringToFile(java.lang.String s,
                                     java.io.File f)
                              throws java.io.IOException

Write the String to a file. Then make the file readable and writable. If the file already exists it will be truncated and the contents replaced with the String argument.

Parameters:

s - The String to write to the file

f - The file to write the String to

Throws:

java.io.IOException - if any errors

findFilesInDir

public static java.io.File[] findFilesInDir(java.io.File dir,
                                            java.lang.String regexp)

Find files matching the regular expression in the given directory

Parameters:

dir - the directory to search

regexp - the regular expression pattern

Returns:

either an array of matching File objects or an empty array. Guaranteed to never return null