com.vladium.util

类 Files

java.lang.Object

com.vladium.util.Files

public abstract class Files
extends Object

作者:

Vlad Roubtsov, (C) 2003

方法概要

限定符和类型	方法和说明
static File	canonicalizeFile(File file)
static String	canonicalizePathname(String pathname) Converts 'pathname' into the canonical OS form.
static File	createTempFile(File parentDir, String prefix, String extension) A slightly stricter version of File.createTempFile() in J2SDK 1.3: it requires that the caller provide an existing parent directory for the temp file.
static String	getFileExtension(File file) Invariant: (getFileName (file) + getFileExtension (file)).equals (file.getName ()).
static String	getFileName(File file) Invariant: (getFileName (file) + getFileExtension (file)).equals (file.getName ()).
static File	newFile(File dir, File file) Creates a new File from a parent/child pair.
static File	newFile(File dir, String file) Creates a new File from a parent/child pair.
static File	newFile(String dir, String file) Creates a new File from a parent/child pair.
static File[]	pathToFiles(String[] path, boolean canonical) Converts an array of path segments to an array of Files.
static String[]	readFileList(File atfile) No duplicate elimination.
static boolean	renameFile(File source, File target, boolean overwrite) Renames 'source' to 'target' [intermediate directories are created if necessary].

从类继承的方法 java.lang.Object

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

方法详细资料

readFileList

public static String[] readFileList(File atfile)
                             throws IOException

No duplicate elimination.

参数:

atfile -

抛出:

IOException

pathToFiles

public static File[] pathToFiles(String[] path,
                                 boolean canonical)

Converts an array of path segments to an array of Files. The order of files follows the original order of path segments, except "duplicate" entries are removed. The definition of duplicates depends on 'canonical':

• if 'canonical'=true, the pathnames are canonicalized via canonicalizePathname(java.lang.String) before they are compared for equality
• if 'canonical'=false, the pathnames are compared as case-sensitive strings

Note that duplicate removal in classpaths affects ClassLoader.getResources(). The first mode above makes the most sense, however the last one is what Sun's java.net.URLClassLoader appears to do. Hence the last mode might be necessary for reproducing its behavior in Sun-compatible JVMs.

canonicalizePathname

public static String canonicalizePathname(String pathname)

Converts 'pathname' into the canonical OS form. This wrapper function will return the absolute form of 'pathname' if File.getCanonicalPath() fails.

canonicalizeFile

public static File canonicalizeFile(File file)

getFileName

public static String getFileName(File file)

Invariant: (getFileName (file) + getFileExtension (file)).equals (file.getName ()).

参数:

file - File input file descriptor [must be non-null]

返回:

String file name without the extension [excluding '.' separator] [if 'file' does not appear to have an extension, the full name is returned].

抛出:

IllegalArgumentException - if 'file' is null

getFileExtension

public static String getFileExtension(File file)

Invariant: (getFileName (file) + getFileExtension (file)).equals (file.getName ()).

参数:

file - File input file descriptor [must be non-null]

返回:

String extension [including '.' separator] or "" if 'file' does not appear to have an extension.

抛出:

IllegalArgumentException - if 'file' is null

newFile

public static File newFile(File dir,
                           File file)

Creates a new File from a parent/child pair. Takes care of 'file' being absolute (or drive-relative on win32).

参数:

dir - [null is ignored]

file - [absolute overrides 'dir'; may not be null]

newFile

public static File newFile(File dir,
                           String file)

Creates a new File from a parent/child pair. Takes care of 'file' being absolute (or drive-relative on win32).

参数:

dir - [null is ignored]

file - [absolute overrides 'dir'; may not be null]

newFile

public static File newFile(String dir,
                           String file)

Creates a new File from a parent/child pair. Takes care of 'file' being absolute (or drive-relative on win32).

参数:

dir - [null is ignored]

file - [absolute overrides 'dir'; may not be null]

renameFile

public static boolean renameFile(File source,
                                 File target,
                                 boolean overwrite)

Renames 'source' to 'target' [intermediate directories are created if necessary]. If 'target' exists and 'overwrite' is false, the method is a no-op. No exceptions are thrown except for when input is invalid. If the operation fails half-way it can leave some file system artifacts behind.

参数:

source - file descriptor [file must exist]

target - target file descriptor [an existing target may get deleted if 'overwrite' is true]

overwrite - if 'true', forces an existing target to be deleted

返回:

true iff the renaming was actually performed.

抛出:

IllegalArgumentException - if 'source' is null or file does not exist

IllegalArgumentException - if 'target' is null

createTempFile

public static File createTempFile(File parentDir,
                                  String prefix,
                                  String extension)
                           throws IOException

A slightly stricter version of File.createTempFile() in J2SDK 1.3: it requires that the caller provide an existing parent directory for the temp file. This defers to File.createTempFile (prefix, extension, parentDir) after normalizing 'extension'.

MT-safety: if several threads use this API concurrently, the temp files created are guaranteed to get created without any collisions and correspond to files that did not exist before. However, if such a temp file is deleted at a later point, this method may reuse its file name. These MT-safety guarantees do not hold if files are created in the same directory outside of this method.

参数:

parentDir - parent dir for the temp file [may not be null and must exist]

prefix - prefix pattern for the temp file name [only the first 3 chars are guaranteed to be used]

extension - pattern for the temp file name [null is equivalient to ".tmp"; this is always normalized to start with "."; only the first 3 non-"." chars are guaranteed to be used]

返回:

writeable temp file descriptor [incorporates 'parentDir' in its pathname]

抛出:

IOException - if a temp file could not be created