org.qedeq.kernel.utility
Class IoUtility

java.lang.Object
  org.qedeq.kernel.utility.IoUtility

public final class IoUtility

extends Object

A collection of useful static methods for input and output.

Version:

$Revision: 1.5 $

Method Summary

static void	copyFile(File from, File to) Copies a file to a different location.
static void	createNecessaryDirectories(File file) Creates necessary parent directories for a file.
static String	createRelativePath(File orgin, File next) Create relative address from orgin to next.
static boolean	deleteDir(File directory) Delete file directory recursive.
static String	getClassName(Class clazz) Get non qualified class name.
static StringBuffer	getSpaces(int length) Get amount of spaces.
static File	getUserHomeDirectory() Get home directory of user.
static boolean	isLetterDigitString(String text) Tests if given String begins with a letter and contains only letters and digits.
static void	loadFile(File file, StringBuffer buffer) Reads contents of a file into a string buffer.
static String	loadFile(String filename) Reads a file and returns the contents as a String.
static void	loadFile(String filename, StringBuffer buffer) Reads contents of a file into a string buffer.
static byte[]	loadFileBinary(File file) Reads a file and returns the contents as a String.
static void	loadStream(InputStream in, StringBuffer buffer) Reads contents of a stream into a string buffer.
static void	printAllSystemProperties() Print current system properties to System.out.
static String	quote(String unquoted) Quotes a String.
static void	saveFile(File file, String text) Saves a String in a file.
static void	saveFile(File file, StringBuffer text) Saves a StringBuffer in a file.
static void	saveFile(String filename, String text) Saves a String into a file.
static void	saveFile(String filename, StringBuffer text) Saves a StringBuffer in a file.
static void	saveFileBinary(File file, byte[] data) Saves a String in a file.
static void	waitln() Waits until a '\n' was read from System.in.

Methods inherited from class java.lang.Object

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

Method Detail

loadFile

public static String loadFile(String filename)
                       throws IOException

Reads a file and returns the contents as a String.

Parameters:

filename - Name of the file (could include path).

Returns:

Contents of file.

Throws:

IOException - File exception occurred.

loadFile

public static void loadFile(String filename,
                            StringBuffer buffer)
                     throws IOException

Reads contents of a file into a string buffer.

Parameters:

filename - Name of the file (could include path).

buffer - Buffer to fill with file contents.

Throws:

IOException - File exception occurred.

loadStream

public static void loadStream(InputStream in,
                              StringBuffer buffer)
                       throws IOException

Reads contents of a stream into a string buffer.

Parameters:

in - This stream will be loaded.

buffer - Buffer to fill with file contents.

Throws:

IOException - File exception occurred.

loadFile

public static void loadFile(File file,
                            StringBuffer buffer)
                     throws IOException

Reads contents of a file into a string buffer.

Parameters:

file - This file will be loaded.

buffer - Buffer to fill with file contents.

Throws:

IOException - File exception occurred.

loadFileBinary

public static final byte[] loadFileBinary(File file)
                                   throws IOException

Reads a file and returns the contents as a String.

Parameters:

file - File to load from.

Returns:

Contents of file.

Throws:

IOException - File exception occurred.

saveFile

public static void saveFile(String filename,
                            String text)
                     throws IOException

Saves a String into a file.

Parameters:

filename - Name of the file (could include path).

text - Data to save in the file.

Throws:

IOException - File exception occurred.

saveFile

public static void saveFile(String filename,
                            StringBuffer text)
                     throws IOException

Saves a StringBuffer in a file.

Parameters:

filename - Name of the file (could include path).

text - Data to save in the file.

Throws:

IOException - File exception occurred.

saveFile

public static void saveFile(File file,
                            StringBuffer text)
                     throws IOException

Saves a StringBuffer in a file.

Parameters:

file - File to save into.

text - Data to save in the file.

Throws:

IOException - File exception occurred.

saveFile

public static void saveFile(File file,
                            String text)
                     throws IOException

Saves a String in a file.

Parameters:

file - File to save the data in.

text - Data to save in the file.

Throws:

IOException - File exception occurred.

saveFileBinary

public static void saveFileBinary(File file,
                                  byte[] data)
                           throws IOException

Saves a String in a file.

Parameters:

file - File to save the data in.

data - Data to save in the file.

Throws:

IOException - File exception occurred.

copyFile

public static void copyFile(File from,
                            File to)
                     throws IOException

Copies a file to a different location.

Parameters:

from - Copy source.

to - Copy destination.

Throws:

IOException - File exception occurred.

quote

public static String quote(String unquoted)

Quotes a String. If no quotes exist in the String, a quote character is appended at the beginning and the end of the String.

Parameters:

unquoted - the unquoted String

Returns:

quoted String

Throws:

NullPointerException - if unquoted == null

isLetterDigitString

public static boolean isLetterDigitString(String text)

Tests if given String begins with a letter and contains only letters and digits.

Parameters:

text - test this

Returns:

is text only made of letters and digits and has a leading letter?

Throws:

NullPointerException - if text == null

deleteDir

public static boolean deleteDir(File directory)

Delete file directory recursive.

Parameters:

directory - Directory to delete.

Returns:

Was deletion successful?

getSpaces

public static StringBuffer getSpaces(int length)

Get amount of spaces.

Parameters:

length - number of spaces

Returns:

String contains exactly number spaces

getClassName

public static String getClassName(Class clazz)

Get non qualified class name.

Parameters:

clazz - Class.

Returns:

Non qualified class name.

printAllSystemProperties

public static void printAllSystemProperties()

Print current system properties to System.out.

getUserHomeDirectory

public static File getUserHomeDirectory()

Get home directory of user.

Returns:

Home directory of user.

createNecessaryDirectories

public static void createNecessaryDirectories(File file)

Creates necessary parent directories for a file.

Parameters:

file - File.

createRelativePath

public static final String createRelativePath(File orgin,
                                              File next)

Create relative address from orgin to next.

Parameters:

orgin - this is the original location

next - this should be the next location

Returns:

relative (or if necessary absolute) file path

waitln

public static void waitln()

Waits until a '\n' was read from System.in.