com.jeffpalm.util
Class IO

java.lang.Object
  com.jeffpalm.util.IO

public final class IO
extends java.lang.Object

Nested Class Summary

static class	IO.AlwaysReadAction
static interface	IO.Appender
static interface	IO.FileMaker Interface to make files when one doesn't exist.
static interface	IO.LambdaSep
static interface	IO.ReadAction
static interface	IO.TryIterator

Method Summary

static boolean	canProduceAnInputStream(java.lang.Object o)
static boolean	canProduceAReader(java.lang.Object o)
static boolean	canProduceAWriter(java.lang.Object o)
static boolean	close(java.io.Reader in, Handler handler)
static int	copy(java.io.File input, java.io.File output)
static int	copy(java.io.File input, java.io.File output, java.io.PrintStream err)
static int	copy(java.io.InputStream istream, java.io.OutputStream ostream)
static int	copy(java.io.InputStream istream, java.io.OutputStream ostream, java.io.PrintStream err)
static java.io.File	createTempFile(java.io.File f, boolean delete)
static java.io.File	createTempFile(java.lang.String name, boolean delete)
static java.lang.Object	deserialize(java.io.File infile)
static java.util.List	dirList(java.io.File dir)
static java.io.File[]	dirs(java.io.File dir)
static java.lang.String	dot(java.lang.String str)
static long	du(java.io.File f)
static java.io.File	ensureFile(java.io.File file) Calls ensureFile(java.io.File,FileMaker) with the default FileMaker.
static java.io.File	ensureFile(java.io.File file, IO.FileMaker maker) Ensures that file exists and all its directories are made.
static boolean	exists(java.io.File f)
static java.lang.String	extension(java.io.File f)
static java.util.List	fileList(java.io.File dir, java.lang.String ext)
static java.util.List	fileList(java.io.File dir, java.lang.String[] exts)
static java.util.List	fileListAll(java.io.File dir)
static java.io.File[]	files(java.io.File dir)
static java.io.File[]	files(java.io.File dir, java.lang.String ext)
static java.io.File[]	files(java.io.File dir, java.lang.String[] exts)
static java.util.List	findDirs(java.io.File dir)
static java.util.List	findDirs(java.io.File dir, java.io.File[] except)
static java.util.List	findDirs(java.io.File dir, java.io.FileFilter filter)
static java.util.List	findFiles(java.io.File dir)
static java.util.List	findFiles(java.io.File dir, java.io.FileFilter filter)
static java.util.List	findFiles(java.io.File dir, java.lang.String ext)
static java.util.List	findFiles(java.io.File dir, java.lang.String[] exts)
static void	finish(java.io.BufferedReader in, java.io.PrintWriter out, java.io.File template)
boolean	foreachSeparators(IO.LambdaSep sep)
static java.lang.String	formatLength(double length)
static java.lang.String	formatLength(double length, int places)
static java.lang.String	formatLength(java.io.File f)
static java.io.BufferedInputStream	inputStream(java.io.File file)
static java.io.BufferedInputStream	inputStream(java.io.InputStream in)
static java.io.BufferedInputStream	inputStream(java.lang.String fileName)
static java.io.BufferedInputStream	inputStream(java.net.URL url)
static boolean	isExistingDir(java.io.File f)
static boolean	isExistingFile(java.io.File f)
static boolean	isJarFile(java.io.File f)
static boolean	isJarFileName(java.lang.String name)
static java.io.File	javapalmDir()
static java.io.File	javapalmDir(java.io.File dir)
static java.io.File	javapalmFile(java.io.File dir, java.lang.String name)
static java.io.File	javapalmFile(java.lang.String name)
static java.lang.String	line(java.io.BufferedReader in)
static Dir	macMailDir()
static java.io.File	mkdir(java.io.File dir)
static java.io.File	mkdir(java.io.File dir, java.lang.String name)
static java.io.File	mkdirs(java.io.File dir)
static java.io.File	mkdirs(java.io.File dir, java.lang.String name)
static Dir	mozillaDir()
static java.io.File	newDir(java.lang.String str)
static java.io.File	newExt(java.io.File f, java.lang.String ext)
static java.io.File	newFile(java.io.File dir, java.lang.String str)
static java.io.File	newFile(java.io.File parent, java.lang.String name, java.lang.String ext)
static java.io.File	newFile(java.lang.String str)
static java.io.File	newFileWithExtension(java.io.File f, java.lang.String ext)
static java.io.File	newUniqueFile(java.io.File parentDir, java.lang.String name)
static java.io.File	newUniqueFile(java.io.File parentDir, java.lang.String name, IO.TryIterator ti)
static java.io.File	newUniqueFile(java.io.File parentDir, java.lang.String name, IO.TryIterator ti, int maxTries)
static java.io.PrintStream	outStream(java.io.File file)
static java.io.PrintStream	outStream(java.lang.String fileName)
static java.io.File	pwd()
static java.lang.String	read(java.io.File file)
static void	read(java.io.File file, IO.ReadAction action)
static java.lang.String	read(java.io.InputStream in)
static java.lang.String	read(java.lang.String fileName)
static void	read(java.lang.String fileName, IO.ReadAction action)
static void	read(java.net.URL url, IO.ReadAction action)
static void	readAndClose(java.io.BufferedReader in, IO.Appender app)
static void	readAndClose(java.io.File f, IO.Appender app)
static java.io.BufferedReader	reader(java.io.File file)
static java.io.BufferedReader	reader(java.io.InputStream in)
static java.io.BufferedReader	reader(java.lang.String fileName)
static java.io.BufferedReader	reader(java.net.URL url)
static java.util.List	readLines(java.io.Reader r)
static java.util.List	readLines(java.io.Reader r, java.util.List lines)
static java.lang.String	realFileName(java.lang.String str)
static java.io.File	relativeFile(java.io.File base, java.io.File file)
static java.lang.String	relativePath(java.io.File base, java.io.File file)
static java.lang.String	removeSuffix(java.io.File file)
static java.lang.String	removeSuffix(java.lang.String fileName)
static java.lang.String	seek(java.io.BufferedReader in)
static java.lang.String	seek(java.io.BufferedReader in, java.io.PrintWriter out)
static java.lang.String	seek(java.lang.String seekTo, java.io.BufferedReader in)
static java.lang.String	seek(java.lang.String seekTo, java.io.BufferedReader in, java.io.PrintWriter out)
static char[]	separatorChars()
static java.lang.String[]	separators()
static void	serialize(java.io.File outfile, java.lang.Object o)
static java.io.File	serializedFile(java.lang.String name)
static java.io.BufferedInputStream	someInputStream(java.lang.Object o)
static java.io.BufferedReader	someReader(java.lang.Object o)
static java.io.PrintWriter	someWriter(java.lang.Object o)
static java.lang.String[]	strings(java.io.BufferedReader in, boolean trim)
static java.lang.String[]	strings(java.io.File file, boolean trim)
static java.lang.String[]	strings(java.io.InputStream in, boolean trim)
static java.lang.String[]	strings(java.lang.String fileName, boolean trim)
static java.lang.String	tag()
static java.lang.String	tag(java.io.File file)
static java.lang.String	tag(java.io.File file, boolean html)
static java.lang.String	tag(java.lang.Object tag)
static java.lang.String	tag(java.lang.Object tag, boolean html)
static Dir	thunderbirdDir()
static java.lang.String	toString(java.io.File f, int numDirs)
static java.io.File	touch(java.io.File f)
static java.io.File	touch(java.lang.String s)
static java.lang.String	trim(java.io.BufferedReader in)
static java.io.File	userHome()
static void	write(java.io.File file, java.lang.Object str)
static void	write(java.io.File file, java.lang.Object str, java.io.PrintStream out)
static void	write(java.io.File file, java.lang.String str)
static void	write(java.io.File file, java.lang.String str, java.io.PrintStream out)
static java.io.PrintWriter	writer(java.io.File file)
static java.io.PrintWriter	writer(java.io.File file, java.io.PrintStream out)
static java.io.PrintWriter	writer(java.io.OutputStream o)
static java.io.PrintWriter	writer(java.lang.String fileName)

Methods inherited from class java.lang.Object

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

Method Detail

write

public static void write(java.io.File file,
                         java.lang.String str)
                  throws java.lang.Exception

Throws:

java.lang.Exception

write

public static void write(java.io.File file,
                         java.lang.String str,
                         java.io.PrintStream out)
                  throws java.lang.Exception

Throws:

java.lang.Exception

write

public static void write(java.io.File file,
                         java.lang.Object str)
                  throws java.lang.Exception

Throws:

java.lang.Exception

write

public static void write(java.io.File file,
                         java.lang.Object str,
                         java.io.PrintStream out)
                  throws java.lang.Exception

Throws:

java.lang.Exception

readAndClose

public static void readAndClose(java.io.File f,
                                IO.Appender app)
                         throws java.io.IOException

Throws:

java.io.IOException

readAndClose

public static void readAndClose(java.io.BufferedReader in,
                                IO.Appender app)
                         throws java.io.IOException

Throws:

java.io.IOException

readLines

public static java.util.List readLines(java.io.Reader r)
                                throws java.io.IOException

Throws:

java.io.IOException

readLines

public static java.util.List readLines(java.io.Reader r,
                                       java.util.List lines)
                                throws java.io.IOException

Throws:

java.io.IOException

read

public static java.lang.String read(java.io.InputStream in)
                             throws java.io.IOException

Throws:

java.io.IOException

read

public static java.lang.String read(java.io.File file)
                             throws java.io.IOException

Throws:

java.io.IOException

read

public static java.lang.String read(java.lang.String fileName)
                             throws java.io.IOException

Throws:

java.io.IOException

reader

public static java.io.BufferedReader reader(java.io.InputStream in)
                                     throws java.io.IOException

Throws:

java.io.IOException

reader

public static java.io.BufferedReader reader(java.net.URL url)
                                     throws java.io.IOException

Throws:

java.io.IOException

reader

public static java.io.BufferedReader reader(java.lang.String fileName)
                                     throws java.io.IOException

Throws:

java.io.IOException

reader

public static java.io.BufferedReader reader(java.io.File file)
                                     throws java.io.IOException

Throws:

java.io.IOException

someReader

public static java.io.BufferedReader someReader(java.lang.Object o)
                                         throws java.lang.Exception

Throws:

java.lang.Exception

canProduceAReader

public static boolean canProduceAReader(java.lang.Object o)

inputStream

public static java.io.BufferedInputStream inputStream(java.io.InputStream in)
                                               throws java.io.IOException

Throws:

java.io.IOException

inputStream

public static java.io.BufferedInputStream inputStream(java.net.URL url)
                                               throws java.io.IOException

Throws:

java.io.IOException

inputStream

public static java.io.BufferedInputStream inputStream(java.lang.String fileName)
                                               throws java.io.IOException

Throws:

java.io.IOException

inputStream

public static java.io.BufferedInputStream inputStream(java.io.File file)
                                               throws java.io.IOException

Throws:

java.io.IOException

someInputStream

public static java.io.BufferedInputStream someInputStream(java.lang.Object o)
                                                   throws java.io.IOException

Throws:

java.io.IOException

canProduceAnInputStream

public static boolean canProduceAnInputStream(java.lang.Object o)

isJarFile

public static boolean isJarFile(java.io.File f)

isJarFileName

public static boolean isJarFileName(java.lang.String name)

strings

public static java.lang.String[] strings(java.io.File file,
                                         boolean trim)
                                  throws java.lang.Exception

Throws:

java.lang.Exception

strings

public static java.lang.String[] strings(java.lang.String fileName,
                                         boolean trim)
                                  throws java.lang.Exception

Throws:

java.lang.Exception

strings

public static java.lang.String[] strings(java.io.InputStream in,
                                         boolean trim)
                                  throws java.lang.Exception

Throws:

java.lang.Exception

strings

public static java.lang.String[] strings(java.io.BufferedReader in,
                                         boolean trim)
                                  throws java.lang.Exception

Throws:

java.lang.Exception

outStream

public static java.io.PrintStream outStream(java.lang.String fileName)
                                     throws java.lang.Exception

Throws:

java.lang.Exception

outStream

public static java.io.PrintStream outStream(java.io.File file)
                                     throws java.lang.Exception

Throws:

java.lang.Exception

writer

public static java.io.PrintWriter writer(java.io.OutputStream o)
                                  throws java.lang.Exception

Throws:

java.lang.Exception

writer

public static java.io.PrintWriter writer(java.lang.String fileName)
                                  throws java.lang.Exception

Throws:

java.lang.Exception

writer

public static java.io.PrintWriter writer(java.io.File file)
                                  throws java.lang.Exception

Throws:

java.lang.Exception

writer

public static java.io.PrintWriter writer(java.io.File file,
                                         java.io.PrintStream out)
                                  throws java.lang.Exception

Throws:

java.lang.Exception

someWriter

public static java.io.PrintWriter someWriter(java.lang.Object o)
                                      throws java.lang.Exception

Throws:

java.lang.Exception

canProduceAWriter

public static boolean canProduceAWriter(java.lang.Object o)

seek

public static java.lang.String seek(java.lang.String seekTo,
                                    java.io.BufferedReader in)
                             throws java.lang.Exception

Throws:

java.lang.Exception

seek

public static java.lang.String seek(java.io.BufferedReader in,
                                    java.io.PrintWriter out)
                             throws java.lang.Exception

Throws:

java.lang.Exception

seek

public static java.lang.String seek(java.io.BufferedReader in)
                             throws java.lang.Exception

Throws:

java.lang.Exception

seek

public static java.lang.String seek(java.lang.String seekTo,
                                    java.io.BufferedReader in,
                                    java.io.PrintWriter out)
                             throws java.lang.Exception

Throws:

java.lang.Exception

close

public static boolean close(java.io.Reader in,
                            Handler handler)

finish

public static void finish(java.io.BufferedReader in,
                          java.io.PrintWriter out,
                          java.io.File template)
                   throws java.lang.Exception

Throws:

java.lang.Exception

trim

public static java.lang.String trim(java.io.BufferedReader in)
                             throws java.lang.Exception

Throws:

java.lang.Exception

line

public static java.lang.String line(java.io.BufferedReader in)
                             throws java.lang.Exception

Throws:

java.lang.Exception

tag

public static java.lang.String tag()

tag

public static java.lang.String tag(java.io.File file)

tag

public static java.lang.String tag(java.io.File file,
                                   boolean html)

tag

public static java.lang.String tag(java.lang.Object tag)

tag

public static java.lang.String tag(java.lang.Object tag,
                                   boolean html)

newExt

public static java.io.File newExt(java.io.File f,
                                  java.lang.String ext)

extension

public static java.lang.String extension(java.io.File f)

fileListAll

public static java.util.List fileListAll(java.io.File dir)

fileList

public static java.util.List fileList(java.io.File dir,
                                      java.lang.String[] exts)

fileList

public static java.util.List fileList(java.io.File dir,
                                      java.lang.String ext)

files

public static java.io.File[] files(java.io.File dir)

files

public static java.io.File[] files(java.io.File dir,
                                   java.lang.String ext)

files

public static java.io.File[] files(java.io.File dir,
                                   java.lang.String[] exts)

dirList

public static java.util.List dirList(java.io.File dir)

dirs

public static java.io.File[] dirs(java.io.File dir)

findDirs

public static java.util.List findDirs(java.io.File dir,
                                      java.io.File[] except)
                               throws java.lang.Exception

Throws:

java.lang.Exception

findDirs

public static java.util.List findDirs(java.io.File dir,
                                      java.io.FileFilter filter)
                               throws java.lang.Exception

Throws:

java.lang.Exception

findDirs

public static java.util.List findDirs(java.io.File dir)
                               throws java.lang.Exception

Throws:

java.lang.Exception

findFiles

public static java.util.List findFiles(java.io.File dir,
                                       java.lang.String[] exts)
                                throws java.lang.Exception

Throws:

java.lang.Exception

findFiles

public static java.util.List findFiles(java.io.File dir)
                                throws java.lang.Exception

Throws:

java.lang.Exception

findFiles

public static java.util.List findFiles(java.io.File dir,
                                       java.lang.String ext)
                                throws java.lang.Exception

Throws:

java.lang.Exception

findFiles

public static java.util.List findFiles(java.io.File dir,
                                       java.io.FileFilter filter)
                                throws java.lang.Exception

Throws:

java.lang.Exception

copy

public static int copy(java.io.File input,
                       java.io.File output)
                throws java.lang.Exception

Throws:

java.lang.Exception

copy

public static int copy(java.io.File input,
                       java.io.File output,
                       java.io.PrintStream err)
                throws java.lang.Exception

Throws:

java.lang.Exception

copy

public static int copy(java.io.InputStream istream,
                       java.io.OutputStream ostream)
                throws java.lang.Exception

Throws:

java.lang.Exception

copy

public static int copy(java.io.InputStream istream,
                       java.io.OutputStream ostream,
                       java.io.PrintStream err)
                throws java.lang.Exception

Throws:

java.lang.Exception

ensureFile

public static java.io.File ensureFile(java.io.File file,
                                      IO.FileMaker maker)

Ensures that file exists and all its directories are made. If file is a directory a new file will be made with maker.

Parameters:

file - The file to inspect.

maker - The FileMaker used to make a new file if file is a directory.

Returns:

The valid file to use.

ensureFile

public static java.io.File ensureFile(java.io.File file)

Calls ensureFile(java.io.File,FileMaker) with the default FileMaker.

See Also:

ensureFile(java.io.File,FileMaker)

relativeFile

public static java.io.File relativeFile(java.io.File base,
                                        java.io.File file)

exists

public static boolean exists(java.io.File f)

isExistingFile

public static boolean isExistingFile(java.io.File f)

isExistingDir

public static boolean isExistingDir(java.io.File f)

relativePath

public static java.lang.String relativePath(java.io.File base,
                                            java.io.File file)

separatorChars

public static final char[] separatorChars()

separators

public static final java.lang.String[] separators()

realFileName

public static java.lang.String realFileName(java.lang.String str)

javapalmFile

public static java.io.File javapalmFile(java.lang.String name)

javapalmFile

public static java.io.File javapalmFile(java.io.File dir,
                                        java.lang.String name)

javapalmDir

public static java.io.File javapalmDir()

javapalmDir

public static java.io.File javapalmDir(java.io.File dir)

macMailDir

public static Dir macMailDir()

mozillaDir

public static Dir mozillaDir()

thunderbirdDir

public static Dir thunderbirdDir()

userHome

public static java.io.File userHome()

createTempFile

public static java.io.File createTempFile(java.io.File f,
                                          boolean delete)
                                   throws java.io.IOException

Throws:

java.io.IOException

createTempFile

public static java.io.File createTempFile(java.lang.String name,
                                          boolean delete)
                                   throws java.io.IOException

Throws:

java.io.IOException

newFile

public static java.io.File newFile(java.lang.String str)

newFile

public static java.io.File newFile(java.io.File dir,
                                   java.lang.String str)

newDir

public static java.io.File newDir(java.lang.String str)

newFileWithExtension

public static java.io.File newFileWithExtension(java.io.File f,
                                                java.lang.String ext)

dot

public static java.lang.String dot(java.lang.String str)

mkdirs

public static java.io.File mkdirs(java.io.File dir,
                                  java.lang.String name)

mkdirs

public static java.io.File mkdirs(java.io.File dir)

mkdir

public static java.io.File mkdir(java.io.File dir,
                                 java.lang.String name)

mkdir

public static java.io.File mkdir(java.io.File dir)

removeSuffix

public static java.lang.String removeSuffix(java.io.File file)

removeSuffix

public static java.lang.String removeSuffix(java.lang.String fileName)

serialize

public static void serialize(java.io.File outfile,
                             java.lang.Object o)
                      throws java.lang.Exception

Throws:

java.lang.Exception

deserialize

public static java.lang.Object deserialize(java.io.File infile)
                                    throws java.lang.Exception

Throws:

java.lang.Exception

du

public static long du(java.io.File f)

toString

public static java.lang.String toString(java.io.File f,
                                        int numDirs)

serializedFile

public static java.io.File serializedFile(java.lang.String name)

newUniqueFile

public static java.io.File newUniqueFile(java.io.File parentDir,
                                         java.lang.String name,
                                         IO.TryIterator ti,
                                         int maxTries)

newFile

public static java.io.File newFile(java.io.File parent,
                                   java.lang.String name,
                                   java.lang.String ext)

newUniqueFile

public static java.io.File newUniqueFile(java.io.File parentDir,
                                         java.lang.String name,
                                         IO.TryIterator ti)

newUniqueFile

public static java.io.File newUniqueFile(java.io.File parentDir,
                                         java.lang.String name)

pwd

public static java.io.File pwd()

touch

public static java.io.File touch(java.lang.String s)
                          throws java.lang.Exception

Throws:

java.lang.Exception

touch

public static java.io.File touch(java.io.File f)
                          throws java.lang.Exception

Throws:

java.lang.Exception

read

public static void read(java.lang.String fileName,
                        IO.ReadAction action)
                 throws java.io.IOException

Throws:

java.io.IOException

read

public static void read(java.io.File file,
                        IO.ReadAction action)
                 throws java.io.IOException

Throws:

java.io.IOException

read

public static void read(java.net.URL url,
                        IO.ReadAction action)
                 throws java.io.IOException

Throws:

java.io.IOException

formatLength

public static java.lang.String formatLength(java.io.File f)

formatLength

public static java.lang.String formatLength(double length)

formatLength

public static java.lang.String formatLength(double length,
                                            int places)

foreachSeparators

public boolean foreachSeparators(IO.LambdaSep sep)