youys
/
ant
Not watched
1
0
Fork 1
Code
Releases 0 Wiki Activity
Issues 0 Pull Requests 0 Datasets Model Cloudbrain
Browse Source

Various aesthetic changes + isSymbolicLink() works when parent arg is null. 

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@277463 13f79535-47bb-0310-9956-ffa450edef68
master
Matthew Jason Benson 20 years ago
parent
4c77f5ea1b
commit
3ca199cab8
1 changed files with 130 additions and 168 deletions
Split View
Diff Options
Show Stats Download Patch File Download Diff File
  1. +130
    -168
      src/main/org/apache/tools/ant/util/FileUtils.java

+ 130
- 168
src/main/org/apache/tools/ant/util/FileUtils.java View File

@@ -50,9 +50,9 @@ import org.apache.tools.ant.launch.Locator;

/**
* This class also encapsulates methods which allow Files to be
* refered to using abstract path names which are translated to native
* referred to using abstract path names which are translated to native
* system file paths at runtime as well as copying files or setting
* there last modification time.
* their last modification time.
*
* @version $Revision$
*/
@@ -76,12 +76,12 @@ public class FileUtils {
private static char[] escapedChar2 = new char[256];

/**
* the granularity of timestamps under FAT
* The granularity of timestamps under FAT.
*/
public static final long FAT_FILE_TIMESTAMP_GRANULARITY = 2000;

/**
* the granularity of timestamps under Unix
* The granularity of timestamps under Unix.
*/
public static final long UNIX_FILE_TIMESTAMP_GRANULARITY = 1000;

@@ -135,10 +135,10 @@ public class FileUtils {
}

/**
* Get the URL for a file taking into account # characters
* Get the URL for a file taking into account # characters.
*
* @param file the file whose URL representation is required.
* @return The FileURL value
* @return The FileURL value.
* @throws MalformedURLException if the URL representation cannot be
* formed.
*/
@@ -147,7 +147,7 @@ public class FileUtils {
}

/**
* Convienence method to copy a file from a source to a destination.
* Convenience method to copy a file from a source to a destination.
* No filtering is performed.
*
* @param sourceFile Name of file to copy from.
@@ -155,7 +155,7 @@ public class FileUtils {
* @param destFile Name of file to copy to.
* Must not be <code>null</code>.
*
* @throws IOException if the copying fails
* @throws IOException if the copying fails.
*/
public void copyFile(String sourceFile, String destFile)
throws IOException {
@@ -163,16 +163,16 @@ public class FileUtils {
}

/**
* Convienence method to copy a file from a source to a destination
* Convenience method to copy a file from a source to a destination
* specifying if token filtering must be used.
*
* @param sourceFile Name of file to copy from.
* Must not be <code>null</code>.
* @param destFile Name of file to copy to.
* Must not be <code>null</code>.
* @param filters the collection of filters to apply to this copy
* @param filters the collection of filters to apply to this copy.
*
* @throws IOException if the copying fails
* @throws IOException if the copying fails.
*/
public void copyFile(String sourceFile, String destFile,
FilterSetCollection filters)
@@ -182,7 +182,7 @@ public class FileUtils {
}

/**
* Convienence method to copy a file from a source to a
* Convenience method to copy a file from a source to a
* destination specifying if token filtering must be used and if
* source files may overwrite newer destination files.
*
@@ -190,11 +190,11 @@ public class FileUtils {
* Must not be <code>null</code>.
* @param destFile Name of file to copy to.
* Must not be <code>null</code>.
* @param filters the collection of filters to apply to this copy
* @param filters the collection of filters to apply to this copy.
* @param overwrite Whether or not the destination file should be
* overwritten if it already exists.
*
* @throws IOException if the copying fails
* @throws IOException if the copying fails.
*/
public void copyFile(String sourceFile, String destFile, FilterSetCollection filters,
boolean overwrite) throws IOException {
@@ -203,7 +203,7 @@ public class FileUtils {
}

/**
* Convienence method to copy a file from a source to a
* Convenience method to copy a file from a source to a
* destination specifying if token filtering must be used, if
* source files may overwrite newer destination files and the
* last modified time of <code>destFile</code> file should be made equal
@@ -213,14 +213,14 @@ public class FileUtils {
* Must not be <code>null</code>.
* @param destFile Name of file to copy to.
* Must not be <code>null</code>.
* @param filters the collection of filters to apply to this copy
* @param filters the collection of filters to apply to this copy.
* @param overwrite Whether or not the destination file should be
* overwritten if it already exists.
* @param preserveLastModified Whether or not the last modified time of
* the resulting file should be set to that
* of the source file.
*
* @throws IOException if the copying fails
* @throws IOException if the copying fails.
*/
public void copyFile(String sourceFile, String destFile, FilterSetCollection filters,
boolean overwrite, boolean preserveLastModified)
@@ -230,7 +230,7 @@ public class FileUtils {
}

/**
* Convienence method to copy a file from a source to a
* Convenience method to copy a file from a source to a
* destination specifying if token filtering must be used, if
* source files may overwrite newer destination files and the
* last modified time of <code>destFile</code> file should be made equal
@@ -240,7 +240,7 @@ public class FileUtils {
* Must not be <code>null</code>.
* @param destFile Name of file to copy to.
* Must not be <code>null</code>.
* @param filters the collection of filters to apply to this copy
* @param filters the collection of filters to apply to this copy.
* @param overwrite Whether or not the destination file should be
* overwritten if it already exists.
* @param preserveLastModified Whether or not the last modified time of
@@ -248,7 +248,7 @@ public class FileUtils {
* of the source file.
* @param encoding the encoding used to read and write the files.
*
* @throws IOException if the copying fails
* @throws IOException if the copying fails.
*
* @since Ant 1.5
*/
@@ -261,7 +261,7 @@ public class FileUtils {
}

/**
* Convienence method to copy a file from a source to a
* Convenience method to copy a file from a source to a
* destination specifying if token filtering must be used, if
* filter chains must be used, if source files may overwrite
* newer destination files and the last modified time of
@@ -272,7 +272,7 @@ public class FileUtils {
* Must not be <code>null</code>.
* @param destFile Name of file to copy to.
* Must not be <code>null</code>.
* @param filters the collection of filters to apply to this copy
* @param filters the collection of filters to apply to this copy.
* @param filterChains filterChains to apply during the copy.
* @param overwrite Whether or not the destination file should be
* overwritten if it already exists.
@@ -280,9 +280,9 @@ public class FileUtils {
* the resulting file should be set to that
* of the source file.
* @param encoding the encoding used to read and write the files.
* @param project the project instance
* @param project the project instance.
*
* @throws IOException if the copying fails
* @throws IOException if the copying fails.
*
* @since Ant 1.5
*/
@@ -297,7 +297,7 @@ public class FileUtils {
}

/**
* Convienence method to copy a file from a source to a
* Convenience method to copy a file from a source to a
* destination specifying if token filtering must be used, if
* filter chains must be used, if source files may overwrite
* newer destination files and the last modified time of
@@ -308,7 +308,7 @@ public class FileUtils {
* Must not be <code>null</code>.
* @param destFile Name of file to copy to.
* Must not be <code>null</code>.
* @param filters the collection of filters to apply to this copy
* @param filters the collection of filters to apply to this copy.
* @param filterChains filterChains to apply during the copy.
* @param overwrite Whether or not the destination file should be
* overwritten if it already exists.
@@ -317,9 +317,9 @@ public class FileUtils {
* of the source file.
* @param inputEncoding the encoding used to read the files.
* @param outputEncoding the encoding used to write the files.
* @param project the project instance
* @param project the project instance.
*
* @throws IOException if the copying fails
* @throws IOException if the copying fails.
*
* @since Ant 1.6
*/
@@ -335,7 +335,7 @@ public class FileUtils {
}

/**
* Convienence method to copy a file from a source to a destination.
* Convenience method to copy a file from a source to a destination.
* No filtering is performed.
*
* @param sourceFile the file to copy from.
@@ -343,23 +343,23 @@ public class FileUtils {
* @param destFile the file to copy to.
* Must not be <code>null</code>.
*
* @throws IOException if the copying fails
* @throws IOException if the copying fails.
*/
public void copyFile(File sourceFile, File destFile) throws IOException {
copyFile(sourceFile, destFile, null, false, false);
}

/**
* Convienence method to copy a file from a source to a destination
* Convenience method to copy a file from a source to a destination
* specifying if token filtering must be used.
*
* @param sourceFile the file to copy from.
* Must not be <code>null</code>.
* @param destFile the file to copy to.
* Must not be <code>null</code>.
* @param filters the collection of filters to apply to this copy
* @param filters the collection of filters to apply to this copy.
*
* @throws IOException if the copying fails
* @throws IOException if the copying fails.
*/
public void copyFile(File sourceFile, File destFile, FilterSetCollection filters)
throws IOException {
@@ -367,7 +367,7 @@ public class FileUtils {
}

/**
* Convienence method to copy a file from a source to a
* Convenience method to copy a file from a source to a
* destination specifying if token filtering must be used and if
* source files may overwrite newer destination files.
*
@@ -375,11 +375,11 @@ public class FileUtils {
* Must not be <code>null</code>.
* @param destFile the file to copy to.
* Must not be <code>null</code>.
* @param filters the collection of filters to apply to this copy
* @param filters the collection of filters to apply to this copy.
* @param overwrite Whether or not the destination file should be
* overwritten if it already exists.
*
* @throws IOException if the copying fails
* @throws IOException if the copying fails.
*/
public void copyFile(File sourceFile, File destFile, FilterSetCollection filters,
boolean overwrite) throws IOException {
@@ -387,7 +387,7 @@ public class FileUtils {
}

/**
* Convienence method to copy a file from a source to a
* Convenience method to copy a file from a source to a
* destination specifying if token filtering must be used, if
* source files may overwrite newer destination files and the
* last modified time of <code>destFile</code> file should be made equal
@@ -397,14 +397,14 @@ public class FileUtils {
* Must not be <code>null</code>.
* @param destFile the file to copy to.
* Must not be <code>null</code>.
* @param filters the collection of filters to apply to this copy
* @param filters the collection of filters to apply to this copy.
* @param overwrite Whether or not the destination file should be
* overwritten if it already exists.
* @param preserveLastModified Whether or not the last modified time of
* the resulting file should be set to that
* of the source file.
*
* @throws IOException if the copying fails
* @throws IOException if the copying fails.
*/
public void copyFile(File sourceFile, File destFile, FilterSetCollection filters,
boolean overwrite, boolean preserveLastModified)
@@ -414,7 +414,7 @@ public class FileUtils {
}

/**
* Convienence method to copy a file from a source to a
* Convenience method to copy a file from a source to a
* destination specifying if token filtering must be used, if
* source files may overwrite newer destination files, the last
* modified time of <code>destFile</code> file should be made
@@ -425,7 +425,7 @@ public class FileUtils {
* Must not be <code>null</code>.
* @param destFile the file to copy to.
* Must not be <code>null</code>.
* @param filters the collection of filters to apply to this copy
* @param filters the collection of filters to apply to this copy.
* @param overwrite Whether or not the destination file should be
* overwritten if it already exists.
* @param preserveLastModified Whether or not the last modified time of
@@ -433,7 +433,7 @@ public class FileUtils {
* of the source file.
* @param encoding the encoding used to read and write the files.
*
* @throws IOException if the copying fails
* @throws IOException if the copying fails.
*
* @since Ant 1.5
*/
@@ -446,7 +446,7 @@ public class FileUtils {
}

/**
* Convienence method to copy a file from a source to a
* Convenience method to copy a file from a source to a
* destination specifying if token filtering must be used, if
* filter chains must be used, if source files may overwrite
* newer destination files and the last modified time of
@@ -457,7 +457,7 @@ public class FileUtils {
* Must not be <code>null</code>.
* @param destFile the file to copy to.
* Must not be <code>null</code>.
* @param filters the collection of filters to apply to this copy
* @param filters the collection of filters to apply to this copy.
* @param filterChains filterChains to apply during the copy.
* @param overwrite Whether or not the destination file should be
* overwritten if it already exists.
@@ -465,9 +465,9 @@ public class FileUtils {
* the resulting file should be set to that
* of the source file.
* @param encoding the encoding used to read and write the files.
* @param project the project instance
* @param project the project instance.
*
* @throws IOException if the copying fails
* @throws IOException if the copying fails.
*
* @since Ant 1.5
*/
@@ -481,7 +481,7 @@ public class FileUtils {
}

/**
* Convienence method to copy a file from a source to a
* Convenience method to copy a file from a source to a
* destination specifying if token filtering must be used, if
* filter chains must be used, if source files may overwrite
* newer destination files and the last modified time of
@@ -492,7 +492,7 @@ public class FileUtils {
* Must not be <code>null</code>.
* @param destFile the file to copy to.
* Must not be <code>null</code>.
* @param filters the collection of filters to apply to this copy
* @param filters the collection of filters to apply to this copy.
* @param filterChains filterChains to apply during the copy.
* @param overwrite Whether or not the destination file should be
* overwritten if it already exists.
@@ -501,10 +501,10 @@ public class FileUtils {
* of the source file.
* @param inputEncoding the encoding used to read the files.
* @param outputEncoding the encoding used to write the files.
* @param project the project instance
* @param project the project instance.
*
*
* @throws IOException if the copying fails
* @throws IOException if the copying fails.
*
* @since Ant 1.6
*/
@@ -521,23 +521,19 @@ public class FileUtils {
if (destFile.exists() && destFile.isFile()) {
destFile.delete();
}

// ensure that parent dir of dest file exists!
// not using getParentFile method to stay 1.1 compat
File parent = destFile.getParentFile();
if (parent != null && !parent.exists()) {
parent.mkdirs();
}

final boolean filterSetsAvailable = (filters != null
&& filters.hasFilters());
final boolean filterChainsAvailable = (filterChains != null
&& filterChains.size() > 0);

if (filterSetsAvailable) {
BufferedReader in = null;
BufferedWriter out = null;

try {
if (inputEncoding == null) {
in = new BufferedReader(new FileReader(sourceFile));
@@ -547,7 +543,6 @@ public class FileUtils {
inputEncoding);
in = new BufferedReader(isr);
}

if (outputEncoding == null) {
out = new BufferedWriter(new FileWriter(destFile));
} else {
@@ -556,7 +551,6 @@ public class FileUtils {
outputEncoding);
out = new BufferedWriter(osw);
}

if (filterChainsAvailable) {
ChainReaderHelper crh = new ChainReaderHelper();
crh.setBufferSize(BUF_SIZE);
@@ -566,7 +560,6 @@ public class FileUtils {
Reader rdr = crh.getAssembledReader();
in = new BufferedReader(rdr);
}

LineTokenizer lineTokenizer = new LineTokenizer();
lineTokenizer.setIncludeDelims(true);
String newline = null;
@@ -592,7 +585,6 @@ public class FileUtils {
|| (inputEncoding == null && outputEncoding != null)) {
BufferedReader in = null;
BufferedWriter out = null;

try {
if (inputEncoding == null) {
in = new BufferedReader(new FileReader(sourceFile));
@@ -603,7 +595,6 @@ public class FileUtils {
new FileInputStream(sourceFile),
inputEncoding));
}

if (outputEncoding == null) {
out = new BufferedWriter(new FileWriter(destFile));
} else {
@@ -613,7 +604,6 @@ public class FileUtils {
new FileOutputStream(destFile),
outputEncoding));
}

if (filterChainsAvailable) {
ChainReaderHelper crh = new ChainReaderHelper();
crh.setBufferSize(BUF_SIZE);
@@ -653,14 +643,12 @@ public class FileUtils {
close(in);
}
}

if (preserveLastModified) {
destFile.setLastModified(sourceFile.lastModified());
setFileLastModified(destFile, sourceFile.lastModified());
}
}
}


/**
* Calls File.setLastModified(long time). Originally written to
* to dynamically bind to that call on Java1.2+.
@@ -668,18 +656,13 @@ public class FileUtils {
* @param file the file whose modified time is to be set
* @param time the time to which the last modified time is to be set.
* if this is -1, the current time is used.
* @throws BuildException if the time cannot be set.
*/
public void setFileLastModified(File file, long time)
throws BuildException {
if (time < 0) {
time = System.currentTimeMillis();
}
file.setLastModified(time);
public void setFileLastModified(File file, long time) {
file.setLastModified((time < 0) ? System.currentTimeMillis() : time);
}

/**
* Interpret the filename as a file relative to the given file -
* Interpret the filename as a file relative to the given file
* unless the filename already represents an absolute filename.
*
* @param file the "reference" file for relative paths. This
@@ -688,7 +671,7 @@ public class FileUtils {
* of /). If it is null, this call is equivalent to
* <code>new java.io.File(filename)</code>.
*
* @param filename a file name
* @param filename a file name.
*
* @return an absolute file that doesn't contain &quot;./&quot; or
* &quot;../&quot; sequences and uses the correct separator for
@@ -702,11 +685,9 @@ public class FileUtils {
if (isAbsolutePath(filename)) {
return normalize(filename);
}

if (file == null) {
return new File(filename);
}

File helpFile = new File(file.getAbsolutePath());
StringTokenizer tok = new StringTokenizer(filename, File.separator);
while (tok.hasMoreTokens()) {
@@ -725,49 +706,46 @@ public class FileUtils {
helpFile = new File(helpFile, part);
}
}

return new File(helpFile.getAbsolutePath());
}

/**
* Verifies if the filename represents is an absolute path.
* @param filename the file name to be checked for being an absolute path
* @param filename the file name to be checked for being an absolute path.
* @return true if the filename represents an absolute path.
*/
private static boolean isAbsolutePath(String filename) {
if (filename.startsWith(File.separator)) {
// common for all os
return true;
} else if (onDos
&& filename.length() >= 2
&& Character.isLetter(filename.charAt(0))
&& filename.charAt(1) == ':') {
}
if (onDos && filename.length() >= 2
&& Character.isLetter(filename.charAt(0))
&& filename.charAt(1) == ':') {
// Actually on windows the : must be followed by a \ for
// the path to be absolute, else the path is relative
// to the current working directory on that drive.
// (Every drive may have another current working directory)
return true;
} else if (onNetWare && filename.indexOf(":") > -1) {
return true;
}
return false;
return (onNetWare && filename.indexOf(":") > -1);
}

/**
* &quot;normalize&quot; the given absolute path.
* &quot;Normalize&quot; the given absolute path.
*
* <p>This includes:
* <ul>
* <li>Uppercase the drive letter if there is one.</li>
* <li>Remove redundant slashes after the drive spec.</li>
* <li>resolve all ./, .\, ../ and ..\ sequences.</li>
* <li>Resolve all ./, .\, ../ and ..\ sequences.</li>
* <li>DOS style paths that start with a drive letter will have
* \ as the separator.</li>
* </ul>
* Unlike <code>File#getCanonicalPath()</code> it specifically doesn't
* resolve symbolic links.
* Unlike <code>File#getCanonicalPath()</code> this method
* specifically does not resolve symbolic links.
*
* @param path the path to be normalized
* @param path the path to be normalized.
* @return the normalized version of the path.
*
* @throws java.lang.NullPointerException if the file path is
@@ -786,7 +764,6 @@ public class FileUtils {
String msg = path + " is not an absolute path";
throw new BuildException(msg);
}

boolean dosWithDrive = false;
String root = null;
// Eliminate consecutive slashes after the drive spec
@@ -817,7 +794,6 @@ public class FileUtils {
}
}
path = sbPath.toString().replace('\\', File.separatorChar);

} else {
if (path.length() == 1) {
root = File.separator;
@@ -831,7 +807,6 @@ public class FileUtils {
path = path.substring(1);
}
}

Stack s = new Stack();
s.push(root);
StringTokenizer tok = new StringTokenizer(path, File.separator);
@@ -849,7 +824,6 @@ public class FileUtils {
s.push(thisToken);
}
}

StringBuffer sb = new StringBuffer();
for (int i = 0; i < s.size(); i++) {
if (i > 1) {
@@ -859,8 +833,6 @@ public class FileUtils {
}
sb.append(s.elementAt(i));
}


path = sb.toString();
if (dosWithDrive) {
path = path.replace('/', '\\');
@@ -934,18 +906,16 @@ public class FileUtils {
* exist before this method was invoked, any subsequent invocation
* of this method will yield a different file name.</p>
* <p>
* The filename is prefixNNNNNsuffix where NNNN is a random number
* The filename is prefixNNNNNsuffix where NNNN is a random number.
* </p>
* <p>This method is different to File.createTempFile of JDK 1.2
* as it doesn't create the file itself.
* It uses the location pointed to by java.io.tmpdir
* when the parentDir attribute is
* null.</p>
* <p>This method is different from File.createTempFile() of JDK 1.2
* as it doesn't create the file itself. It uses the location pointed
* to by java.io.tmpdir when the parentDir attribute is null.</p>
*
* @param prefix prefix before the random number
* @param suffix file extension; include the '.'
* @param parentDir Directory to create the temporary file in -
* java.io.tmpdir used if not specificed
* @param prefix prefix before the random number.
* @param suffix file extension; include the '.'.
* @param parentDir Directory to create the temporary file in;
* java.io.tmpdir used if not specified.
*
* @return a File reference to the new temporary file.
* @since ant 1.5
@@ -999,27 +969,21 @@ public class FileUtils {
if (f1.exists() != f2.exists()) {
return false;
}

if (!f1.exists()) {
// two not existing files are equal
return true;
}

// should the following two be switched? If f1 and f2 refer to the same file,
// isn't their content equal regardless of whether that file is a directory?
if (f1.isDirectory() || f2.isDirectory()) {
// don't want to compare directory contents for now
return false;
}

if (fileNameEquals(f1, f2)) {
// same filename => true
return true;
}

if (textfile) {
return textEquals(f1, f2);
} else {
return binaryEquals(f1, f2);
}
return textfile ? textEquals(f1, f2) : binaryEquals(f1, f2);
}

/**
@@ -1112,9 +1076,9 @@ public class FileUtils {
}

/**
* Read from reader till EOF
* Read from reader till EOF.
* @param rdr the reader from which to read.
* @return the contents read out of the given reader
* @return the contents read out of the given reader.
*
* @throws IOException if the contents could not be read out from the
* reader.
@@ -1124,12 +1088,12 @@ public class FileUtils {
}

/**
* Read from reader till EOF
* Read from reader till EOF.
*
* @param rdr the reader from which to read.
* @param bufferSize the buffer size to use when reading
* @param bufferSize the buffer size to use when reading.
*
* @return the contents read out of the given reader
* @return the contents read out of the given reader.
*
* @throws IOException if the contents could not be read out from the
* reader.
@@ -1160,13 +1124,13 @@ public class FileUtils {
* <p>This method has historically <strong>not</strong> guaranteed that the
* operation was atomic. In its current implementation it is.
*
* @param f the file to be created
* @param f the file to be created.
* @return true if the file did not exist already.
* @throws IOException on error
* @throws IOException on error.
* @since Ant 1.5
*/
public boolean createNewFile(File f) throws IOException {
return createNewFile(f, false);
return f.createNewFile();
}

/**
@@ -1190,20 +1154,20 @@ public class FileUtils {
* Checks whether a given file is a symbolic link.
*
* <p>It doesn't really test for symbolic links but whether the
* canonical and absolute paths of the file are identical - this
* canonical and absolute paths of the file are identical--this
* may lead to false positives on some platforms.</p>
*
* @param parent the parent directory of the file to test
* @param name the name of the file to test.
*
* @return true if the file is a symbolic link.
* @throws IOException on error
* @throws IOException on error.
* @since Ant 1.5
*/
public boolean isSymbolicLink(File parent, String name)
throws IOException {
File resolvedParent = new File(parent.getCanonicalPath());
File toTest = new File(resolvedParent, name);
File toTest = new File(((parent == null)
? null : parent.getCanonicalPath()), name);
return !toTest.getAbsolutePath().equals(toTest.getCanonicalPath());
}

@@ -1214,7 +1178,7 @@ public class FileUtils {
* @param path The path to remove from, must not be null, must be absolute.
*
* @return path's normalized absolute if it doesn't start with
* leading, path's path with leading's path removed otherwise.
* leading; path's path with leading's path removed otherwise.
*
* @since Ant 1.5
*/
@@ -1241,7 +1205,7 @@ public class FileUtils {
*
* <p>This code doesn't handle non-ASCII characters properly.</p>
*
* @param path the path in the local file system
* @param path the path in the local file system.
* @return the URI version of the local path.
* @since Ant 1.6
*/
@@ -1332,8 +1296,8 @@ public class FileUtils {
* <code>from</code>, which involves deleting <code>from</code> as
* well.</p>
*
* @param from the file to move
* @param to the new file name
* @param from the file to move.
* @param to the new file name.
*
* @throws IOException if anything bad happens during this
* process. Note that <code>to</code> may have been deleted
@@ -1361,30 +1325,27 @@ public class FileUtils {
}

/**
* get the granularity of file timestamps.
* The choice is made on OS, which is incorrect -it should really be
* Get the granularity of file timestamps.
* The choice is made based on OS, which is incorrect--it should really be
* by filesystem. We do not have an easy way to probe for file systems,
* however.
* @return the difference, in milliseconds, which two file timestamps must have
* in order for the two files to be given a creation order.
*/
public long getFileTimestampGranularity() {
if (onDos) {
return FAT_FILE_TIMESTAMP_GRANULARITY;
} else {
return UNIX_FILE_TIMESTAMP_GRANULARITY;
}
return onDos
? FAT_FILE_TIMESTAMP_GRANULARITY : UNIX_FILE_TIMESTAMP_GRANULARITY;
}

/**
* Returns true if the source is older than the dest.
* If the dest file does not exist, then the test returns false; it is
* implicitly not up do date.
* @param source source file (should be the older)
* @param dest dest file (should be the newer)
* @param source source file (should be the older).
* @param dest dest file (should be the newer).
* @param granularity an offset added to the source time.
* @return true if the source is older than the dest, taking the
* granularity into account
* @return true if the source is older than the dest after accounting
* for granularity.
* @since Ant1.7
*/
public boolean isUpToDate(File source, File dest, long granularity) {
@@ -1400,10 +1361,10 @@ public class FileUtils {


/**
* returns true if the source is older than the dest
* @param source source file (should be the older)
* @param dest dest file (should be the newer)
* @return true if the source is older than the dest, taking the granularity into account
* Returns true if the source is older than the dest.
* @param source source file (should be the older).
* @param dest dest file (should be the newer).
* @return true if the source is older than the dest, taking the granularity into account.
* @since Ant1.7
*/
public boolean isUpToDate(File source, File dest) {
@@ -1411,12 +1372,13 @@ public class FileUtils {
}

/**
* compare two timestamps for being up to date, use granularity too.,
* Compare two timestamps for being up to date using
* the specified granularity.
*
* @param sourceTime timestamp of source file
* @param destTime timestamp of dest file
* @param granularity os/filesys granularity
* @return true if the dest file is considered up to date
* @param sourceTime timestamp of source file.
* @param destTime timestamp of dest file.
* @param granularity os/filesys granularity.
* @return true if the dest file is considered up to date.
*/
public boolean isUpToDate(long sourceTime, long destTime, long granularity) {
if (destTime == -1) {
@@ -1426,21 +1388,21 @@ public class FileUtils {
}

/**
* compare two timestamps for being up to date, use the
* current granularity
* Compare two timestamps for being up to date using the
* current granularity.
*
* @param sourceTime timestamp of source file
* @param destTime timestamp of dest file
* @return true if the dest file is considered up to date
* @param sourceTime timestamp of source file.
* @param destTime timestamp of dest file.
* @return true if the dest file is considered up to date.
*/
public boolean isUpToDate(long sourceTime, long destTime) {
return isUpToDate(sourceTime, destTime, getFileTimestampGranularity());
}

/**
* close a writer without throwing any exception if something went wrong.
* Do not attempt to close it if the file is null
* @param device output writer, can be null
* Close a Writer without throwing any exception if something went wrong.
* Do not attempt to close it if the argument is null.
* @param device output writer, can be null.
*/
public static void close(Writer device) {
if (device != null) {
@@ -1453,10 +1415,10 @@ public class FileUtils {
}

/**
* close a stream without throwing any exception if something went wrong.
* Do not attempt to close it if the file is null
* Close a stream without throwing any exception if something went wrong.
* Do not attempt to close it if the argument is null.
*
* @param device stream, can be null
* @param device Reader, can be null.
*/
public static void close(Reader device) {
if (device != null) {
@@ -1469,10 +1431,10 @@ public class FileUtils {
}

/**
* close a stream without throwing any exception if something went wrong.
* Do not attempt to close it if the file is null
* Close a stream without throwing any exception if something went wrong.
* Do not attempt to close it if the argument is null.
*
* @param device stream, can be null
* @param device stream, can be null.
*/
public static void close(OutputStream device) {
if (device != null) {
@@ -1485,10 +1447,10 @@ public class FileUtils {
}

/**
* close a stream without throwing any exception if something went wrong.
* Do not attempt to close it if the file is null
* Close a stream without throwing any exception if something went wrong.
* Do not attempt to close it if the argument is null.
*
* @param device stream, can be null
* @param device stream, can be null.
*/
public static void close(InputStream device) {
if (device != null) {
@@ -1502,8 +1464,8 @@ public class FileUtils {

/**
* Delete the file with {@link File#delete()} if the argument is not null.
* Do nothing on a null argument
* @param file file to delete
* Do nothing on a null argument.
* @param file file to delete.
*/
public static void delete(File file) {
if (file != null) {


Write Preview
Loading…
Cancel
Save
Please read the following content carefully:

Dear OpenI User

Thank you for your continuous support to the Openl Qizhi Community AI Collaboration Platform. In order to protect your usage rights and ensure network security, we updated the Openl Qizhi Community AI Collaboration Platform Usage Agreement in January 2024. The updated agreement specifies that users are prohibited from using intranet penetration tools. After you click "Agree and continue", you can continue to use our services. Thank you for your cooperation and understanding.

For more agreement content, please refer to the《Openl Qizhi Community AI Collaboration Platform Usage Agreement》

Agree and continue
Disagree, exit