Package org.apache.commons.io

Class FileDeleteStrategy

  • public class FileDeleteStrategy
extends java.lang.Object
    Strategy for deleting files.

    There is more than one way to delete a file. You may want to limit access to certain directories, to only delete directories if they are empty, or maybe to force deletion.

    This class captures the strategy to use and is designed for user subclassing.

    Since:
    1.3

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static FileDeleteStrategy FORCE
      The singleton instance for forced file deletion, which always deletes, even if the file represents a non-empty directory.
      static FileDeleteStrategy NORMAL
      The singleton instance for normal file deletion, which does not permit the deletion of directories that are not empty.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void delete​(java.io.File fileToDelete)
      Deletes the file object, which may be a file or a directory.
      boolean deleteQuietly​(java.io.File fileToDelete)
      Deletes the file object, which may be a file or a directory.
      java.lang.String toString()
      Gets a string describing the delete strategy.

      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

    • Field Detail

      • NORMAL

        public static final FileDeleteStrategy NORMAL
        The singleton instance for normal file deletion, which does not permit the deletion of directories that are not empty.

      • FORCE

        public static final FileDeleteStrategy FORCE
        The singleton instance for forced file deletion, which always deletes, even if the file represents a non-empty directory.

    • Method Detail

      • delete

        public void delete​(java.io.File fileToDelete)
            throws java.io.IOException
        Deletes the file object, which may be a file or a directory. If the file does not exist, the method just returns.

        Subclass writers should override doDelete(File), not this method.

        Parameters:
        fileToDelete - the file to delete, not null
        Throws:
        java.lang.NullPointerException - if the file is null
        java.io.IOException - if an error occurs during file deletion

      • deleteQuietly

        public boolean deleteQuietly​(java.io.File fileToDelete)
        Deletes the file object, which may be a file or a directory. All IOExceptions are caught and false returned instead. If the file does not exist or is null, true is returned.

        Subclass writers should override doDelete(File), not this method.

        Parameters:
        fileToDelete - the file to delete, null returns true
        Returns:
        true if the file was deleted, or there was no such file

      • toString

        public java.lang.String toString()
        Gets a string describing the delete strategy.
        Overrides:
        toString in class java.lang.Object
        Returns:
        a string describing the delete strategy