Apache
/
hadoop
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

HDFS-8730. Clean up the import statements in ClientProtocol. Contributed by Takanobu Asanuma.

This commit is contained in:
Haohui Mai 2015-07-23 10:30:17 -07:00
parent adfa34ff99
commit 813cf89bb5
2 changed files with 182 additions and 127 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

306
hadoop-hdfs-project/hadoop-hdfs-client/src/main/java/org/apache/hadoop/hdfs/protocol/ClientProtocol.java
View File

@ -17,7 +17,6 @@
*/ */
package org.apache.hadoop.hdfs.protocol; package org.apache.hadoop.hdfs.protocol;
import java.io.FileNotFoundException;
import java.io.IOException; import java.io.IOException;
import java.util.EnumSet; import java.util.EnumSet;
import java.util.List; import java.util.List;
@ -29,14 +28,9 @@ import org.apache.hadoop.fs.BatchedRemoteIterator.BatchedEntries;
import org.apache.hadoop.fs.CacheFlag; import org.apache.hadoop.fs.CacheFlag;
import org.apache.hadoop.fs.ContentSummary; import org.apache.hadoop.fs.ContentSummary;
import org.apache.hadoop.fs.CreateFlag; import org.apache.hadoop.fs.CreateFlag;
import org.apache.hadoop.fs.FileAlreadyExistsException;
import org.apache.hadoop.fs.FsServerDefaults; import org.apache.hadoop.fs.FsServerDefaults;
import org.apache.hadoop.fs.InvalidPathException;
import org.apache.hadoop.fs.Options; import org.apache.hadoop.fs.Options;
import org.apache.hadoop.fs.Options.Rename;
import org.apache.hadoop.fs.ParentNotDirectoryException;
import org.apache.hadoop.fs.StorageType; import org.apache.hadoop.fs.StorageType;
import org.apache.hadoop.fs.UnresolvedLinkException;
import org.apache.hadoop.fs.XAttr; import org.apache.hadoop.fs.XAttr;
import org.apache.hadoop.fs.XAttrSetFlag; import org.apache.hadoop.fs.XAttrSetFlag;
import org.apache.hadoop.fs.permission.AclEntry; import org.apache.hadoop.fs.permission.AclEntry;
@ -48,14 +42,11 @@ import org.apache.hadoop.hdfs.protocol.HdfsConstants.RollingUpgradeAction;
import org.apache.hadoop.hdfs.security.token.block.DataEncryptionKey; import org.apache.hadoop.hdfs.security.token.block.DataEncryptionKey;
import org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenIdentifier; import org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenIdentifier;
import org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenSelector; import org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenSelector;
import org.apache.hadoop.hdfs.server.namenode.NotReplicatedYetException;
import org.apache.hadoop.hdfs.server.namenode.SafeModeException;
import org.apache.hadoop.hdfs.server.protocol.DatanodeStorageReport; import org.apache.hadoop.hdfs.server.protocol.DatanodeStorageReport;
import org.apache.hadoop.io.EnumSetWritable; import org.apache.hadoop.io.EnumSetWritable;
import org.apache.hadoop.io.Text; import org.apache.hadoop.io.Text;
import org.apache.hadoop.io.retry.AtMostOnce; import org.apache.hadoop.io.retry.AtMostOnce;
import org.apache.hadoop.io.retry.Idempotent; import org.apache.hadoop.io.retry.Idempotent;
import org.apache.hadoop.security.AccessControlException;
import org.apache.hadoop.security.KerberosInfo; import org.apache.hadoop.security.KerberosInfo;
import org.apache.hadoop.security.token.Token; import org.apache.hadoop.security.token.Token;
import org.apache.hadoop.security.token.TokenInfo; import org.apache.hadoop.security.token.TokenInfo;
@ -121,9 +112,12 @@ public interface ClientProtocol {
* *
* @return file length and array of blocks with their locations * @return file length and array of blocks with their locations
* *
* @throws AccessControlException If access is denied * @throws org.apache.hadoop.security.AccessControlException If access is
* @throws FileNotFoundException If file <code>src</code> does not exist * denied
* @throws UnresolvedLinkException If <code>src</code> contains a symlink * @throws java.io.FileNotFoundException If file <code>src</code> does not
* exist
* @throws org.apache.hadoop.fs.UnresolvedLinkException If <code>src</code>
* contains a symlink
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@Idempotent @Idempotent
@ -166,24 +160,29 @@ public interface ClientProtocol {
* *
* @return the status of the created file, it could be null if the server * @return the status of the created file, it could be null if the server
* doesn't support returning the file status * doesn't support returning the file status
* @throws AccessControlException If access is denied * @throws org.apache.hadoop.security.AccessControlException If access is
* denied
* @throws AlreadyBeingCreatedException if the path does not exist. * @throws AlreadyBeingCreatedException if the path does not exist.
* @throws DSQuotaExceededException If file creation violates disk space * @throws DSQuotaExceededException If file creation violates disk space
* quota restriction * quota restriction
* @throws FileAlreadyExistsException If file <code>src</code> already exists * @throws org.apache.hadoop.fs.FileAlreadyExistsException If file
* @throws FileNotFoundException If parent of <code>src</code> does not exist * <code>src</code> already exists
* and <code>createParent</code> is false * @throws java.io.FileNotFoundException If parent of <code>src</code> does
* @throws ParentNotDirectoryException If parent of <code>src</code> is not a * not exist and <code>createParent</code> is false
* directory. * @throws org.apache.hadoop.fs.ParentNotDirectoryException If parent of
* <code>src</code> is not a directory.
* @throws NSQuotaExceededException If file creation violates name space * @throws NSQuotaExceededException If file creation violates name space
* quota restriction * quota restriction
* @throws SafeModeException create not allowed in safemode * @throws org.apache.hadoop.hdfs.server.namenode.SafeModeException create not
* @throws UnresolvedLinkException If <code>src</code> contains a symlink * allowed in safemode
* @throws org.apache.hadoop.fs.UnresolvedLinkException If <code>src</code>
* contains a symlink
* @throws SnapshotAccessControlException if path is in RO snapshot * @throws SnapshotAccessControlException if path is in RO snapshot
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
* *
* RuntimeExceptions: * RuntimeExceptions:
* @throws InvalidPathException Path <code>src</code> is invalid * @throws org.apache.hadoop.fs.InvalidPathException Path <code>src</code> is
* invalid
* <p> * <p>
* <em>Note that create with {@link CreateFlag#OVERWRITE} is idempotent.</em> * <em>Note that create with {@link CreateFlag#OVERWRITE} is idempotent.</em>
*/ */
@ -201,19 +200,23 @@ public interface ClientProtocol {
* @param flag indicates whether the data is appended to a new block. * @param flag indicates whether the data is appended to a new block.
* @return wrapper with information about the last partial block and file * @return wrapper with information about the last partial block and file
* status if any * status if any
* @throws AccessControlException if permission to append file is * @throws org.apache.hadoop.security.AccessControlException if permission to
* denied by the system. As usually on the client side the exception will * append file is denied by the system. As usually on the client side the
* be wrapped into {@link org.apache.hadoop.ipc.RemoteException}. * exception will be wrapped into
* {@link org.apache.hadoop.ipc.RemoteException}.
* Allows appending to an existing file if the server is * Allows appending to an existing file if the server is
* configured with the parameter dfs.support.append set to true, otherwise * configured with the parameter dfs.support.append set to true, otherwise
* throws an IOException. * throws an IOException.
* *
* @throws AccessControlException If permission to append to file is denied * @throws org.apache.hadoop.security.AccessControlException If permission to
* @throws FileNotFoundException If file <code>src</code> is not found * append to file is denied
* @throws java.io.FileNotFoundException If file <code>src</code> is not found
* @throws DSQuotaExceededException If append violates disk space quota * @throws DSQuotaExceededException If append violates disk space quota
* restriction * restriction
* @throws SafeModeException append not allowed in safemode * @throws org.apache.hadoop.hdfs.server.namenode.SafeModeException append not
* @throws UnresolvedLinkException If <code>src</code> contains a symlink * allowed in safemode
* @throws org.apache.hadoop.fs.UnresolvedLinkException If <code>src</code>
* contains a symlink
* @throws SnapshotAccessControlException if path is in RO snapshot * @throws SnapshotAccessControlException if path is in RO snapshot
* @throws IOException If an I/O error occurred. * @throws IOException If an I/O error occurred.
* *
@ -238,12 +241,15 @@ public interface ClientProtocol {
* @return true if successful; * @return true if successful;
* false if file does not exist or is a directory * false if file does not exist or is a directory
* *
* @throws AccessControlException If access is denied * @throws org.apache.hadoop.security.AccessControlException If access is
* denied
* @throws DSQuotaExceededException If replication violates disk space * @throws DSQuotaExceededException If replication violates disk space
* quota restriction * quota restriction
* @throws FileNotFoundException If file <code>src</code> is not found * @throws java.io.FileNotFoundException If file <code>src</code> is not found
* @throws SafeModeException not allowed in safemode * @throws org.apache.hadoop.hdfs.server.namenode.SafeModeException not
* @throws UnresolvedLinkException if <code>src</code> contains a symlink * allowed in safemode
* @throws org.apache.hadoop.fs.UnresolvedLinkException if <code>src</code>
* contains a symlink
* @throws SnapshotAccessControlException if path is in RO snapshot * @throws SnapshotAccessControlException if path is in RO snapshot
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@ -263,8 +269,10 @@ public interface ClientProtocol {
* @param src Path of an existing file/directory. * @param src Path of an existing file/directory.
* @param policyName The name of the storage policy * @param policyName The name of the storage policy
* @throws SnapshotAccessControlException If access is denied * @throws SnapshotAccessControlException If access is denied
* @throws UnresolvedLinkException if <code>src</code> contains a symlink * @throws org.apache.hadoop.fs.UnresolvedLinkException if <code>src</code>
* @throws FileNotFoundException If file/dir <code>src</code> is not found * contains a symlink
* @throws java.io.FileNotFoundException If file/dir <code>src</code> is not
* found
* @throws QuotaExceededException If changes violate the quota restriction * @throws QuotaExceededException If changes violate the quota restriction
*/ */
@Idempotent @Idempotent
@ -274,10 +282,13 @@ public interface ClientProtocol {
/** /**
* Set permissions for an existing file/directory. * Set permissions for an existing file/directory.
* *
* @throws AccessControlException If access is denied * @throws org.apache.hadoop.security.AccessControlException If access is
* @throws FileNotFoundException If file <code>src</code> is not found * denied
* @throws SafeModeException not allowed in safemode * @throws java.io.FileNotFoundException If file <code>src</code> is not found
* @throws UnresolvedLinkException If <code>src</code> contains a symlink * @throws org.apache.hadoop.hdfs.server.namenode.SafeModeException not
* allowed in safemode
* @throws org.apache.hadoop.fs.UnresolvedLinkException If <code>src</code>
* contains a symlink
* @throws SnapshotAccessControlException if path is in RO snapshot * @throws SnapshotAccessControlException if path is in RO snapshot
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@ -292,10 +303,13 @@ public interface ClientProtocol {
* @param username If it is null, the original username remains unchanged. * @param username If it is null, the original username remains unchanged.
* @param groupname If it is null, the original groupname remains unchanged. * @param groupname If it is null, the original groupname remains unchanged.
* *
* @throws AccessControlException If access is denied * @throws org.apache.hadoop.security.AccessControlException If access is
* @throws FileNotFoundException If file <code>src</code> is not found * denied
* @throws SafeModeException not allowed in safemode * @throws java.io.FileNotFoundException If file <code>src</code> is not found
* @throws UnresolvedLinkException If <code>src</code> contains a symlink * @throws org.apache.hadoop.hdfs.server.namenode.SafeModeException not
* allowed in safemode
* @throws org.apache.hadoop.fs.UnresolvedLinkException If <code>src</code>
* contains a symlink
* @throws SnapshotAccessControlException if path is in RO snapshot * @throws SnapshotAccessControlException if path is in RO snapshot
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@ -315,9 +329,11 @@ public interface ClientProtocol {
* @param src The path of the file where the block resides. * @param src The path of the file where the block resides.
* @param holder Lease holder. * @param holder Lease holder.
* *
* @throws AccessControlException If access is denied * @throws org.apache.hadoop.security.AccessControlException If access is
* @throws FileNotFoundException file <code>src</code> is not found * denied
* @throws UnresolvedLinkException If <code>src</code> contains a symlink * @throws java.io.FileNotFoundException file <code>src</code> is not found
* @throws org.apache.hadoop.fs.UnresolvedLinkException If <code>src</code>
* contains a symlink
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@Idempotent @Idempotent
@ -348,13 +364,16 @@ public interface ClientProtocol {
* *
* @return LocatedBlock allocated block information. * @return LocatedBlock allocated block information.
* *
* @throws AccessControlException If access is denied * @throws org.apache.hadoop.security.AccessControlException If access is
* @throws FileNotFoundException If file <code>src</code> is not found * denied
* @throws NotReplicatedYetException previous blocks of the file are not * @throws java.io.FileNotFoundException If file <code>src</code> is not found
* replicated yet. Blocks cannot be added until replication * @throws org.apache.hadoop.hdfs.server.namenode.NotReplicatedYetException
* completes. * previous blocks of the file are not replicated yet.
* @throws SafeModeException create not allowed in safemode * Blocks cannot be added until replication completes.
* @throws UnresolvedLinkException If <code>src</code> contains a symlink * @throws org.apache.hadoop.hdfs.server.namenode.SafeModeException create not
* allowed in safemode
* @throws org.apache.hadoop.fs.UnresolvedLinkException If <code>src</code>
* contains a symlink
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@Idempotent @Idempotent
@ -376,10 +395,13 @@ public interface ClientProtocol {
* *
* @return the located block. * @return the located block.
* *
* @throws AccessControlException If access is denied * @throws org.apache.hadoop.security.AccessControlException If access is
* @throws FileNotFoundException If file <code>src</code> is not found * denied
* @throws SafeModeException create not allowed in safemode * @throws java.io.FileNotFoundException If file <code>src</code> is not found
* @throws UnresolvedLinkException If <code>src</code> contains a symlink * @throws org.apache.hadoop.hdfs.server.namenode.SafeModeException create not
* allowed in safemode
* @throws org.apache.hadoop.fs.UnresolvedLinkException If <code>src</code>
* contains a symlink
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@Idempotent @Idempotent
@ -414,10 +436,13 @@ public interface ClientProtocol {
* *
* @return true if all file blocks are minimally replicated or false otherwise * @return true if all file blocks are minimally replicated or false otherwise
* *
* @throws AccessControlException If access is denied * @throws org.apache.hadoop.security.AccessControlException If access is
* @throws FileNotFoundException If file <code>src</code> is not found * denied
* @throws SafeModeException create not allowed in safemode * @throws java.io.FileNotFoundException If file <code>src</code> is not found
* @throws UnresolvedLinkException If <code>src</code> contains a symlink * @throws org.apache.hadoop.hdfs.server.namenode.SafeModeException create not
* allowed in safemode
* @throws org.apache.hadoop.fs.UnresolvedLinkException If <code>src</code>
* contains a symlink
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@Idempotent @Idempotent
@ -456,8 +481,8 @@ public interface ClientProtocol {
* @param trg existing file * @param trg existing file
* @param srcs - list of existing files (same block size, same replication) * @param srcs - list of existing files (same block size, same replication)
* @throws IOException if some arguments are invalid * @throws IOException if some arguments are invalid
* @throws UnresolvedLinkException if <code>trg</code> or <code>srcs</code> * @throws org.apache.hadoop.fs.UnresolvedLinkException if <code>trg</code> or
* contains a symlink * <code>srcs</code> contains a symlink
* @throws SnapshotAccessControlException if path is in RO snapshot * @throws SnapshotAccessControlException if path is in RO snapshot
*/ */
@AtMostOnce @AtMostOnce
@ -482,19 +507,22 @@ public interface ClientProtocol {
* @param dst new name. * @param dst new name.
* @param options Rename options * @param options Rename options
* *
* @throws AccessControlException If access is denied * @throws org.apache.hadoop.security.AccessControlException If access is
* denied
* @throws DSQuotaExceededException If rename violates disk space * @throws DSQuotaExceededException If rename violates disk space
* quota restriction * quota restriction
* @throws FileAlreadyExistsException If <code>dst</code> already exists and * @throws org.apache.hadoop.fs.FileAlreadyExistsException If <code>dst</code>
* <code>options</code> has {@link Rename#OVERWRITE} option * already exists and <code>options</code> has
* {@link org.apache.hadoop.fs.Options.Rename#OVERWRITE} option
* false. * false.
* @throws FileNotFoundException If <code>src</code> does not exist * @throws java.io.FileNotFoundException If <code>src</code> does not exist
* @throws NSQuotaExceededException If rename violates namespace * @throws NSQuotaExceededException If rename violates namespace
* quota restriction * quota restriction
* @throws ParentNotDirectoryException If parent of <code>dst</code> * @throws org.apache.hadoop.fs.ParentNotDirectoryException If parent of
* is not a directory * <code>dst</code> is not a directory
* @throws SafeModeException rename not allowed in safemode * @throws org.apache.hadoop.hdfs.server.namenode.SafeModeException rename not
* @throws UnresolvedLinkException If <code>src</code> or * allowed in safemode
* @throws org.apache.hadoop.fs.UnresolvedLinkException If <code>src</code> or
* <code>dst</code> contains a symlink * <code>dst</code> contains a symlink
* @throws SnapshotAccessControlException if path is in RO snapshot * @throws SnapshotAccessControlException if path is in RO snapshot
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
@ -521,10 +549,13 @@ public interface ClientProtocol {
* @return true if client does not need to wait for block recovery, * @return true if client does not need to wait for block recovery,
* false if client needs to wait for block recovery. * false if client needs to wait for block recovery.
* *
* @throws AccessControlException If access is denied * @throws org.apache.hadoop.security.AccessControlException If access is
* @throws FileNotFoundException If file <code>src</code> is not found * denied
* @throws SafeModeException truncate not allowed in safemode * @throws java.io.FileNotFoundException If file <code>src</code> is not found
* @throws UnresolvedLinkException If <code>src</code> contains a symlink * @throws org.apache.hadoop.hdfs.server.namenode.SafeModeException truncate
* not allowed in safemode
* @throws org.apache.hadoop.fs.UnresolvedLinkException If <code>src</code>
* contains a symlink
* @throws SnapshotAccessControlException if path is in RO snapshot * @throws SnapshotAccessControlException if path is in RO snapshot
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@ -543,10 +574,13 @@ public interface ClientProtocol {
* @return true only if the existing file or directory was actually removed * @return true only if the existing file or directory was actually removed
* from the file system. * from the file system.
* *
* @throws AccessControlException If access is denied * @throws org.apache.hadoop.security.AccessControlException If access is
* @throws FileNotFoundException If file <code>src</code> is not found * denied
* @throws SafeModeException create not allowed in safemode * @throws java.io.FileNotFoundException If file <code>src</code> is not found
* @throws UnresolvedLinkException If <code>src</code> contains a symlink * @throws org.apache.hadoop.hdfs.server.namenode.SafeModeException create not
* allowed in safemode
* @throws org.apache.hadoop.fs.UnresolvedLinkException If <code>src</code>
* contains a symlink
* @throws SnapshotAccessControlException if path is in RO snapshot * @throws SnapshotAccessControlException if path is in RO snapshot
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@ -564,21 +598,26 @@ public interface ClientProtocol {
* *
* @return True if the operation success. * @return True if the operation success.
* *
* @throws AccessControlException If access is denied * @throws org.apache.hadoop.security.AccessControlException If access is
* @throws FileAlreadyExistsException If <code>src</code> already exists * denied
* @throws FileNotFoundException If parent of <code>src</code> does not exist * @throws org.apache.hadoop.fs.FileAlreadyExistsException If <code>src</code>
* and <code>createParent</code> is false * already exists
* @throws java.io.FileNotFoundException If parent of <code>src</code> does
* not exist and <code>createParent</code> is false
* @throws NSQuotaExceededException If file creation violates quota * @throws NSQuotaExceededException If file creation violates quota
* restriction * restriction
* @throws ParentNotDirectoryException If parent of <code>src</code> * @throws org.apache.hadoop.fs.ParentNotDirectoryException If parent of
* is not a directory * <code>src</code> is not a directory
* @throws SafeModeException create not allowed in safemode * @throws org.apache.hadoop.hdfs.server.namenode.SafeModeException create not
* @throws UnresolvedLinkException If <code>src</code> contains a symlink * allowed in safemode
* @throws org.apache.hadoop.fs.UnresolvedLinkException If <code>src</code>
* contains a symlink
* @throws SnapshotAccessControlException if path is in RO snapshot * @throws SnapshotAccessControlException if path is in RO snapshot
* @throws IOException If an I/O error occurred. * @throws IOException If an I/O error occurred.
* *
* RunTimeExceptions: * RunTimeExceptions:
* @throws InvalidPathException If <code>src</code> is invalid * @throws org.apache.hadoop.fs.InvalidPathException If <code>src</code> is
* invalid
*/ */
@Idempotent @Idempotent
boolean mkdirs(String src, FsPermission masked, boolean createParent) boolean mkdirs(String src, FsPermission masked, boolean createParent)
@ -593,9 +632,10 @@ public interface ClientProtocol {
* *
* @return a partial listing starting after startAfter * @return a partial listing starting after startAfter
* *
* @throws AccessControlException permission denied * @throws org.apache.hadoop.security.AccessControlException permission denied
* @throws FileNotFoundException file <code>src</code> is not found * @throws java.io.FileNotFoundException file <code>src</code> is not found
* @throws UnresolvedLinkException If <code>src</code> contains a symlink * @throws org.apache.hadoop.fs.UnresolvedLinkException If <code>src</code>
* contains a symlink
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@Idempotent @Idempotent
@ -632,7 +672,7 @@ public interface ClientProtocol {
* the last call to renewLease(), the NameNode assumes the * the last call to renewLease(), the NameNode assumes the
* client has died. * client has died.
* *
* @throws AccessControlException permission denied * @throws org.apache.hadoop.security.AccessControlException permission denied
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@Idempotent @Idempotent
@ -699,7 +739,8 @@ public interface ClientProtocol {
* @param filename The name of the file * @param filename The name of the file
* @return The number of bytes in each block * @return The number of bytes in each block
* @throws IOException * @throws IOException
* @throws UnresolvedLinkException if the path contains a symlink. * @throws org.apache.hadoop.fs.UnresolvedLinkException if the path contains
* a symlink.
*/ */
@Idempotent @Idempotent
long getPreferredBlockSize(String filename) long getPreferredBlockSize(String filename)
@ -789,7 +830,8 @@ public interface ClientProtocol {
* Roll the edit log. * Roll the edit log.
* Requires superuser privileges. * Requires superuser privileges.
* *
* @throws AccessControlException if the superuser privilege is violated * @throws org.apache.hadoop.security.AccessControlException if the superuser
* privilege is violated
* @throws IOException if log roll fails * @throws IOException if log roll fails
* @return the txid of the new segment * @return the txid of the new segment
*/ */
@ -801,7 +843,8 @@ public interface ClientProtocol {
* <p> * <p>
* sets flag to enable restore of failed storage replicas * sets flag to enable restore of failed storage replicas
* *
* @throws AccessControlException if the superuser privilege is violated. * @throws org.apache.hadoop.security.AccessControlException if the superuser
* privilege is violated.
*/ */
@Idempotent @Idempotent
boolean restoreFailedStorage(String arg) throws IOException; boolean restoreFailedStorage(String arg) throws IOException;
@ -872,9 +915,10 @@ public interface ClientProtocol {
* *
* @return object containing information regarding the file * @return object containing information regarding the file
* or null if file not found * or null if file not found
* @throws AccessControlException permission denied * @throws org.apache.hadoop.security.AccessControlException permission denied
* @throws FileNotFoundException file <code>src</code> is not found * @throws java.io.FileNotFoundException file <code>src</code> is not found
* @throws UnresolvedLinkException if the path contains a symlink. * @throws org.apache.hadoop.fs.UnresolvedLinkException if the path contains
* a symlink.
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@Idempotent @Idempotent
@ -885,9 +929,10 @@ public interface ClientProtocol {
* @param src The string representation of the path to the file * @param src The string representation of the path to the file
* *
* @return return true if file is closed * @return return true if file is closed
* @throws AccessControlException permission denied * @throws org.apache.hadoop.security.AccessControlException permission denied
* @throws FileNotFoundException file <code>src</code> is not found * @throws java.io.FileNotFoundException file <code>src</code> is not found
* @throws UnresolvedLinkException if the path contains a symlink. * @throws org.apache.hadoop.fs.UnresolvedLinkException if the path contains
* a symlink.
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@Idempotent @Idempotent
@ -901,8 +946,9 @@ public interface ClientProtocol {
* @return object containing information regarding the file * @return object containing information regarding the file
* or null if file not found * or null if file not found
* *
* @throws AccessControlException permission denied * @throws org.apache.hadoop.security.AccessControlException permission denied
* @throws UnresolvedLinkException if <code>src</code> contains a symlink * @throws org.apache.hadoop.fs.UnresolvedLinkException if <code>src</code>
* contains a symlink
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@Idempotent @Idempotent
@ -912,9 +958,10 @@ public interface ClientProtocol {
* Get {@link ContentSummary} rooted at the specified directory. * Get {@link ContentSummary} rooted at the specified directory.
* @param path The string representation of the path * @param path The string representation of the path
* *
* @throws AccessControlException permission denied * @throws org.apache.hadoop.security.AccessControlException permission denied
* @throws FileNotFoundException file <code>path</code> is not found * @throws java.io.FileNotFoundException file <code>path</code> is not found
* @throws UnresolvedLinkException if <code>path</code> contains a symlink. * @throws org.apache.hadoop.fs.UnresolvedLinkException if <code>path</code>
* contains a symlink.
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@Idempotent @Idempotent
@ -940,12 +987,12 @@ public interface ClientProtocol {
* the quota will not be changed, and (3) {@link HdfsConstants#QUOTA_RESET} * the quota will not be changed, and (3) {@link HdfsConstants#QUOTA_RESET}
* implies the quota will be reset. Any other value is a runtime error. * implies the quota will be reset. Any other value is a runtime error.
* *
* @throws AccessControlException permission denied * @throws org.apache.hadoop.security.AccessControlException permission denied
* @throws FileNotFoundException file <code>path</code> is not found * @throws java.io.FileNotFoundException file <code>path</code> is not found
* @throws QuotaExceededException if the directory size * @throws QuotaExceededException if the directory size
* is greater than the given quota * is greater than the given quota
* @throws UnresolvedLinkException if the <code>path</code> contains * @throws org.apache.hadoop.fs.UnresolvedLinkException if the
* a symlink. * <code>path</code> contains a symlink.
* @throws SnapshotAccessControlException if path is in RO snapshot * @throws SnapshotAccessControlException if path is in RO snapshot
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@ -962,9 +1009,10 @@ public interface ClientProtocol {
* @param client The string representation of the client * @param client The string representation of the client
* @param lastBlockLength The length of the last block (under construction) * @param lastBlockLength The length of the last block (under construction)
* to be reported to NameNode * to be reported to NameNode
* @throws AccessControlException permission denied * @throws org.apache.hadoop.security.AccessControlException permission denied
* @throws FileNotFoundException file <code>src</code> is not found * @throws java.io.FileNotFoundException file <code>src</code> is not found
* @throws UnresolvedLinkException if <code>src</code> contains a symlink. * @throws org.apache.hadoop.fs.UnresolvedLinkException if <code>src</code>
* contains a symlink.
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@Idempotent @Idempotent
@ -981,9 +1029,10 @@ public interface ClientProtocol {
* Setting atime to -1 means that access time should not be set * Setting atime to -1 means that access time should not be set
* by this call. * by this call.
* *
* @throws AccessControlException permission denied * @throws org.apache.hadoop.security.AccessControlException permission denied
* @throws FileNotFoundException file <code>src</code> is not found * @throws java.io.FileNotFoundException file <code>src</code> is not found
* @throws UnresolvedLinkException if <code>src</code> contains a symlink. * @throws org.apache.hadoop.fs.UnresolvedLinkException if <code>src</code>
* contains a symlink.
* @throws SnapshotAccessControlException if path is in RO snapshot * @throws SnapshotAccessControlException if path is in RO snapshot
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@ -999,13 +1048,15 @@ public interface ClientProtocol {
* @param createParent - if true then missing parent dirs are created * @param createParent - if true then missing parent dirs are created
* if false then parent must exist * if false then parent must exist
* *
* @throws AccessControlException permission denied * @throws org.apache.hadoop.security.AccessControlException permission denied
* @throws FileAlreadyExistsException If file <code>link</code> already exists * @throws org.apache.hadoop.fs.FileAlreadyExistsException If file
* @throws FileNotFoundException If parent of <code>link</code> does not exist * <code>link</code> already exists
* and <code>createParent</code> is false * @throws java.io.FileNotFoundException If parent of <code>link</code> does
* @throws ParentNotDirectoryException If parent of <code>link</code> is not a * not exist and <code>createParent</code> is false
* directory. * @throws org.apache.hadoop.fs.ParentNotDirectoryException If parent of
* @throws UnresolvedLinkException if <code>link</code> contains a symlink. * <code>link</code> is not a directory.
* @throws org.apache.hadoop.fs.UnresolvedLinkException if <code>link</code>
* contains a symlink.
* @throws SnapshotAccessControlException if path is in RO snapshot * @throws SnapshotAccessControlException if path is in RO snapshot
* @throws IOException If an I/O error occurred * @throws IOException If an I/O error occurred
*/ */
@ -1020,8 +1071,8 @@ public interface ClientProtocol {
* *
* @param path The path with a link that needs resolution. * @param path The path with a link that needs resolution.
* @return The path after resolving the first symbolic link in the path. * @return The path after resolving the first symbolic link in the path.
* @throws AccessControlException permission denied * @throws org.apache.hadoop.security.AccessControlException permission denied
* @throws FileNotFoundException If <code>path</code> does not exist * @throws java.io.FileNotFoundException If <code>path</code> does not exist
* @throws IOException If the given path does not refer to a symlink * @throws IOException If the given path does not refer to a symlink
* or an I/O error occurred * or an I/O error occurred
*/ */
@ -1389,15 +1440,16 @@ public interface ClientProtocol {
* Checks if the user can access a path. The mode specifies which access * Checks if the user can access a path. The mode specifies which access
* checks to perform. If the requested permissions are granted, then the * checks to perform. If the requested permissions are granted, then the
* method returns normally. If access is denied, then the method throws an * method returns normally. If access is denied, then the method throws an
* {@link AccessControlException}. * {@link org.apache.hadoop.security.AccessControlException}.
* In general, applications should avoid using this method, due to the risk of * In general, applications should avoid using this method, due to the risk of
* time-of-check/time-of-use race conditions. The permissions on a file may * time-of-check/time-of-use race conditions. The permissions on a file may
* change immediately after the access call returns. * change immediately after the access call returns.
* *
* @param path Path to check * @param path Path to check
* @param mode type of access to check * @param mode type of access to check
* @throws AccessControlException if access is denied * @throws org.apache.hadoop.security.AccessControlException if access is
* @throws FileNotFoundException if the path does not exist * denied
* @throws java.io.FileNotFoundException if the path does not exist
* @throws IOException see specific implementation * @throws IOException see specific implementation
*/ */
@Idempotent @Idempotent

3
hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
View File

@ -744,6 +744,9 @@ Release 2.8.0 - UNRELEASED
HDFS-8797. WebHdfsFileSystem creates too many connections for pread. (jing9) HDFS-8797. WebHdfsFileSystem creates too many connections for pread. (jing9)
HDFS-8730. Clean up the import statements in ClientProtocol.
(Takanobu Asanuma via wheat9)
OPTIMIZATIONS OPTIMIZATIONS
HDFS-8026. Trace FSOutputSummer#writeChecksumChunks rather than HDFS-8026. Trace FSOutputSummer#writeChecksumChunks rather than