nl.b3p.applet.local

Class Files

java.lang.Object

nl.b3p.applet.local.Files

public class Files
extends Object

Methods to interact with files.

Author:

Matthijs Laan

Constructor Summary

Constructors

Constructor and Description
Files()

Method Summary

Methods

Modifier and Type	Method and Description
static JSONArray	listDirectory(String dir) List files in a directory.
static String	readFileUTF8(String file) Read a file return the contents as a String assuming the file is UTF-8.
static String	selectDirectory(Component component, String title) Show a directory selector dialog.
static void	writeFileUTF8(String file, String content) Write a String to a file in UTF-8 encoding.

Methods inherited from class java.lang.Object

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

Constructor Detail

Files

public Files()

Method Detail

selectDirectory

public static String selectDirectory(Component component,
                     String title)

Show a directory selector dialog.

Parameters:

title - The title for the dialog.

Returns:

the selected directory or null if the dialog was canceled

listDirectory

public static JSONArray listDirectory(String dir)
                               throws JSONException

List files in a directory. The return value is a String with stringified and minified JSON instead of a JSObject to minimize LiveConnect marshalling time.

Example:

 [ { d: 0, n: "foo.txt", s: 1024 }, { d: 1, n: "subdir"} ]
 

Where:
d is non-zero if the file is a directory
n is the filename
s is the filesize

Parameters:

title - The title for the dialog.

Returns:

stringified JSON specified above.

Throws:

JSONException

readFileUTF8

public static String readFileUTF8(String file)
                           throws IOException

Read a file return the contents as a String assuming the file is UTF-8.

Parameters:

file - the file to read

Returns:

the file contents read as UTF-8 or null if the file does not exist or is not readable

Throws:

IOException - thrown when reading the file throws an IOException and also when the file is too large to marshal through LiveConnect (currently 128KB, see MAX_FILE_SIZE final)

writeFileUTF8

public static void writeFileUTF8(String file,
                 String content)
                          throws IOException

Write a String to a file in UTF-8 encoding. Do not call with too large a content parameter, as this may crash LiveConnect.

Parameters:

file - the file to write

content - String to write to the file in UTF-8.

Throws:

IOException