2005-01-31 Zoltan Varga <vargaz@freemail.hu>
[mono.git] / mcs / class / corlib / System.IO / File.cs
index 78a01267d9cdb5eb9ce4adf189a37aa921f1e17e..891a024ad1ea73e10b09977551a50849513a9174 100644 (file)
-//------------------------------------------------------------------------------\r
-// \r
-// System.IO.File.cs \r
-//\r
-// Copyright (C) 2001 Moonlight Enterprises, All Rights Reserved\r
-// \r
-// Author:         Jim Richardson, develop@wtfo-guru.com\r
-// Created:        Monday, August 22, 2001 \r
+// 
+// System.IO.FIle.cs 
 //
-// TODO: Research exceptions for all methods\r
-//------------------------------------------------------------------------------\r
-\r
-using System;\r
-\r
-namespace System.IO\r
-{\r
-       /// <summary>\r
-       /// \r
-       /// </summary>\r
-       public sealed class File : Object\r
-       { 
-               /// <summary>
-               /// Creates a StreamWriter that appends text to a file creating the file if needed
-               /// </summary>
-               public static StreamWriter AppendText(string path)
-               {       // TODO: Implement
-                       return null;
-               }
-                
-               /// <summary>
-               /// Copies a file overwriting existing if necessary
-               /// </summary>
-               public static void Copy(string sourceFilename, string destFilename)
-               {
-                       Copy(sourceFilename, destFilename, true);
-               }
-                
-               /// <summary>
-               /// Copies a file overwriting existing if specified
-               /// </summary>
-               public static void Copy(string sourceFilename, string destFilename, bool bOverwrite)
-               {       // TODO: Implement
-               }
-\r
-               /// <summary>\r
-               /// Creates a file given the fully qualified path\r
-               /// </summary>\r
-               public static FileStream Create(string path)\r
-               {       // TODO: Research default buffersize\r
-                       return Create(path, 1024);\r
-               }
-
-               /// <summary>
-               /// Creates a file given the fully qualified path using specified buffersize
-               /// </summary>
-               public static FileStream Create(string path, int buffersize)
-               {       // TODO: Implement
-                       return null;
-               }
-               \r
-               /// <summary>\r
-               /// Delete a file\r
-               /// </summary>\r
-               public static void Delete(string path)\r
-               {       // TODO: Implement\r
+// 
+// Authors:
+//   Miguel de Icaza (miguel@ximian.com)
+//   Jim Richardson  (develop@wtfo-guru.com)
+//   Dan Lewis       (dihlewis@yahoo.co.uk)
+//   Ville Palo      (vi64pa@kolumbus.fi)
+//
+// Copyright 2002 Ximian, Inc. http://www.ximian.com
+// Copyright (C) 2001 Moonlight Enterprises, All Rights Reserved
+//
+
+//
+// Copyright (C) 2004 Novell, Inc (http://www.novell.com)
+//
+// Permission is hereby granted, free of charge, to any person obtaining
+// a copy of this software and associated documentation files (the
+// "Software"), to deal in the Software without restriction, including
+// without limitation the rights to use, copy, modify, merge, publish,
+// distribute, sublicense, and/or sell copies of the Software, and to
+// permit persons to whom the Software is furnished to do so, subject to
+// the following conditions:
+// 
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// 
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+//
+
+using System;
+
+namespace System.IO
+{
+       /// <summary>
+       /// 
+       /// </summary>
+       public
+#if NET_2_0
+       static
+#else
+       sealed
+#endif
+       class File
+       {
+
+#if !NET_2_0
+               private File () {}
+#endif
+               
+               public static StreamWriter AppendText (string path)
+               {       
+                       return new StreamWriter (path, true);
+               }
+
+               [MonoTODO("Security Permision Checks")]
+               public static void Copy (string sourceFilename, string destFilename)
+               {
+                       Copy (sourceFilename, destFilename, false);
+               }
+
+               public static void Copy (string src, string dest, bool overwrite)
+               {       
+                       if (src == null)
+                               throw new ArgumentNullException ("src");
+                       if (dest == null)
+                               throw new ArgumentNullException ("dest");
+                       if (src.Trim () == "" || src.IndexOfAny (Path.InvalidPathChars) != -1)
+                               throw new ArgumentException (Locale.GetText ("src is null"));
+                       if (dest.Trim () == "" || dest.IndexOfAny (Path.InvalidPathChars) != -1)
+                               throw new ArgumentException (Locale.GetText ("dest is empty or contains invalid characters"));
+                       if (!Exists (src))
+                               throw new FileNotFoundException (Locale.GetText ("{0} does not exist", src), src);
+
+                       if ((GetAttributes(src) & FileAttributes.Directory) == FileAttributes.Directory){
+                               throw new ArgumentException(Locale.GetText ("{0} is a directory", src));
+                       }
+                       
+                       if (Exists (dest)) {
+                               if ((GetAttributes(dest) & FileAttributes.Directory) == FileAttributes.Directory){
+                                       throw new ArgumentException (Locale.GetText ("{0} is a directory", dest));
+                               }
+                               if (!overwrite)
+                                       throw new IOException (Locale.GetText ("{0} already exists", dest));
+                       }
+
+                       string DirName = Path.GetDirectoryName(dest);
+                       if (DirName != String.Empty && !Directory.Exists (DirName))
+                               throw new DirectoryNotFoundException (Locale.GetText ("Destination directory not found: {0}",DirName));
+
+                       MonoIOError error;
+                       
+                       if (!MonoIO.CopyFile (src, dest, overwrite, out error)){
+                               string p = Locale.GetText ("{0}\" or \"{1}", src, dest);
+                               throw MonoIO.GetException (p, error);
+                       }
+               }
+
+               public static FileStream Create (string path)
+               {
+                       return Create (path, 8192);
+               }
+
+               public static FileStream Create (string path, int buffersize)
+               {
+                       if (null == path)
+                               throw new ArgumentNullException ("path");
+                       if (String.Empty == path.Trim() || path.IndexOfAny(Path.InvalidPathChars) >= 0)
+                               throw new ArgumentException (Locale.GetText ("path is invalid"));
+
+                       string DirName = Path.GetDirectoryName(path);
+                       if (DirName != String.Empty && !Directory.Exists (DirName))
+                               throw new DirectoryNotFoundException (Locale.GetText ("Destination directory not found: {0}", DirName));
+                       if (Exists(path)){
+                               if ((GetAttributes(path) & FileAttributes.ReadOnly) == FileAttributes.ReadOnly){
+                                       throw new UnauthorizedAccessException (Locale.GetText ("{0} is read-only", path));
+                               }
+                       }
+
+                       return new FileStream (path, FileMode.Create, FileAccess.ReadWrite,
+                                              FileShare.None, buffersize);
                }
+
+               public static StreamWriter CreateText(string path)
+               
+               {
+                       return new StreamWriter (path, false);
                
-               /// <summary>\r
-               /// Returns true if file exists on disk\r
-               /// </summary>\r
-               public static bool Exists(string path)\r
-               {       // TODO: Implement\r
-                       return false;\r
-               }
-               \r
-               /// <summary>\r
-               /// Returns the date and time the file specified by path was created\r
-               /// </summary>\r
-               public static FileAttributes GetAttributes(string path)\r
-               {\r
-                       FileInfo fInfo = new FileInfo(path);
-                       return fInfo.Attributes;\r
-               }\r
-\r
-               /// <summary>\r
-               /// Returns the date and time the directory specified by path was created\r
-               /// </summary>\r
-               public static DateTime GetCreationTime(string path)\r
-               {
-                       return getInfo(path).CreationTime;\r
-               }\r
-
-               /// <summary>\r
-               /// Returns the date and time the directory specified by path was last accessed\r
-               /// </summary>\r
-               public static DateTime GetLastAccessTime(string path)\r
-               {
-                       return getInfo(path).LastAccessTime;\r
-               }\r
-
-               /// <summary>\r
-               /// Returns the date and time the directory specified by path was last modified\r
-               /// </summary>\r
-               public static DateTime GetLastWriteTime(string path)\r
-               {\r
-                       return getInfo(path).LastWriteTime;\r
-               }\r
-               \r
-               /// <summary>\r
-               /// Moves a file\r
-               /// </summary>\r
-               public static void Move(string srcFilename, string destFilename)\r
-               {
-                       getInfo(srcFilename).MoveTo(destFilename);
                }
                
-               /// <summary>
-               /// Open a file for exclusive reading and writing
-               /// </summary>
-               public static FileStream Open(string path, FileMode mode)
-               {       // TODO: research if exclusive is the correct default
-                       return getInfo(path).Open(mode, FileAccess.ReadWrite);
+               
+               
+               public static void Delete (string path)
+               {
+                       if (null == path)
+                               throw new ArgumentNullException("path");
+                       if (String.Empty == path.Trim() || path.IndexOfAny(Path.InvalidPathChars) >= 0)
+                               throw new ArgumentException("path");
+                       if (Directory.Exists (path))
+                               throw new UnauthorizedAccessException(Locale.GetText ("{0} is a directory", path));
+
+                       string DirName = Path.GetDirectoryName(path);
+                       if (DirName != String.Empty && !Directory.Exists (DirName))
+                               throw new DirectoryNotFoundException (Locale.GetText ("Destination directory not found: {0}", DirName));
+
+                       MonoIOError error;
+                       
+                       if (!MonoIO.DeleteFile (path, out error)){
+                               Exception e = MonoIO.GetException (path, error);
+                               if (! (e is FileNotFoundException))
+                                       throw e;
+                       }
+               }
+
+               public static bool Exists (string path)
+               {
+                       // For security reasons no exceptions are
+                       // thrown, only false is returned if there is
+                       // any problem with the path or permissions.
+                       // Minimizes what information can be
+                       // discovered by using this method.
+                       if (null == path || String.Empty == path.Trim()
+                           || path.IndexOfAny(Path.InvalidPathChars) >= 0) {
+                               return false;
+                       }
+
+                       MonoIOError error;
+                       bool exists;
+                       
+                       exists = MonoIO.ExistsFile (path, out error);
+                       if (error != MonoIOError.ERROR_SUCCESS &&
+                           error != MonoIOError.ERROR_FILE_NOT_FOUND &&
+                           error != MonoIOError.ERROR_PATH_NOT_FOUND) {
+                               throw MonoIO.GetException (path, error);
+                       }
+                       
+                       return(exists);
+               }
+
+               public static FileAttributes GetAttributes (string path)
+               {
+                       if (null == path) {
+                               throw new ArgumentNullException("path");
+                       }
+                       
+                       if (String.Empty == path.Trim()) {
+                               throw new ArgumentException (Locale.GetText ("Path is empty"));
+                       }
+
+                       if (path.IndexOfAny(Path.InvalidPathChars) >= 0) {
+                               throw new ArgumentException(Locale.GetText ("Path contains invalid chars"));
+                       }
+
+                       MonoIOError error;
+                       FileAttributes attrs;
+                       
+                       attrs = MonoIO.GetFileAttributes (path, out error);
+                       if (error != MonoIOError.ERROR_SUCCESS) {
+                               throw MonoIO.GetException (path, error);
+                       }
+
+                       return(attrs);
+               }
+
+               public static DateTime GetCreationTime (string path)
+               {
+                       MonoIOStat stat;
+                       MonoIOError error;
+                       CheckPathExceptions (path);
+                       
+                       if (!MonoIO.GetFileStat (path, out stat, out error))
+                               throw new IOException (path);
+                       return DateTime.FromFileTime (stat.CreationTime);
+               }
+
+               public static DateTime GetCreationTimeUtc (string path)
+               {
+                       return GetCreationTime (path).ToUniversalTime ();
+               }
+
+               public static DateTime GetLastAccessTime (string path)
+               {
+                       MonoIOStat stat;
+                       MonoIOError error;
+                       CheckPathExceptions (path);
+
+                       if (!MonoIO.GetFileStat (path, out stat, out error))
+                               throw new IOException (path);
+                       return DateTime.FromFileTime (stat.LastAccessTime);
+               }
+
+               public static DateTime GetLastAccessTimeUtc (string path)
+               {
+                       return GetLastAccessTime (path).ToUniversalTime ();
+               }
+
+               public static DateTime GetLastWriteTime (string path)
+               {
+                       MonoIOStat stat;
+                       MonoIOError error;
+                       CheckPathExceptions (path);
+
+                       if (!MonoIO.GetFileStat (path, out stat, out error))
+                               throw new IOException (path);
+                       return DateTime.FromFileTime (stat.LastWriteTime);
+               }
+
+               public static DateTime GetLastWriteTimeUtc (string path)
+               {
+                       return GetLastWriteTime (path).ToUniversalTime ();
+               }
+
+               public static void Move (string src, string dest)
+               {
+                       MonoIOError error;
+
+                       if (src == null)
+                               throw new ArgumentNullException ("src");
+                       if (dest == null)
+                               throw new ArgumentNullException ("dest");
+                       if (src.Trim () == "" || src.IndexOfAny (Path.InvalidPathChars) != -1)
+                               throw new ArgumentException ("src");
+                       if (dest.Trim () == "" || dest.IndexOfAny (Path.InvalidPathChars) != -1)
+                               throw new ArgumentException ("dest");
+                       if (!MonoIO.Exists (src, out error))
+                               throw new FileNotFoundException (Locale.GetText ("{0} does not exist", src), src);
+                       if (MonoIO.ExistsDirectory (dest, out error))
+                                       throw new IOException (Locale.GetText ("{0} is a directory", dest));    
+
+                       // Don't check for this error here to allow the runtime to check if src and dest
+                       // are equal. Comparing src and dest is not enough.
+                       //if (MonoIO.Exists (dest, out error))
+                       //      throw new IOException (Locale.GetText ("{0} already exists", dest));
+
+                       string DirName;
+                       DirName = Path.GetDirectoryName(src);
+                       if (DirName != String.Empty && !Directory.Exists (DirName))
+                               throw new DirectoryNotFoundException(Locale.GetText ("Source directory not found: {0}", DirName));
+                       DirName = Path.GetDirectoryName(dest);
+                       if (DirName != String.Empty && !Directory.Exists (DirName))
+                               throw new DirectoryNotFoundException(Locale.GetText ("Destination directory not found: {0}", DirName));
+
+                       if (!MonoIO.MoveFile (src, dest, out error)) {
+                               if (error == MonoIOError.ERROR_ALREADY_EXISTS)
+                                       throw MonoIO.GetException (dest, error);
+                               throw MonoIO.GetException (error);
+                       }
                }
                
-               /// <summary>
-               /// Open a file for exclusive access specified by mode
-               /// </summary>
-               public static FileStream Open(string path, FileMode mode, FileAccess access)
-               {       // TODO: research if exclusive is the correct default
-                       return getInfo(path).Open(mode, access, FileShare.None);
+               public static FileStream Open (string path, FileMode mode)
+               {       
+                       return new FileStream (path, mode, FileAccess.ReadWrite, FileShare.None);
                }
                
-               /// <summary>
-               /// Open a file access specified by mode, sharing specified by share
-               /// </summary>
-               public static FileStream Open(string path, FileMode mode, FileAccess access, FileShare share)
+               public static FileStream Open (string path, FileMode mode, FileAccess access)
+               {       
+                       return new FileStream (path, mode, access, FileShare.None);
+               }
+
+               public static FileStream Open (string path, FileMode mode, FileAccess access,
+                                              FileShare share)
                {
-                       return getInfo(path).Open(mode, access, share);
+                       return new FileStream (path, mode, access, share);
                }
                
-               /// <summary>
-               /// Open a FileStream for reading and writing
-               /// </summary>
-               public static FileStream OpenRead(string path)
-               {       // TODO: find out what default share should be
-                       return getInfo(path).OpenRead();
+               public static FileStream OpenRead (string path)
+               {       
+                       return new FileStream (path, FileMode.Open, FileAccess.Read, FileShare.Read);
                }
-               
-               /// <summary>
-               /// Open a StreamReader
-               /// </summary>
-               public static StreamReader OpenText(string path)
+
+               public static StreamReader OpenText (string path)
                {
-                       return getInfo(path).OpenText();
+                       return new StreamReader (path);
                }
 
-               /// <summary>
-               /// Open a FileStream for reading and writing
-               /// </summary>
-               public FileStream OpenWrite(string path)
+               public static FileStream OpenWrite (string path)
                {
-                       return getInfo(path).OpenWrite();
+                       return new FileStream(path, FileMode.OpenOrCreate, FileAccess.Write, FileShare.None);
                }
-               
-               /// <summary>
-               /// Sets the attributes of file specified by path
-               /// </summary>
-               public static void SetAttributes(string path, FileAttributes attributes)
+
+               public static void SetAttributes (string path,
+                                                 FileAttributes attributes)
                {
-                       getInfo(path).Attributes = attributes;
+                       MonoIOError error;
+                       CheckPathExceptions (path);
+                       
+                       if (!MonoIO.SetFileAttributes (path, attributes,
+                                                      out error)) {
+                               throw MonoIO.GetException (path, error);
+                       }
                }
-               \r
-               /// <summary>\r
-               /// Sets the creation time of the directory specified by path\r
-               /// </summary>\r
-               public static void SetCreationTime(string path, DateTime creationTime)\r
+
+               public static void SetCreationTime (string path,
+                                                   DateTime creation_time)
                {
-                       getInfo(path).CreationTime = creationTime;\r
-               }\r
-\r
-               /// <summary>\r
-               /// Sets the last access time of the directory specified by path\r
-               /// </summary>\r
-               public static void SetLastAccessTime(string path, DateTime accessTime)\r
+                       MonoIOError error;
+                       CheckPathExceptions (path);
+                       if (!MonoIO.Exists (path, out error))
+                               throw MonoIO.GetException (path, error);
+                       
+                       if (!MonoIO.SetCreationTime (path, creation_time, out error)) {
+                               throw MonoIO.GetException (path, error);
+                       }
+               }
+
+               public static void SetCreationTimeUtc (string path,
+                                                   DateTime creation_time)
                {
-                       getInfo(path).LastAccessTime = accessTime;\r
+                       SetCreationTime (path, creation_time.ToLocalTime ());
                }
-               \r
-               /// <summary>\r
-               /// Sets the last write time of the directory specified by path\r
-               /// </summary>\r
-               public static void SetLastWriteTime(string path, DateTime modifiedTime)\r
+
+               public static void SetLastAccessTime (string path,DateTime last_access_time)
                {
-                       getInfo(path).LastWriteTime = modifiedTime;\r
+                       MonoIOError error;
+                       CheckPathExceptions (path);
+                       if (!MonoIO.Exists (path, out error))
+                               throw MonoIO.GetException (path, error);
+
+                       if (!MonoIO.SetLastAccessTime (path, last_access_time, out error)) {
+                               throw MonoIO.GetException (path, error);
+                       }
                }
-               
-               private static FileInfo getInfo(string path)
+
+               public static void SetLastAccessTimeUtc (string path,DateTime last_access_time)
                {
-                       return new FileInfo(path);
+                       SetLastAccessTime (path, last_access_time.ToLocalTime ());
                }
-       }\r
-}\r
+
+               public static void SetLastWriteTime (string path,
+                                                    DateTime last_write_time)
+               {
+                       MonoIOError error;
+                       CheckPathExceptions (path);
+                       if (!MonoIO.Exists (path, out error))
+                               throw MonoIO.GetException (path, error);
+
+                       if (!MonoIO.SetLastWriteTime (path, last_write_time, out error)) {
+                               throw MonoIO.GetException (path, error);
+                       }
+               }
+
+               public static void SetLastWriteTimeUtc (string path,
+                                                    DateTime last_write_time)
+               {
+                       SetLastWriteTime (path, last_write_time.ToLocalTime ());
+               }
+
+               #region Private
+
+               private static void CheckPathExceptions (string path)
+               {
+                       if (path == null)
+                               throw new System.ArgumentNullException("path");
+                       if (path == "")
+                               throw new System.ArgumentException(Locale.GetText ("Path is empty"));
+                       if (path.Trim().Length == 0)
+                               throw new ArgumentException (Locale.GetText ("Path is empty"));
+                       if (path.IndexOfAny (Path.InvalidPathChars) != -1)
+                               throw new ArgumentException (Locale.GetText ("Path contains invalid chars"));
+               }
+
+               #endregion
+       }
+}