org.opencms.util
Class CmsFileUtil

java.lang.Object
  org.opencms.util.CmsFileUtil

public final class CmsFileUtil
extends Object

Provides File utility functions.

Since:

6.0.0

Version:

$Revision: 1.24 $

Author:

Alexander Kandzior

Method Summary

static void	checkResources(CmsObject cms, List resources) Checks if all resources are present.
static void	copy(String fromFile, String toFile) Simply version of a 1:1 binary file copy.
static String	formatFilesize(long filesize, Locale locale) Returns the formatted filesize to Bytes, KB, MB or GB depending on the given value.
static String	formatResourceNames(CmsRequestContext context, List resources) Returns a comma separated list of resource paths names, with the site root from the given OpenCms user context removed.
static String	getFileExtension(String filename) Returns the extension of the given file name, that is the part behind the last '.' char, converted to lower case letters.
static List	getFiles(String name, FileFilter filter, boolean includeSubtree) Returns a list of all filtered files in the RFS.
static String	getRepositoryName(String repository, String vfspath, boolean online) Returns the file name for a given VFS name that has to be written to a repository in the "real" file system, by appending the VFS root path to the given base repository path, also adding an folder for the "online" or "offline" project.
static String	getResourcePathFromClassloader(String fileName) Returns the absolute path name for the given relative path name if it was found by the context Classloader of the current Thread.
static String	getRfsPath(String filename, String extension, String parameters) Creates unique, valid RFS name for the given filename that contains a coded version of the given parameters, with the given file extension appended.
static String	normalizePath(String path) Normalizes a file path that might contain '../' or './' or '//' elements to a normal absolute path, the path separator char used is File.separatorChar.
static String	normalizePath(String path, char separatorChar) Normalizes a file path that might contain '../' or './' or '//' elements to a normal absolute path.
static String	normalizePath(URL url) Returns the normalized file path created from the given URL.
static String	normalizePath(URL url, char separatorChar) Returns the normalized file path created from the given URL.
static void	purgeDirectory(File directory) Deletes a directory in the file system and all subfolders of that directory.
static byte[]	readFile(File file) Reads a file from the RFS and returns the file content.
static byte[]	readFile(String filename) Reads a file with the given name from the class loader and returns the file content.
static String	readFile(String filename, String encoding) Reads a file from the class loader and converts it to a String with the specified encoding.
static byte[]	readFully(InputStream in) Reads all bytes from the given input stream and returns the result in an array.
static byte[]	readFully(InputStream in, int size) Reads the specified number of bytes from the given input stream and returns the result in an array.
static List	removeRedundancies(List resourcenames) Removes all resource names in the given List that are "redundant" because the parent folder name is also contained in the List.
static List	removeRedundantResources(List resources) Removes all resources in the given List that are "redundant" because the parent folder is also contained in the List.
static String	searchWebInfFolder(String startFolder) Searches for the OpenCms web application 'WEB-INF' folder during system startup, code or null if the 'WEB-INF' folder can not be found.

Methods inherited from class java.lang.Object

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

Method Detail

checkResources

public static void checkResources(CmsObject cms,
                                  List resources)
                           throws CmsIllegalArgumentException

Checks if all resources are present.

Parameters:

cms - an initialized OpenCms user context which must have read access to all resources

resources - a list of vfs resource names to check

Throws:

CmsIllegalArgumentException - in case not all resources exist or can be read with the given OpenCms user context

copy

public static void copy(String fromFile,
                        String toFile)
                 throws IOException

Simply version of a 1:1 binary file copy.

Parameters:

fromFile - the name of the file to copy

toFile - the name of the target file

Throws:

IOException - if any IO error occurs during the copy operation

formatFilesize

public static String formatFilesize(long filesize,
                                    Locale locale)

Returns the formatted filesize to Bytes, KB, MB or GB depending on the given value.

Parameters:

filesize - in bytes

locale - the locale of the current OpenCms user or the System's default locale if the first choice is not at hand.

Returns:

the formatted filesize to Bytes, KB, MB or GB depending on the given value

formatResourceNames

public static String formatResourceNames(CmsRequestContext context,
                                         List resources)

Returns a comma separated list of resource paths names, with the site root from the given OpenCms user context removed.

Parameters:

context - the current users OpenCms context (optional, may be null)

resources - a List of CmsResource instances to get the names from

Returns:

a comma separated list of resource paths names

getFileExtension

public static String getFileExtension(String filename)

Returns the extension of the given file name, that is the part behind the last '.' char, converted to lower case letters.

The result does contain the '.' char. For example, if the input is "opencms.html", then the result will be ".html".

If the given file name does not contain a '.' char, the empty String "" is returned.

Please note: No check is performed to ensure the given file name is not null.

Parameters:

filename - the file name to get the extension for

Returns:

the extension of the given file name

getFiles

public static List getFiles(String name,
                            FileFilter filter,
                            boolean includeSubtree)

Returns a list of all filtered files in the RFS.

If the name is not a folder the folder that contains the given file will be used instead.

Despite the filter may not accept folders, every subfolder is traversed if the includeSubtree parameter is set.

Parameters:

name - a folder or file name

filter - a filter

includeSubtree - if to include subfolders

Returns:

a list of filtered File objects

getRepositoryName

public static String getRepositoryName(String repository,
                                       String vfspath,
                                       boolean online)

Returns the file name for a given VFS name that has to be written to a repository in the "real" file system, by appending the VFS root path to the given base repository path, also adding an folder for the "online" or "offline" project.

Parameters:

repository - the base repository path

vfspath - the VFS root path to write to use

online - flag indicates if the result should be used for the online project (true) or not

Returns:

The full uri to the JSP

getResourcePathFromClassloader

public static String getResourcePathFromClassloader(String fileName)

Returns the absolute path name for the given relative path name if it was found by the context Classloader of the current Thread.

The argument has to denote a resource within the Classloaders scope. A URLClassLoader implementation for example would try to match a given path name to some resource under it's URL entries.

As the result is internally obtained as an URL it is reduced to a file path by the call to URL.getFile(). Therefore the returned String will start with a '/' (no problem for java.io).

Parameters:

fileName - the filename to return the path from the Classloader for

Returns:

the absolute path name for the given relative path name if it was found by the context Classloader of the current Thread or an empty String if it was not found

See Also:

Thread.getContextClassLoader()

getRfsPath

public static String getRfsPath(String filename,
                                String extension,
                                String parameters)

Creates unique, valid RFS name for the given filename that contains a coded version of the given parameters, with the given file extension appended.

This is used to create file names for the static export, or in a vfs disk cache.

Parameters:

filename - the base file name

extension - the extension to use

parameters - the parameters to code in the result file name

Returns:

a unique, valid RFS name for the given parameters

See Also:

CmsStaticExportManager

normalizePath

public static String normalizePath(String path)

Normalizes a file path that might contain '../' or './' or '//' elements to a normal absolute path, the path separator char used is File.separatorChar.

Parameters:

path - the path to normalize

Returns:

the normalized path

See Also:

normalizePath(String, char)

normalizePath

public static String normalizePath(String path,
                                   char separatorChar)

Normalizes a file path that might contain '../' or './' or '//' elements to a normal absolute path.

Can also handle Windows like path information containing a drive letter, like C:\path\..\.

Parameters:

path - the path to normalize

separatorChar - the file separator char to use, for example File.separatorChar

Returns:

the normalized path

normalizePath

public static String normalizePath(URL url)

Returns the normalized file path created from the given URL.

The path part URL.getPath() is used, unescaped and normalized using normalizePath(String, char) using File.separatorChar.

Parameters:

url - the URL to extract the path information from

Returns:

the normalized file path created from the given URL using File.separatorChar

See Also:

normalizePath(URL, char)

normalizePath

public static String normalizePath(URL url,
                                   char separatorChar)

Returns the normalized file path created from the given URL.

The path part URL.getPath() is used, unescaped and normalized using normalizePath(String, char).

Parameters:

url - the URL to extract the path information from

separatorChar - the file separator char to use, for example File.separatorChar

Returns:

the normalized file path created from the given URL

purgeDirectory

public static void purgeDirectory(File directory)

Deletes a directory in the file system and all subfolders of that directory.

Parameters:

directory - the directory to delete

readFile

public static byte[] readFile(File file)
                       throws IOException

Reads a file from the RFS and returns the file content.

Parameters:

file - the file to read

Returns:

the read file content

Throws:

IOException - in case of file access errors

readFile

public static byte[] readFile(String filename)
                       throws IOException

Reads a file with the given name from the class loader and returns the file content.

Parameters:

filename - the file to read

Returns:

the read file content

Throws:

IOException - in case of file access errors

readFile

public static String readFile(String filename,
                              String encoding)
                       throws IOException

Reads a file from the class loader and converts it to a String with the specified encoding.

Parameters:

filename - the file to read

encoding - the encoding to use when converting the file content to a String

Returns:

the read file convered to a String

Throws:

IOException - in case of file access errors

readFully

public static byte[] readFully(InputStream in)
                        throws IOException

Reads all bytes from the given input stream and returns the result in an array.

Parameters:

in - the input stream to read the bytes from

Returns:

the byte content of the input stream

Throws:

IOException - in case of errors in the underlying java.io methods used

readFully

public static byte[] readFully(InputStream in,
                               int size)
                        throws IOException

Reads the specified number of bytes from the given input stream and returns the result in an array.

Parameters:

in - the input stream to read the bytes from

size - the number of bytes to read

Returns:

the byte content read from the input stream

Throws:

IOException - in case of errors in the underlying java.io methods used

removeRedundancies

public static List removeRedundancies(List resourcenames)

Removes all resource names in the given List that are "redundant" because the parent folder name is also contained in the List.

The content of the input list is not modified.

Parameters:

resourcenames - a list of VFS pathnames to check for redundencies (Strings)

Returns:

a the given list with all redundancies removed

See Also:

removeRedundantResources(List)

removeRedundantResources

public static List removeRedundantResources(List resources)

Removes all resources in the given List that are "redundant" because the parent folder is also contained in the List.

The content of the input list is not modified.

Parameters:

resources - a list of CmsResource objects to check for redundencies

Returns:

a the given list with all redundancies removed

See Also:

removeRedundancies(List)

searchWebInfFolder

public static String searchWebInfFolder(String startFolder)

Searches for the OpenCms web application 'WEB-INF' folder during system startup, code or null if the 'WEB-INF' folder can not be found.

Parameters:

startFolder - the folder where to start searching

Returns:

String the path of the 'WEB-INF' folder in the 'real' file system, or null