950ebbeaf0
* java/io/DataOutputStream.java (write): Merged from classpath. * java/io/File.java: Merged copyrigth with classpath. * java/io/FileInputStream.java (getChannel): Made it synchronized instead of using a synchronized block. * java/io/FileOutputStream.java: Reformatted. * java/io/InputStreamReader.java (InputStreamReader): Renamed enc to encoding_name. (close): Merged documentation from classpath. (getEncoding): Merged documentation from classpath. (ready): Merged documentation from classpath. (read): Merged documentation from classpath. * java/io/LineNumberReader.java (lineNumber): Made it private. (LineNumberReader): Use Constant instead of a direct value. * java/io/OutputStreamWriter.java (OutputStreamWriter): Renamed enc to encoding_scheme, merged documentation from classpath. (close): Merged documentation from classpath. (flush): Merged documentation from classpath. (write): Merged documentation from classpath. * java/io/PrintStream.java: Reformatted. From-SVN: r64806
638 lines
16 KiB
Java
638 lines
16 KiB
Java
/* File.java -- Class representing a file on disk
|
|
Copyright (C) 1998, 1999, 2000, 2001, 2003 Free Software Foundation, Inc.
|
|
|
|
This file is part of GNU Classpath.
|
|
|
|
GNU Classpath is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 2, or (at your option)
|
|
any later version.
|
|
|
|
GNU Classpath is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with GNU Classpath; see the file COPYING. If not, write to the
|
|
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
|
|
02111-1307 USA.
|
|
|
|
Linking this library statically or dynamically with other modules is
|
|
making a combined work based on this library. Thus, the terms and
|
|
conditions of the GNU General Public License cover the whole
|
|
combination.
|
|
|
|
As a special exception, the copyright holders of this library give you
|
|
permission to link this library with independent modules to produce an
|
|
executable, regardless of the license terms of these independent
|
|
modules, and to copy and distribute the resulting executable under
|
|
terms of your choice, provided that you also meet, for each linked
|
|
independent module, the terms and conditions of the license of that
|
|
module. An independent module is a module which is not derived from
|
|
or based on this library. If you modify this library, you may extend
|
|
this exception to your version of the library, but you are not
|
|
obligated to do so. If you do not wish to do so, delete this
|
|
exception statement from your version. */
|
|
|
|
|
|
package java.io;
|
|
|
|
import java.util.*;
|
|
import java.net.*;
|
|
import gnu.gcj.runtime.FileDeleter;
|
|
|
|
/**
|
|
* @author Tom Tromey <tromey@cygnus.com>
|
|
* @date September 24, 1998
|
|
*/
|
|
|
|
/* Written using "Java Class Libraries", 2nd edition, ISBN 0-201-31002-3
|
|
* "The Java Language Specification", ISBN 0-201-63451-1
|
|
* Status: Complete to version 1.3.
|
|
*/
|
|
|
|
public class File implements Serializable, Comparable
|
|
{
|
|
public boolean canRead ()
|
|
{
|
|
checkRead();
|
|
return _access (READ);
|
|
}
|
|
|
|
public boolean canWrite ()
|
|
{
|
|
checkWrite();
|
|
return _access (WRITE);
|
|
}
|
|
|
|
private native boolean performCreate() throws IOException;
|
|
|
|
/** @since 1.2 */
|
|
public boolean createNewFile() throws IOException
|
|
{
|
|
checkWrite();
|
|
return performCreate();
|
|
}
|
|
|
|
private native boolean performDelete ();
|
|
public boolean delete ()
|
|
{
|
|
SecurityManager s = System.getSecurityManager();
|
|
String name = path;
|
|
if (s != null)
|
|
s.checkDelete(path);
|
|
return performDelete ();
|
|
}
|
|
|
|
public boolean equals (Object obj)
|
|
{
|
|
if (! (obj instanceof File))
|
|
return false;
|
|
File other = (File) obj;
|
|
if (caseSensitive)
|
|
return (path.equals(other.path));
|
|
else
|
|
return (path.equalsIgnoreCase(other.path));
|
|
}
|
|
|
|
public boolean exists ()
|
|
{
|
|
checkRead();
|
|
return _access (EXISTS);
|
|
}
|
|
|
|
public File (String p)
|
|
{
|
|
path = normalizePath(p);
|
|
}
|
|
|
|
// Remove duplicate and redundant separator characters.
|
|
private String normalizePath(String p)
|
|
{
|
|
// On Windows, convert any '/' to '\'. This appears to be the same logic
|
|
// that Sun's Win32 Java performs.
|
|
if (separatorChar == '\\')
|
|
p = p.replace ('/', '\\');
|
|
|
|
int dupIndex = p.indexOf(dupSeparator);
|
|
int plen = p.length();
|
|
|
|
// Special case: permit Windows UNC path prefix.
|
|
if (dupSeparator.equals("\\\\") && dupIndex == 0)
|
|
dupIndex = p.indexOf(dupSeparator, 1);
|
|
|
|
if (dupIndex == -1)
|
|
{
|
|
// Ignore trailing separator (though on Windows "a:\", for
|
|
// example, is a valid and minimal path).
|
|
if (plen > 1 && p.charAt (plen - 1) == separatorChar)
|
|
{
|
|
if (! (separatorChar == '\\' && plen == 3 && p.charAt (1) == ':'))
|
|
return p.substring (0, plen - 1);
|
|
}
|
|
else
|
|
return p;
|
|
}
|
|
|
|
StringBuffer newpath = new StringBuffer(plen);
|
|
int last = 0;
|
|
while (dupIndex != -1)
|
|
{
|
|
newpath.append(p.substring(last, dupIndex));
|
|
// Ignore the duplicate path characters.
|
|
while (p.charAt(dupIndex) == separatorChar)
|
|
{
|
|
dupIndex++;
|
|
if (dupIndex == plen)
|
|
return newpath.toString();
|
|
}
|
|
newpath.append(separatorChar);
|
|
last = dupIndex;
|
|
dupIndex = p.indexOf(dupSeparator, last);
|
|
}
|
|
|
|
// Again, ignore possible trailing separator (except special cases
|
|
// like "a:\" on Windows).
|
|
int end;
|
|
if (plen > 1 && p.charAt (plen - 1) == separatorChar)
|
|
{
|
|
if (separatorChar == '\\' && plen == 3 && p.charAt (1) == ':')
|
|
end = plen;
|
|
else
|
|
end = plen - 1;
|
|
}
|
|
else
|
|
end = plen;
|
|
newpath.append(p.substring(last, end));
|
|
|
|
return newpath.toString();
|
|
}
|
|
|
|
public File (String dirPath, String name)
|
|
{
|
|
if (name == null)
|
|
throw new NullPointerException ();
|
|
if (dirPath != null && dirPath.length() > 0)
|
|
{
|
|
// Try to be smart about the number of separator characters.
|
|
if (dirPath.charAt(dirPath.length() - 1) == separatorChar
|
|
|| name.length() == 0)
|
|
path = normalizePath(dirPath + name);
|
|
else
|
|
path = normalizePath(dirPath + separatorChar + name);
|
|
}
|
|
else
|
|
path = normalizePath(name);
|
|
}
|
|
|
|
public File (File dir, String name)
|
|
{
|
|
this (dir == null ? null : dir.path, name);
|
|
}
|
|
|
|
public String getAbsolutePath ()
|
|
{
|
|
if (isAbsolute ())
|
|
return path;
|
|
else if (separatorChar == '\\'
|
|
&& path.length () > 0 && path.charAt (0) == '\\')
|
|
{
|
|
// On Windows, even if the path starts with a '\\' it is not
|
|
// really absolute until we prefix the drive specifier from
|
|
// the current working directory to it.
|
|
return System.getProperty ("user.dir").substring (0, 2) + path;
|
|
}
|
|
else
|
|
return System.getProperty ("user.dir") + separatorChar + path;
|
|
}
|
|
|
|
/** @since 1.2 */
|
|
public File getAbsoluteFile ()
|
|
{
|
|
return new File (getAbsolutePath());
|
|
}
|
|
|
|
public native String getCanonicalPath () throws IOException;
|
|
|
|
/** @since 1.2 */
|
|
public File getCanonicalFile () throws IOException
|
|
{
|
|
return new File (getCanonicalPath());
|
|
}
|
|
|
|
public String getName ()
|
|
{
|
|
int last = path.lastIndexOf(separatorChar);
|
|
return path.substring(last + 1);
|
|
}
|
|
|
|
public String getParent ()
|
|
{
|
|
int last = path.lastIndexOf(separatorChar);
|
|
if (last == -1)
|
|
return null;
|
|
// FIXME: POSIX assumption.
|
|
if (last == 0 && path.charAt (0) == '/')
|
|
++last;
|
|
return path.substring(0, last);
|
|
}
|
|
|
|
/** @since 1.2 */
|
|
public File getParentFile ()
|
|
{
|
|
String parent = getParent ();
|
|
return (parent == null ? null : new File (parent));
|
|
}
|
|
|
|
public String getPath ()
|
|
{
|
|
return path;
|
|
}
|
|
|
|
public int hashCode ()
|
|
{
|
|
if (caseSensitive)
|
|
return (path.hashCode() ^ 1234321);
|
|
else
|
|
return (path.toLowerCase().hashCode() ^ 1234321);
|
|
}
|
|
|
|
public native boolean isAbsolute ();
|
|
|
|
public boolean isDirectory ()
|
|
{
|
|
checkRead();
|
|
return _stat (DIRECTORY);
|
|
}
|
|
|
|
public boolean isFile ()
|
|
{
|
|
checkRead();
|
|
return _stat (ISFILE);
|
|
}
|
|
|
|
/** @since 1.2 */
|
|
public boolean isHidden()
|
|
{
|
|
checkRead();
|
|
return _stat (ISHIDDEN);
|
|
}
|
|
|
|
public long lastModified ()
|
|
{
|
|
checkRead();
|
|
return attr (MODIFIED);
|
|
}
|
|
|
|
public long length ()
|
|
{
|
|
checkRead();
|
|
return attr (LENGTH);
|
|
}
|
|
|
|
private final native Object[] performList (FilenameFilter filter,
|
|
FileFilter fileFilter,
|
|
Class result_type);
|
|
|
|
public String[] list (FilenameFilter filter)
|
|
{
|
|
checkRead();
|
|
return (String[]) performList (filter, null, String.class);
|
|
}
|
|
|
|
public String[] list ()
|
|
{
|
|
checkRead();
|
|
return (String[]) performList (null, null, String.class);
|
|
}
|
|
|
|
/** @since 1.2 */
|
|
public File[] listFiles()
|
|
{
|
|
checkRead();
|
|
return (File[]) performList (null, null, File.class);
|
|
}
|
|
|
|
/** @since 1.2 */
|
|
public File[] listFiles(FilenameFilter filter)
|
|
{
|
|
checkRead();
|
|
return (File[]) performList (filter, null, File.class);
|
|
}
|
|
|
|
/** @since 1.2 */
|
|
public File[] listFiles(FileFilter filter)
|
|
{
|
|
checkRead();
|
|
return (File[]) performList (null, filter, File.class);
|
|
}
|
|
|
|
public String toString ()
|
|
{
|
|
return path;
|
|
}
|
|
|
|
public URL toURL () throws MalformedURLException
|
|
{
|
|
// On Win32, Sun's JDK returns URLs of the form "file:/c:/foo/bar.txt",
|
|
// while on UNIX, it returns URLs of the form "file:/foo/bar.txt".
|
|
if (separatorChar == '\\')
|
|
return new URL ("file:/" + getAbsolutePath ().replace ('\\', '/')
|
|
+ (isDirectory() ? "/" : ""));
|
|
else
|
|
return new URL ("file:" + getAbsolutePath ()
|
|
+ (isDirectory() ? "/" : ""));
|
|
}
|
|
|
|
private final native boolean performMkdir ();
|
|
|
|
public boolean mkdir ()
|
|
{
|
|
checkWrite();
|
|
return performMkdir ();
|
|
}
|
|
|
|
private static boolean mkdirs (File x)
|
|
{
|
|
if (x.isDirectory())
|
|
return true;
|
|
String p = x.getPath();
|
|
String parent = x.getParent();
|
|
if (parent != null)
|
|
{
|
|
x.path = parent;
|
|
if (! mkdirs (x))
|
|
return false;
|
|
x.path = p;
|
|
}
|
|
return x.mkdir();
|
|
}
|
|
|
|
public boolean mkdirs ()
|
|
{
|
|
checkWrite();
|
|
if (isDirectory ())
|
|
return false;
|
|
return mkdirs (new File (path));
|
|
}
|
|
|
|
private static synchronized String nextValue ()
|
|
{
|
|
return Long.toString(counter++, Character.MAX_RADIX);
|
|
}
|
|
|
|
/** @since 1.2 */
|
|
public static File createTempFile (String prefix, String suffix,
|
|
File directory)
|
|
throws IOException
|
|
{
|
|
// Grab the system temp directory if necessary
|
|
if (directory == null)
|
|
{
|
|
String dirname = tmpdir;
|
|
if (dirname == null)
|
|
throw
|
|
new IOException("Cannot determine system temporary directory");
|
|
|
|
directory = new File(dirname);
|
|
if (!directory.exists())
|
|
throw new IOException("System temporary directory "
|
|
+ directory.getName() + " does not exist.");
|
|
if (!directory.isDirectory())
|
|
throw new IOException("System temporary directory "
|
|
+ directory.getName()
|
|
+ " is not really a directory.");
|
|
}
|
|
|
|
if (prefix.length () < 3)
|
|
throw new IllegalArgumentException ("Prefix too short: " + prefix);
|
|
if (suffix == null)
|
|
suffix = ".tmp";
|
|
|
|
// Truncation rules.
|
|
// `6' is the number of characters we generate.
|
|
if (prefix.length () + 6 + suffix.length () > maxPathLen)
|
|
{
|
|
int suf_len = 0;
|
|
if (suffix.charAt(0) == '.')
|
|
suf_len = 4;
|
|
suffix = suffix.substring(0, suf_len);
|
|
if (prefix.length () + 6 + suf_len > maxPathLen)
|
|
prefix = prefix.substring(0, maxPathLen - 6 - suf_len);
|
|
}
|
|
|
|
File f;
|
|
|
|
// How many times should we try? We choose 100.
|
|
for (int i = 0; i < 100; ++i)
|
|
{
|
|
// This is ugly.
|
|
String t = "ZZZZZZ" + nextValue ();
|
|
String l = prefix + t.substring(t.length() - 6) + suffix;
|
|
try
|
|
{
|
|
f = new File(directory, l);
|
|
if (f.createNewFile())
|
|
return f;
|
|
}
|
|
catch (IOException ignored)
|
|
{
|
|
}
|
|
}
|
|
|
|
throw new IOException ("cannot create temporary file");
|
|
}
|
|
|
|
private native boolean performSetReadOnly();
|
|
|
|
/** @since 1.2 */
|
|
public boolean setReadOnly()
|
|
{
|
|
checkWrite();
|
|
return performSetReadOnly();
|
|
}
|
|
|
|
private static native File[] performListRoots();
|
|
|
|
/** @since 1.2 */
|
|
public static File[] listRoots()
|
|
{
|
|
File[] roots = performListRoots();
|
|
|
|
SecurityManager s = System.getSecurityManager();
|
|
if (s != null)
|
|
{
|
|
// Only return roots to which the security manager permits read access.
|
|
int count = roots.length;
|
|
for (int i = 0; i < roots.length; i++)
|
|
{
|
|
try
|
|
{
|
|
s.checkRead(roots[i].path);
|
|
}
|
|
catch (SecurityException sx)
|
|
{
|
|
roots[i] = null;
|
|
count--;
|
|
}
|
|
}
|
|
if (count != roots.length)
|
|
{
|
|
File[] newRoots = new File[count];
|
|
int k = 0;
|
|
for (int i=0; i < roots.length; i++)
|
|
{
|
|
if (roots[i] != null)
|
|
newRoots[k++] = roots[i];
|
|
}
|
|
roots = newRoots;
|
|
}
|
|
}
|
|
return roots;
|
|
}
|
|
|
|
public static File createTempFile (String prefix, String suffix)
|
|
throws IOException
|
|
{
|
|
return createTempFile (prefix, suffix, null);
|
|
}
|
|
|
|
/** @since 1.2 */
|
|
public int compareTo(File other)
|
|
{
|
|
if (caseSensitive)
|
|
return path.compareTo (other.path);
|
|
else
|
|
return path.compareToIgnoreCase (other.path);
|
|
}
|
|
|
|
/** @since 1.2 */
|
|
public int compareTo(Object o)
|
|
{
|
|
File other = (File) o;
|
|
return compareTo (other);
|
|
}
|
|
|
|
private native boolean performRenameTo (File dest);
|
|
public boolean renameTo (File dest)
|
|
{
|
|
SecurityManager s = System.getSecurityManager();
|
|
String sname = getName();
|
|
String dname = dest.getName();
|
|
if (s != null)
|
|
{
|
|
s.checkWrite(sname);
|
|
s.checkWrite(dname);
|
|
}
|
|
return performRenameTo (dest);
|
|
}
|
|
|
|
private native boolean performSetLastModified(long time);
|
|
|
|
/** @since 1.2 */
|
|
public boolean setLastModified(long time)
|
|
{
|
|
checkWrite();
|
|
return performSetLastModified(time);
|
|
}
|
|
|
|
public static final String pathSeparator
|
|
= System.getProperty("path.separator");
|
|
public static final char pathSeparatorChar = pathSeparator.charAt(0);
|
|
public static final String separator = System.getProperty("file.separator");
|
|
public static final char separatorChar = separator.charAt(0);
|
|
|
|
static final String tmpdir = System.getProperty("java.io.tmpdir");
|
|
static int maxPathLen;
|
|
static boolean caseSensitive;
|
|
static String dupSeparator = separator + separator;
|
|
|
|
static
|
|
{
|
|
init_native();
|
|
}
|
|
|
|
// Native function called at class initialization. This should should
|
|
// set the maxPathLen and caseSensitive variables.
|
|
private static native void init_native();
|
|
|
|
// The path.
|
|
private String path;
|
|
|
|
// We keep a counter for use by createTempFile. We choose the first
|
|
// value randomly to try to avoid clashes with other VMs.
|
|
private static long counter = Double.doubleToLongBits (Math.random ());
|
|
|
|
private void checkWrite ()
|
|
{
|
|
SecurityManager s = System.getSecurityManager();
|
|
if (s != null)
|
|
s.checkWrite(path);
|
|
}
|
|
|
|
private void checkRead ()
|
|
{
|
|
SecurityManager s = System.getSecurityManager();
|
|
if (s != null)
|
|
s.checkRead(path);
|
|
}
|
|
|
|
/**
|
|
* Add this File to the set of files to be deleted upon normal
|
|
* termination.
|
|
*
|
|
* @since 1.2
|
|
*/
|
|
// FIXME: This should use the ShutdownHook API once we implement that.
|
|
public void deleteOnExit ()
|
|
{
|
|
SecurityManager sm = System.getSecurityManager ();
|
|
if (sm != null)
|
|
sm.checkDelete (getName ());
|
|
|
|
FileDeleter.add (this);
|
|
}
|
|
|
|
private void writeObject (ObjectOutputStream oos) throws IOException
|
|
{
|
|
oos.defaultWriteObject ();
|
|
oos.writeChar (separatorChar);
|
|
}
|
|
|
|
private void readObject (ObjectInputStream ois)
|
|
throws ClassNotFoundException, IOException
|
|
{
|
|
ois.defaultReadObject ();
|
|
|
|
// If the file was from an OS with a different dir separator,
|
|
// fixup the path to use the separator on this OS.
|
|
char oldSeparatorChar = ois.readChar ();
|
|
if (oldSeparatorChar != separatorChar)
|
|
path = path.replace (oldSeparatorChar, separatorChar);
|
|
}
|
|
|
|
// QUERY arguments to access function.
|
|
private final static int READ = 0;
|
|
private final static int WRITE = 1;
|
|
private final static int EXISTS = 2;
|
|
|
|
// QUERY arguments to stat function.
|
|
private final static int DIRECTORY = 0;
|
|
private final static int ISFILE = 1;
|
|
private final static int ISHIDDEN = 2;
|
|
|
|
// QUERY arguments to attr function.
|
|
private final static int MODIFIED = 0;
|
|
private final static int LENGTH = 1;
|
|
|
|
private final native long attr (int query);
|
|
// On OSF1 V5.0, `stat' is a macro. It is easiest to use the name
|
|
// `_stat' instead. We do the same thing for `_access' just in
|
|
// case.
|
|
private final native boolean _access (int query);
|
|
private final native boolean _stat (int query);
|
|
|
|
private static final long serialVersionUID = 301077366599181567L;
|
|
}
|