Uploaded image for project: 'Hadoop Common'
  1. Hadoop Common
  2. HADOOP-6537

Proposal for exceptions thrown by FileContext and Abstract File System

    XMLWordPrintableJSON

Details

    • Improvement
    • Status: Closed
    • Major
    • Resolution: Fixed
    • None
    • 0.21.0
    • None
    • None
    • Detailed exceptions declared in FileContext and AbstractFileSystem

    Description

      Currently the APIs in FileContext throw only IOException. Going forward these APIs will throw more specific exceptions.
      This jira proposes following hierarchy of exceptions to be thrown by FileContext and AFS (Abstract File System) classes.

      InterruptedException (java.lang.InterruptedException)

      IOException
      /* Following exceptions extend IOException */
      FileNotFoundException
      FileAlreadyExistsException
      DirectoryNotEmptyException
      NotDirectoryException
      AccessDeniedException
      IsDirectoryException
      InvalidPathNameException

      FileSystemException
      /* Following exceptions extend FileSystemException */
      FileSystemNotReadyException
      ReadOnlyFileSystemException
      QuotaExceededException
      OutOfSpaceException

      RemoteException (java.rmi.RemoteException)

      Most of the IOExceptions above are caused by invalid user input, while FileSystemException is thrown when FS is in such a state that the requested operation cannot proceed.
      Please note that the proposed RemoteException is from standard java rmi package, which also extends IOException.

      HDFS throws many exceptions which are not in the above list. The DFSClient will unwrap the exceptions thrown by HDFS, and any exception not in the above list will be thrown as IOException or FileSystemException.

      Attachments

        1. hdfs-717.patch
          74 kB
          Suresh Srinivas
        2. hdfs-717.patch
          77 kB
          Suresh Srinivas
        3. hdfs-717.1.patch
          64 kB
          Suresh Srinivas
        4. hdfs-717.2.patch
          7 kB
          Suresh Srinivas
        5. hdfs-717.3.patch
          99 kB
          Suresh Srinivas
        6. hdfs-717.4.patch
          104 kB
          Suresh Srinivas

        Issue Links

          blocks

          Test - A new unit, integration or system test. HADOOP-6595 Add FileContext API tests for checking exceptions

          • Major - Major loss of function.
          • Open
          is duplicated by

          Improvement - An improvement or enhancement to an existing feature or task. HADOOP-6361 Specific Exceptions thrown by FileContext and AbstractFileSystem

          • Major - Major loss of function.
          • Resolved
          is related to

          New Feature - A new feature of the product, which has yet to be developed. HDFS-1079 HDFS implementation should throw exceptions defined in AbstractFileSystem

          • Major - Major loss of function.
          • Closed
          relates to

          Bug - A problem which impairs or prevents the functions of the product. HDFS-1151 HDFS should throw HadoopIllegalArgumentException instead of IllegalArgumentException

          • Major - Major loss of function.
          • Open

          Activity

            People

              sureshms Suresh Srinivas
              jnp Jitendra Nath Pandey
              Votes:
              0 Vote for this issue
              Watchers:
              13 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: