IcedTea-Web
NetX

net.sourceforge.jnlp.util
Class FileUtils

java.lang.Object
  extended by net.sourceforge.jnlp.util.FileUtils

public final class FileUtils
extends java.lang.Object

This class contains a few file-related utility functions.


Constructor Summary
FileUtils()
           
 
Method Summary
static void createRestrictedDirectory(java.io.File directory)
          Creates a new directory with minimum permissions.
static void createRestrictedFile(java.io.File file, boolean writableByOwner)
          Creates a new file with minimum permissions.
static java.lang.String displayablePath(java.lang.String path)
          Returns a String that is suitable for using in GUI elements for displaying (long) paths to users.
static java.lang.String displayablePath(java.lang.String path, int visibleChars)
          Return a String that is suitable for using in GUI elements for displaying paths to users.
static void recursiveDelete(java.io.File file, java.io.File base)
          Recursively delete everything under a directory.
static java.lang.String sanitizeFileName(java.lang.String filename)
          Given an input, return a sanitized form of the input suitable for use as a file/directory name
static java.lang.String sanitizePath(java.lang.String path)
          Clean up a string by removing characters that can't appear in a local file name.
 
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

sanitizePath

public static java.lang.String sanitizePath(java.lang.String path)
Clean up a string by removing characters that can't appear in a local file name.

Parameters:
path - the path to sanitize
Returns:
a sanitized version of the input which is suitable for using as a file path

sanitizeFileName

public static java.lang.String sanitizeFileName(java.lang.String filename)
Given an input, return a sanitized form of the input suitable for use as a file/directory name

Parameters:
filename - the filename to sanitize.
Returns:
a sanitized version of the input

createRestrictedDirectory

public static void createRestrictedDirectory(java.io.File directory)
                                      throws java.io.IOException
Creates a new directory with minimum permissions. The directory is not readable or writable by anyone other than the owner. The parent directories are not created; they must exist before this is called.

Throws:
java.io.IOException

createRestrictedFile

public static void createRestrictedFile(java.io.File file,
                                        boolean writableByOwner)
                                 throws java.io.IOException
Creates a new file with minimum permissions. The file is not readable or writable by anyone other than the owner. If writeableByOnwer is false, even the owner can not write to it.

Throws:
java.io.IOException

displayablePath

public static java.lang.String displayablePath(java.lang.String path)
Returns a String that is suitable for using in GUI elements for displaying (long) paths to users.

Parameters:
path - a path that should be shortened
Returns:
a shortened path suitable for displaying to the user

displayablePath

public static java.lang.String displayablePath(java.lang.String path,
                                               int visibleChars)
Return a String that is suitable for using in GUI elements for displaying paths to users. If the path is longer than visibleChars, it is truncated in a display-friendly way

Parameters:
path - a path that should be shorted
visibleChars - the maximum number of characters that path should fit into. Also the length of the returned string
Returns:
a shortened path that contains limited number of chars

recursiveDelete

public static void recursiveDelete(java.io.File file,
                                   java.io.File base)
                            throws java.io.IOException
Recursively delete everything under a directory. Works on either files or directories

Parameters:
file - the file object representing what to delete. Can be either a file or a directory.
base - the directory under which the file and its subdirectories must be located
Throws:
java.io.IOException - on an io exception or if trying to delete something outside the base

IcedTea-Web
NetX

Submit a bug or feature