com.google.gwt.util.tools
Class Utility

java.lang.Object
  com.google.gwt.util.tools.Utility

public final class Utility
extends java.lang.Object

A smattering of useful functions.

Utility

public Utility()

close

public static void close(java.io.InputStream is)

Helper that ignores exceptions during close, because what are you going to do?

close

public static void close(java.io.OutputStream os)

Helper that ignores exceptions during close, because what are you going to do?

close

public static void close(java.io.RandomAccessFile f)

Helper that ignores exceptions during close, because what are you going to do?

close

public static void close(java.io.Reader reader)

Helper that ignores exceptions during close, because what are you going to do?

close

public static void close(java.net.Socket socket)

Helper that ignores exceptions during close, because what are you going to do?

close

public static void close(java.io.Writer writer)

Helper that ignores exceptions during close, because what are you going to do?

createNormalFile

public static java.io.File createNormalFile(java.io.File parent,
                                            java.lang.String fileName,
                                            boolean overwrite,
                                            boolean ignore)
                                     throws java.io.IOException

Parameters:

parent - Parent directory

fileName - New file name

overwrite - Is overwriting an existing file allowed?

Returns:

Handle to the file

Throws:

java.io.IOException - If the file cannot be created, or if the file already existed and overwrite was false.

getDirectory

public static java.io.File getDirectory(java.io.File parent,
                                        java.lang.String dirName,
                                        boolean create)
                                 throws java.io.IOException

Parameters:

parent - Parent directory of the requested directory.

dirName - Requested name for the directory.

create - Create the directory if it does not already exist?

Returns:

A File representing a directory that now exists.

Throws:

java.io.IOException - If the directory is not found and/or cannot be created.

getDirectory

public static java.io.File getDirectory(java.lang.String dirPath,
                                        boolean create)
                                 throws java.io.IOException

Parameters:

dirPath - Requested path for the directory.

create - Create the directory if it does not already exist?

Returns:

A File representing a directory that now exists.

Throws:

java.io.IOException - If the directory is not found and/or cannot be created.

getFileFromClassPath

public static java.lang.String getFileFromClassPath(java.lang.String partialPath)
                                             throws java.io.IOException

Gets the contents of a file from the class path as a String. Note: this method is only guaranteed to work for resources in the same class loader that contains this Utility class.

Parameters:

partialPath - the partial path to the resource on the class path

Returns:

the contents of the file

Throws:

java.io.IOException - if the file could not be found or an error occurred while reading it

getInstallPath

public static java.lang.String getInstallPath()

makeTemporaryDirectory

public static java.io.File makeTemporaryDirectory(java.io.File baseDir,
                                                  java.lang.String prefix)
                                           throws java.io.IOException

Creates a randomly-named temporary directory.

Parameters:

baseDir - base directory to contain the new directory. May be null, in which case the directory given by the java.io.tmpdir system property will be used.

prefix - the initial characters of the new directory name

Returns:

a newly-created temporary directory; the caller must delete this directory (either when done or on VM exit)

Throws:

java.io.IOException

streamOut

public static void streamOut(java.io.File file,
                             java.io.OutputStream out,
                             int bufferSize)
                      throws java.io.IOException

Throws:

java.io.IOException

streamOut

public static void streamOut(java.io.InputStream in,
                             java.io.OutputStream out,
                             int bufferSize)
                      throws java.io.IOException

Throws:

java.io.IOException

writeTemplateBinaryFile

public static void writeTemplateBinaryFile(java.io.File file,
                                           byte[] contents)
                                    throws java.io.IOException

Throws:

java.io.IOException

writeTemplateFile

public static void writeTemplateFile(java.io.File file,
                                     java.lang.String contents,
                                     java.util.Map<java.lang.String,java.lang.String> replacements)
                              throws java.io.IOException

Throws:

java.io.IOException

versionCompare

public static int versionCompare(java.lang.String v1,
                                 java.lang.String v2)

Handles comparison between version numbers (the right way(TM)). Examples of version strings: 1.6.7, 1.2_b10

Parameters:

v1 - the first version to compare.

v2 - the second version to compare.

Returns:

a negative integer, zero, or a positive integer as the first argument is less than, equal to, or greater than the second.

Throws:

java.lang.IllegalArgumentException - if the version number are not proper (i.e. the do not comply with the following regular expression [0-9]+(.[0-9]+)*(_[a-zA-Z0-9]+)?