hadoop-hdfs-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Jitendra Nath Pandey (JIRA)" <j...@apache.org>
Subject [jira] Created: (HDFS-717) Proposal for exceptions thrown by FileContext and Abstract File System
Date Mon, 19 Oct 2009 21:18:59 GMT
Proposal for exceptions thrown by FileContext and Abstract File System
----------------------------------------------------------------------

                 Key: HDFS-717
                 URL: https://issues.apache.org/jira/browse/HDFS-717
             Project: Hadoop HDFS
          Issue Type: Improvement
            Reporter: Jitendra Nath Pandey
            Assignee: Jitendra Nath Pandey
             Fix For: 0.22.0


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.


-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


Mime
View raw message