FileUtil (JDFLibJ 2.1.4a.76 API)

java.lang.Object
- org.cip4.jdflib.util.FileUtil

```
public class FileUtil
extends Object
```
collection of helper routines to work with files

Author:

prosirai

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected static class`	`FileUtil.DirectoryFileFilter` simple file filter that lists all directories
`protected static class`	`FileUtil.ExpressionFileFilter` simple file filter that lists all files that match a regular expression
`static class`	`FileUtil.ExtensionFileFilter` Inner class *********************** UtilFileFilter

Constructor Summary

Constructors
Constructor and Description

FileUtil()

Constructors
Constructor and Description
`FileUtil()`

Method Summary

Methods
Modifier and Type	Method and Description
`static File`	`cleanDots(File file)` remove any internal "../" "./" and "//" from a url
`static File`	`cleanURL(File f)`
`static boolean`	`copyBytes(byte[] buf, File toFile)` copy a buffer to the end of a file, creating it if necessary
`static boolean`	`copyFile(File fromFile, File toFile)` copy a file, unless fromFile and toFile are equal
`static File`	`copyFileToDir(File fromFile, File toDir)` copies a File to directory if toFile exists, it is brutally overwritten unless fromFile equals toFile
`static boolean`	`createNewFile(File file)` similar to File.createFile but also creates any required directories
`static boolean`	`deleteAll(File dirToZapp)` very brutal tree zapper that will delete a file or directory tree recursively
`static File`	`ensureFileInDir(File fromFile, File toDir)` copies a File to directory if and only if toFile does not exist
`static boolean`	`equals(File file1, File file2)` checks the equivalence of files - todo os specific behavior (just in case)
`static byte[]`	`fileToByteArray(File file)` read a file into a byte array
`static boolean`	`forceDelete(File file)` forces deletion of a file
`static BufferedInputStream`	`getBufferedInputStream(File file)` create a buffered input stream for a file
`static BufferedOutputStream`	`getBufferedOutputStream(File file)` create a buffered output stream for a file
`static BufferedOutputStream`	`getBufferedOutputStream(File file, boolean append)` create a buffered output stream for a file
`static File`	`getCreateDirectory(String newDir)` create a new directory and return null if the directory could not be created
`static String`	`getExtension(File file)`
`static File`	`getFileInDirectory(File dir, File localFile)` returns a File object corresponding to an instance of localFile placed in dir - No OS calls are made and File is NOT created
`static boolean`	`isAbsoluteFile(File f)` check whether a file is absolute
`static boolean`	`isAbsoluteFile(String f)`
`static boolean`	`isDirectory(File f)` check whether a file is a directory.
`static boolean`	`isDirectory(String s)` check whether a file is a directory.
`static boolean`	`isWindows()`
`static File[]`	`listDirectories(File dir)` list all direct child directories
`static Vector<File>`	`listFilesInTree(File dir, FileFilter filter)` list all files matching given regexp
`static Vector<File>`	`listFilesInTree(File dir, String expression)` list all files matching given regexp
`static File[]`	`listFilesWithExpression(File dir, String expression)` list all files matching given regexp
`static File[]`	`listFilesWithExtension(File dir, String extension)` list all files with a given extension (directories are skipped
`static boolean`	`moveFile(File fromFile, File toFile)` moves a File by trying to rename, if this fails, a copy with subsequent delete is performed.
`static File`	`moveFileToDir(File fromFile, File toDir)` moves a File to directory by trying to rename, if this fails, a copy with subsequent delete is performed.
`static File`	`newExtension(File f, String newExt)` create a File object with a new extension
`static File`	`streamToFile(InputStream fis, File fil)`
`static File`	`streamToFile(InputStream fis, String fileName)` dump a stream to a newly created file
`static File`	`writeFile(IStreamWriter w, File file)` write to a file

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - FileUtil
```
public FileUtil()
```
- Method Detail
  - listFilesWithExtension
```
public static File[] listFilesWithExtension(File dir,
                            String extension)
```
    list all files with a given extension (directories are skipped
    
    Parameters:
    dir - the directory to search
    extension - comma separated list of extensions to check for (null = list all)
    
    Returns:
    Files[] the matching files, null if none are found
  - listFilesWithExpression
```
public static File[] listFilesWithExpression(File dir,
                             String expression)
```
    list all files matching given regexp
    
    Parameters:
    dir - the directory to search
    expression - regular expression - uses the simplified syntax
    
    Returns:
    Files[] the matching files, null if none are found
  - listFilesInTree
```
public static Vector<File> listFilesInTree(File dir,
                           FileFilter filter)
```
    list all files matching given regexp
    
    Parameters:
    dir - the directory to search
    filter - the filter to apply to files
    
    Returns:
    Vector the matching files, null if none are found
  - listFilesInTree
```
public static Vector<File> listFilesInTree(File dir,
                           String expression)
```
    list all files matching given regexp
    
    Parameters:
    dir - the directory to search
    expression - comma separated list of regular expression of a tree with slashes separating directories
    
    Returns:
    Files[] the matching files, null if none are found
  - listDirectories
```
public static File[] listDirectories(File dir)
```
    list all direct child directories
    
    Parameters:
    dir - the directory to search
    
    Returns:
    Files[] the matching directories, null if none are found
  - deleteAll
```
public static boolean deleteAll(File dirToZapp)
```
    very brutal tree zapper that will delete a file or directory tree recursively
    
    Parameters:
    dirToZapp - the file directory to utterly anihilate
    
    Returns:
    true if ciao
  - streamToFile
```
public static File streamToFile(InputStream fis,
                String fileName)
```
    dump a stream to a newly created file
    
    Parameters:
    fis - the inputstream to read
    fileName - the file to stream to
    
    Returns:
    the file created by the stream, null if snafu
  - writeFile
```
public static File writeFile(IStreamWriter w,
             File file)
```
    write to a file
    
    Parameters:
    file - the file to write
    w - the writer to write to
    
    Returns:
    the file that was created, null if snafu
  - newExtension
```
public static File newExtension(File f,
                String newExt)
```
    create a File object with a new extension
    
    Parameters:
    f - the file, if null always returns null
    newExt - the new extension
    
    Returns:
    the file with the new extension
    See Also:
    for details of handling null etc.
  - streamToFile
```
public static File streamToFile(InputStream fis,
                File fil)
```
    Parameters:
    fis - the InputStream to read - if null nothing happens
    fil - the file to stream to
    
    Returns:
    the file created by the stream, null if snafu
  - fileToByteArray
```
public static byte[] fileToByteArray(File file)
```
    read a file into a byte array
    
    Parameters:
    file - the file to read into a byte array
    
    Returns:
    the correctly sized byte array, null if no bytes were read
  - moveFileToDir
```
public static File moveFileToDir(File fromFile,
                 File toDir)
```
    moves a File to directory by trying to rename, if this fails, a copy with subsequent delete is performed. if toFile exists, it is brutally overwritten
    
    Parameters:
    fromFile - the File to move
    toDir - the Directory to move to
    
    Returns:
    File the moved File if success, else null, i.e. toFile exists with the contents of fromFile
  - moveFile
```
public static boolean moveFile(File fromFile,
               File toFile)
```
    moves a File by trying to rename, if this fails, a copy with subsequent delete is performed. if toFile exists, it is brutally overwritten
    
    Parameters:
    fromFile - the File to move
    toFile - the File to create
    
    Returns:
    boolean true if success, i.e. toFile exists with the contents of fromFile
  - copyBytes
```
public static boolean copyBytes(byte[] buf,
                File toFile)
```
    copy a buffer to the end of a file, creating it if necessary
    
    Parameters:
    buf - the source buffer
    toFile - the destination File
    
    Returns:
    true if success
  - copyFile
```
public static boolean copyFile(File fromFile,
               File toFile)
```
    copy a file, unless fromFile and toFile are equal
    
    Parameters:
    fromFile - the source File
    toFile - the destination File
    
    Returns:
    true if success
  - ensureFileInDir
```
public static File ensureFileInDir(File fromFile,
                   File toDir)
```
    copies a File to directory if and only if toFile does not exist
    
    Parameters:
    fromFile - the File to move
    toDir - the Directory to move to
    
    Returns:
    File the destination File if success,
  - cleanDots
```
public static File cleanDots(File file)
```
    remove any internal "../" "./" and "//" from a url
    
    Parameters:
    file - the file to clean
    
    Returns:
    File - the clean file
  - copyFileToDir
```
public static File copyFileToDir(File fromFile,
                 File toDir)
```
    copies a File to directory if toFile exists, it is brutally overwritten unless fromFile equals toFile
    
    Parameters:
    fromFile - the File to move
    toDir - the Directory to move to
    
    Returns:
    File the moved File if success, else null, i.e. toFile exists with the contents of fromFile
  - getFileInDirectory
```
public static File getFileInDirectory(File dir,
                      File localFile)
```
    returns a File object corresponding to an instance of localFile placed in dir - No OS calls are made and File is NOT created
    
    Parameters:
    dir - the File Object representing the directory
    localFile - the local file to place in dir, note that only the path is copied - this does copy trees
    
    Returns:
    File the File object that represents localFile in Dir
  - forceDelete
```
public static boolean forceDelete(File file)
```
    forces deletion of a file
    
    Parameters:
    file - the file to delete
    
    Returns:
    true if the file no longer exists
  - getCreateDirectory
```
public static File getCreateDirectory(String newDir)
```
    create a new directory and return null if the directory could not be created
    
    Parameters:
    newDir - the path or URL of the new directory
    
    Returns:
  - cleanURL
```
public static File cleanURL(File f)
```
    Parameters:
    f - the file to cleanup
    
    Returns:
    the cleaned file
  - isDirectory
```
public static boolean isDirectory(File f)
```
    check whether a file is a directory. If a unix file is a symbolic link to a directory, it is also assumed to be a directory
    
    Parameters:
    f - the file to test
    
    Returns:
    true if f is a directory or link to a directory
  - isDirectory
```
public static boolean isDirectory(String s)
```
    check whether a file is a directory. If a unix file is a symbolic link to a directory, it is also assumed to be a directory
    
    Parameters:
    s - the file to test
    
    Returns:
    true if f is a directory or link to a directory
  - isAbsoluteFile
```
public static boolean isAbsoluteFile(File f)
```
    check whether a file is absolute
    
    Parameters:
    f - the file to test
    
    Returns:
    true if f is absolute;
  - isAbsoluteFile
```
public static boolean isAbsoluteFile(String f)
```
    Parameters:
    f - the file path to test
    
    Returns:
    true if s is absolute
  - getExtension
```
public static String getExtension(File file)
```
    Parameters:
    file -
    
    Returns:
    the file extension
  - createNewFile
```
public static boolean createNewFile(File file)
```
    similar to File.createFile but also creates any required directories
    
    Parameters:
    file - the file to create
    
    Returns:
    true if the file exists after the call, else false
  - equals
```
public static boolean equals(File file1,
             File file2)
```
    checks the equivalence of files - todo os specific behavior (just in case)
    
    Parameters:
    file1 -
    file2 -
    
    Returns:
  - getBufferedInputStream
```
public static BufferedInputStream getBufferedInputStream(File file)
```
    create a buffered input stream for a file
    
    Parameters:
    file -
    
    Returns:
    the buffered input stream, null if snafu
  - getBufferedOutputStream
```
public static BufferedOutputStream getBufferedOutputStream(File file)
```
    create a buffered output stream for a file
    
    Parameters:
    file -
    
    Returns:
    the buffered output stream, null if snafu
  - getBufferedOutputStream
```
public static BufferedOutputStream getBufferedOutputStream(File file,
                                           boolean append)
```
    create a buffered output stream for a file
    
    Parameters:
    file -
    append -
    
    Returns:
    the buffered output stream, null if snafu
  - isWindows
```
public static boolean isWindows()
```
    Returns:
    true if we are on a windows file system

Class FileUtil

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

FileUtil

Method Detail

listFilesWithExtension

listFilesWithExpression

listFilesInTree

listFilesInTree

listDirectories

deleteAll

streamToFile

writeFile

newExtension

streamToFile

fileToByteArray

moveFileToDir

moveFile

copyBytes

copyFile

ensureFileInDir

cleanDots

copyFileToDir

getFileInDirectory

forceDelete

getCreateDirectory

cleanURL

isDirectory

isDirectory

isAbsoluteFile

isAbsoluteFile

getExtension

createNewFile

equals

getBufferedInputStream

getBufferedOutputStream

getBufferedOutputStream

isWindows