org.apache.commons.vfs2.util

Class FileObjectUtils

java.lang.Object

org.apache.commons.vfs2.util.FileObjectUtils

public final class FileObjectUtils
extends Object

Utility methods for FileObject.

Method Summary

Modifier and Type	Method and Description
static boolean	exists(FileObject fileObject) Null-safe call to FileObject.exists().
static AbstractFileObject	getAbstractFileObject(FileObject fileObject) Gets access to the base object even if decorated.
static String	getContentAsString(FileObject file, Charset charset) Returns the content of a file as a String.
static String	getContentAsString(FileObject file, String charset) Returns the content of a file as a String.
static boolean	isInstanceOf(FileObject fileObject, Class<?> wantedClass) Checks if the given FileObject is instance of given class argument.
static Properties	readProperties(FileObject fileObject) Reads the given file into a new Properties.
static Properties	readProperties(FileObject fileObject, Properties properties) Reads the given file into a new given Properties.

Methods inherited from class java.lang.Object

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

Method Detail

exists

public static boolean exists(FileObject fileObject)
                      throws FileSystemException

Null-safe call to FileObject.exists().

Parameters:

fileObject - the file object to test, may be null.

Returns:

false if fileObject is null, otherwise, see FileObject.exists().

Throws:

FileSystemException - On error determining if this file exists.

Since:

2.4

getAbstractFileObject

public static AbstractFileObject getAbstractFileObject(FileObject fileObject)
                                                throws FileSystemException

Gets access to the base object even if decorated.

Parameters:

fileObject - The FileObject.

Returns:

The decorated FileObject or null.

Throws:

FileSystemException - if an error occurs.

getContentAsString

public static String getContentAsString(FileObject file,
                                        Charset charset)
                                 throws IOException

Returns the content of a file as a String.

Parameters:

file - The file to get the content of.

charset - The file character set, may be null.

Returns:

The content as a byte array.

Throws:

IOException - if the file content cannot be accessed.

Since:

2.4

getContentAsString

public static String getContentAsString(FileObject file,
                                        String charset)
                                 throws IOException

Returns the content of a file as a String.

Parameters:

file - The file to get the content of.

charset - The file character set, may be null.

Returns:

The content as a byte array.

Throws:

IOException - if the file content cannot be accessed.

Since:

2.4

isInstanceOf

public static boolean isInstanceOf(FileObject fileObject,
                                   Class<?> wantedClass)
                            throws FileSystemException

Checks if the given FileObject is instance of given class argument.

Parameters:

fileObject - The FileObject.

wantedClass - The Class to check.

Returns:

true if fileObject is an instance of the specified Class.

Throws:

FileSystemException - if an error occurs.

readProperties

public static Properties readProperties(FileObject fileObject)
                                 throws FileSystemException,
                                        IOException

Reads the given file into a new Properties.

Parameters:

fileObject - the file to read

Returns:

a new Properties.

Throws:

IOException - On error getting this file's content.

FileSystemException - On error getting this file's content.

IOException - On error getting this file's content.

Since:

2.4

readProperties

public static Properties readProperties(FileObject fileObject,
                                        Properties properties)
                                 throws FileSystemException,
                                        IOException

Reads the given file into a new given Properties.

Parameters:

fileObject - the file to read

properties - the destination

Returns:

a new Properties.

Throws:

FileSystemException - On error getting this file's content.

IOException - On error getting this file's content.

Since:

2.4