Package rife.bld.extension.tools

Class IOTools

java.lang.Object
rife.bld.extension.tools.IOTools
public final class IOTools extends Object
I/O Tools.

Utility methods for common file system operations including existence checks, executability checks, directory creation, and path resolution. All methods accept null inputs and return false (or an appropriate default) rather than throwing NullPointerException.

Since:
1.0

  • Method Summary

    Modifier and Type
    Method
    Description
    static boolean
    canExecute(File file)
    Determines if the specified file exists, is a file, and is executable.
    static boolean
    canExecute(String path)
    Determines if the file at the specified path string exists, is a regular file, and is executable.
    static boolean
    canExecute(Path path)
    Determines if the specified path exists, is a regular file, and is executable.
    static boolean
    exists(File file)
    Checks if the specified file exists.
    static boolean
    exists(String path)
    Checks whether a file or directory exists at the specified path.
    static boolean
    exists(Path path)
    Checks if the specified path exists.
    static boolean
    isDirectory(File file)
    Determines if the specified File is a directory.
    static boolean
    isDirectory(String path)
    Determines if the specified path string represents an existing directory.
    static boolean
    isDirectory(Path path)
    Determines if the specified Path represents an existing directory.
    static boolean
    mkdirs(File file)
    Creates the directory named by the specified File, including any necessary but nonexistent parent directories.
    static boolean
    mkdirs(String path)
    Creates the directory specified by the given path string, including any nonexistent parent directories as necessary.
    static boolean
    mkdirs(Path path)
    Creates the directory specified by the given Path, including any nonexistent parent directories as necessary.
    static boolean
    notExists(File file)
    Checks if the specified file does not exist.
    static boolean
    notExists(String path)
    Checks whether a file or directory does not exist at the specified path.
    static boolean
    notExists(Path path)
    Checks if the specified path does not exist.
    static File
    resolveFile(File base, String... segments)
    Resolves a file path by joining a base file with additional path segments.

    Methods inherited from class java.lang.Object

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

  • Method Details

    • canExecute

      public static boolean canExecute(File file)
      Determines if the specified file exists, is a file, and is executable.
      Parameters:
      file - the file to be checked
      Returns:
      true if the file exists, is a file, and can be executed; false otherwise
      Since:
      1.0

    • canExecute

      public static boolean canExecute(Path path)
      Determines if the specified path exists, is a regular file, and is executable.
      Parameters:
      path - the path to be checked
      Returns:
      true if the path exists, is a regular file, and can be executed; false otherwise
      Since:
      1.0

    • canExecute

      public static boolean canExecute(String path)
      Determines if the file at the specified path string exists, is a regular file, and is executable.
      Parameters:
      path - the path string to be checked
      Returns:
      true if the path exists, is a regular file, and can be executed; false otherwise
      Since:
      1.0

    • exists

      public static boolean exists(File file)
      Checks if the specified file exists.
      Parameters:
      file - the file to check for existence
      Returns:
      true if the file is not null and exists; false otherwise
      Since:
      1.0

    • exists

      public static boolean exists(Path path)
      Checks if the specified path exists.
      Parameters:
      path - the path to check for existence
      Returns:
      true if the path is not null and exists; false otherwise
      Since:
      1.0

    • exists

      public static boolean exists(String path)
      Checks whether a file or directory exists at the specified path.
      Parameters:
      path - the file system path to check for existence
      Returns:
      true if the path is not null and a file or directory exists at the specified path; false otherwise
      Since:
      1.0

    • isDirectory

      public static boolean isDirectory(File file)
      Determines if the specified File is a directory.
      Parameters:
      file - the File object to be checked; if null, returns false
      Returns:
      true if the file exists and is a directory; false otherwise
      Since:
      1.0

    • isDirectory

      public static boolean isDirectory(Path path)
      Determines if the specified Path represents an existing directory.
      Parameters:
      path - the Path object to be checked; if null, returns false
      Returns:
      true if the path exists and is a directory; false otherwise
      Since:
      1.0

    • isDirectory

      public static boolean isDirectory(String path)
      Determines if the specified path string represents an existing directory.
      Parameters:
      path - the path string to be checked; if null or blank, returns false
      Returns:
      true if the specified path exists and is a directory; false otherwise (including when the path string is invalid)
      Since:
      1.0

    • mkdirs

      public static boolean mkdirs(File file)
      Creates the directory named by the specified File, including any necessary but nonexistent parent directories.

      Delegates to mkdirs(Path) for consistent, race-condition-free behavior.

      Parameters:
      file - the File object representing the directory to be created; if null, this method returns false
      Returns:
      true if the directory was created successfully or already exists; false if the directory could not be created or file is null
      Since:
      1.0

    • mkdirs

      public static boolean mkdirs(Path path)
      Creates the directory specified by the given Path, including any nonexistent parent directories as necessary.
      Parameters:
      path - the Path object representing the directory to be created; if null, this method returns false
      Returns:
      true if the directory was created successfully or already exists; false if the directory could not be created or path is null
      Since:
      1.0

    • mkdirs

      public static boolean mkdirs(String path)
      Creates the directory specified by the given path string, including any nonexistent parent directories as necessary.
      Parameters:
      path - the path string representing the directory to be created; if null or blank, this method returns false
      Returns:
      true if the directory was created successfully or already exists; false if the directory could not be created or path is null or blank
      Since:
      1.0

    • notExists

      public static boolean notExists(File file)
      Checks if the specified file does not exist.
      Parameters:
      file - the file to check for non-existence
      Returns:
      true if the file is null or does not exist; false otherwise
      Since:
      1.0

    • notExists

      public static boolean notExists(Path path)
      Checks if the specified path does not exist.
      Parameters:
      path - the path to check for non-existence
      Returns:
      true if the path is null or does not exist; false otherwise
      Since:
      1.0

    • notExists

      public static boolean notExists(String path)
      Checks whether a file or directory does not exist at the specified path.
      Parameters:
      path - the file system path to check for non-existence
      Returns:
      true if the path is null or no file or directory exists at the specified path; false otherwise
      Since:
      1.0

    • resolveFile

      public static File resolveFile(File base, String... segments)
      Resolves a file path by joining a base file with additional path segments.

      This method constructs a file path by appending one or more path segments to a base file. null segments are silently skipped. The resulting File object represents the complete path but does not create an actual file on the filesystem.

      Parameters:
      base - the base file path to start from; may be null
      segments - additional path segments to append, in order; may be null, and individual null segments are silently skipped
      Returns:
      a File representing the resolved path
      Since:
      1.0