org.apache.hadoop.hdfs.server.namenode
Class INodeReference.WithName

java.lang.Object
  org.apache.hadoop.hdfs.server.namenode.INode
      org.apache.hadoop.hdfs.server.namenode.INodeReference
          org.apache.hadoop.hdfs.server.namenode.INodeReference.WithName

All Implemented Interfaces:

Comparable<byte[]>, org.apache.hadoop.hdfs.server.namenode.INodeAttributes, Diff.Element<byte[]>

Enclosing class:

INodeReference

public static class INodeReference.WithName
extends INodeReference

A reference with a fixed name.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.hadoop.hdfs.server.namenode.INodeReference

INodeReference.DstReference, INodeReference.WithCount, INodeReference.WithName

Nested classes/interfaces inherited from class org.apache.hadoop.hdfs.server.namenode.INode

INode.BlocksMapUpdateInfo

Nested classes/interfaces inherited from interface org.apache.hadoop.hdfs.server.namenode.INodeAttributes

INodeAttributes.SnapshotCopy

Field Summary

Fields inherited from class org.apache.hadoop.hdfs.server.namenode.INode

LOG

Constructor Summary

INodeReference.WithName(INodeDirectory parent, INodeReference.WithCount referred, byte[] name, int lastSnapshotId)

Method Summary

Quota.Counts	cleanSubtree(org.apache.hadoop.hdfs.server.namenode.snapshot.Snapshot snapshot, org.apache.hadoop.hdfs.server.namenode.snapshot.Snapshot prior, INode.BlocksMapUpdateInfo collectedBlocks, List<org.apache.hadoop.hdfs.server.namenode.INode> removedINodes, boolean countDiffChange) Clean the subtree under this inode and collect the blocks from the descents for further block deletion/update.
Content.Counts	computeContentSummary(Content.Counts counts) Count subtree content summary with a Content.Counts.
Quota.Counts	computeQuotaUsage(Quota.Counts counts, boolean useCache, int lastSnapshotId) Count subtree Quota.NAMESPACE and Quota.DISKSPACE usages.
void	destroyAndCollectBlocks(INode.BlocksMapUpdateInfo collectedBlocks, List<org.apache.hadoop.hdfs.server.namenode.INode> removedINodes) Destroy self and clear everything! If the INode is a file, this method collects its blocks for further block deletion.
int	getLastSnapshotId()
byte[]	getLocalNameBytes()
void	setLocalName(byte[] name) Set local file name

Methods inherited from class org.apache.hadoop.hdfs.server.namenode.INodeReference

asDirectory, asFile, asReference, asSymlink, clear, dumpTreeRecursively, getAccessTime, getDsQuota, getDstSnapshotId, getFsPermission, getFsPermissionShort, getGroupName, getId, getModificationTime, getNsQuota, getPermissionLong, getPermissionStatus, getReferredINode, getSnapshotINode, getUserName, isDirectory, isFile, isReference, isSymlink, setAccessTime, setModificationTime, setReferredINode, tryRemoveReference, updateModificationTime

Methods inherited from class org.apache.hadoop.hdfs.server.namenode.INode

addSpaceConsumed, compareTo, computeContentSummary, computeQuotaUsage, computeQuotaUsage, dumpTreeRecursively, dumpTreeRecursively, equals, getAccessTime, getFsPermission, getFullPathName, getGroupName, getKey, getLocalName, getModificationTime, getObjectString, getParent, getParentReference, getParentString, getUserName, hashCode, isAncestorDirectory, isInLatestSnapshot, isQuotaSet, setAccessTime, setModificationTime, setParent, setParentReference, shouldRecordInSrcSnapshot, toDetailString, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

INodeReference.WithName

public INodeReference.WithName(INodeDirectory parent,
                               INodeReference.WithCount referred,
                               byte[] name,
                               int lastSnapshotId)

Method Detail

getLocalNameBytes

public final byte[] getLocalNameBytes()

Specified by:

getLocalNameBytes in interface org.apache.hadoop.hdfs.server.namenode.INodeAttributes

Overrides:

getLocalNameBytes in class INodeReference

Returns:

null if the local name is null; otherwise, return the local name byte array.

setLocalName

public final void setLocalName(byte[] name)

Description copied from class: org.apache.hadoop.hdfs.server.namenode.INode

Set local file name

Overrides:

setLocalName in class INodeReference

getLastSnapshotId

public int getLastSnapshotId()

computeContentSummary

public final Content.Counts computeContentSummary(Content.Counts counts)

Description copied from class: org.apache.hadoop.hdfs.server.namenode.INode

Count subtree content summary with a Content.Counts.

Overrides:

computeContentSummary in class INodeReference

Parameters:

counts - The subtree counts for returning.

Returns:

The same objects as the counts parameter.

computeQuotaUsage

public final Quota.Counts computeQuotaUsage(Quota.Counts counts,
                                            boolean useCache,
                                            int lastSnapshotId)

Description copied from class: org.apache.hadoop.hdfs.server.namenode.INode

Count subtree Quota.NAMESPACE and Quota.DISKSPACE usages. With the existence of INodeReference, the same inode and its subtree may be referred by multiple INodeReference.WithName nodes and a INodeReference.DstReference node. To avoid circles while quota usage computation, we have the following rules:

 1. For a INodeReference.DstReference node, since the node must be in the current
 tree (or has been deleted as the end point of a series of rename 
 operations), we compute the quota usage of the referred node (and its 
 subtree) in the regular manner, i.e., including every inode in the current
 tree and in snapshot copies, as well as the size of diff list.
 
 2. For a INodeReference.WithName node, since the node must be in a snapshot, we 
 only count the quota usage for those nodes that still existed at the 
 creation time of the snapshot associated with the INodeReference.WithName node.
 We do not count in the size of the diff list.  
 


Overrides:
computeQuotaUsage in class INodeReference


Parameters:
counts - The subtree counts for returning.
useCache - Whether to use cached quota usage. Note that 
                 INodeReference.WithName node never uses cache for its subtree.
lastSnapshotId - Snapshot.INVALID_ID indicates the computation
                       is in the current tree. Otherwise the id indicates
                       the computation range for a INodeReference.WithName node.
Returns:
The same objects as the counts parameter.

cleanSubtree

public Quota.Counts cleanSubtree(org.apache.hadoop.hdfs.server.namenode.snapshot.Snapshot snapshot,
                                 org.apache.hadoop.hdfs.server.namenode.snapshot.Snapshot prior,
                                 INode.BlocksMapUpdateInfo collectedBlocks,
                                 List<org.apache.hadoop.hdfs.server.namenode.INode> removedINodes,
                                 boolean countDiffChange)
                          throws org.apache.hadoop.hdfs.protocol.QuotaExceededException

Description copied from class: org.apache.hadoop.hdfs.server.namenode.INode

Clean the subtree under this inode and collect the blocks from the descents for further block deletion/update. The current inode can either resides in the current tree or be stored as a snapshot copy.

 In general, we have the following rules. 
 1. When deleting a file/directory in the current tree, we have different 
 actions according to the type of the node to delete. 
 
 1.1 The current inode (this) is an INodeFile. 
 1.1.1 If prior is null, there is no snapshot taken on ancestors 
 before. Thus we simply destroy (i.e., to delete completely, no need to save 
 snapshot copy) the current INode and collect its blocks for further 
 cleansing.
 1.1.2 Else do nothing since the current INode will be stored as a snapshot
 copy.
 
 1.2 The current inode is an INodeDirectory.
 1.2.1 If prior is null, there is no snapshot taken on ancestors 
 before. Similarly, we destroy the whole subtree and collect blocks.
 1.2.2 Else do nothing with the current INode. Recursively clean its 
 children.
 
 1.3 The current inode is a FileWithSnapshot.
 Call recordModification(..) to capture the current states.
 Mark the INode as deleted.
 
 1.4 The current inode is a INodeDirectoryWithSnapshot.
 Call recordModification(..) to capture the current states. 
 Destroy files/directories created after the latest snapshot 
 (i.e., the inodes stored in the created list of the latest snapshot).
 Recursively clean remaining children. 

 2. When deleting a snapshot.
 2.1 To clean INodeFile: do nothing.
 2.2 To clean INodeDirectory: recursively clean its children.
 2.3 To clean FileWithSnapshot: delete the corresponding snapshot in
 its diff list.
 2.4 To clean INodeDirectoryWithSnapshot: delete the corresponding 
 snapshot in its diff list. Recursively clean its children.
 

Overrides:

cleanSubtree in class INodeReference

Parameters:

snapshot - The snapshot to delete. Null means to delete the current file/directory.

prior - The latest snapshot before the to-be-deleted snapshot. When deleting a current inode, this parameter captures the latest snapshot.

collectedBlocks - blocks collected from the descents for further block deletion/update will be added to the given map.

removedINodes - INodes collected from the descents for further cleaning up of inodeMap

Returns:

quota usage delta when deleting a snapshot

Throws:

org.apache.hadoop.hdfs.protocol.QuotaExceededException

destroyAndCollectBlocks

public void destroyAndCollectBlocks(INode.BlocksMapUpdateInfo collectedBlocks,
                                    List<org.apache.hadoop.hdfs.server.namenode.INode> removedINodes)

Description copied from class: org.apache.hadoop.hdfs.server.namenode.INode

Destroy self and clear everything! If the INode is a file, this method collects its blocks for further block deletion. If the INode is a directory, the method goes down the subtree and collects blocks from the descents, and clears its parent/children references as well. The method also clears the diff list if the INode contains snapshot diff list.

Overrides:

destroyAndCollectBlocks in class INodeReference

Parameters:

collectedBlocks - blocks collected from the descents for further block deletion/update will be added to this map.

removedINodes - INodes collected from the descents for further cleaning up of inodeMap