com.jeffpalm.util
Class IO

java.lang.Object
  extended by 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)