public abstract class INodeReference extends INode
Modifier and Type | Class and Description |
---|---|
static class |
INodeReference.DstReference |
static class |
INodeReference.WithCount
An anonymous reference with reference count.
|
static class |
INodeReference.WithName
A reference with a fixed name.
|
INode.BlocksMapUpdateInfo
INodeAttributes.SnapshotCopy
Constructor and Description |
---|
INodeReference(INode parent,
INode referred) |
Modifier and Type | Method and Description |
---|---|
INodeDirectory |
asDirectory()
Cast this inode to an
INodeDirectory . |
INodeFile |
asFile()
Cast this inode to an
INodeFile . |
INodeReference |
asReference()
Cast this inode to an
INodeReference . |
INodeSymlink |
asSymlink()
Cast this inode to an
INodeSymlink . |
Quota.Counts |
cleanSubtree(Snapshot snapshot,
Snapshot prior,
INode.BlocksMapUpdateInfo collectedBlocks,
List<INode> removedINodes,
boolean countDiffChange)
Clean the subtree under this inode and collect the blocks from the descents
for further block deletion/update.
|
void |
clear()
Clear references to other objects.
|
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<INode> removedINodes)
Destroy self and clear everything! If the INode is a file, this method
collects its blocks for further block deletion.
|
void |
dumpTreeRecursively(PrintWriter out,
StringBuilder prefix,
Snapshot snapshot)
Dump tree recursively.
|
long |
getAccessTime(Snapshot snapshot) |
long |
getDsQuota() |
int |
getDstSnapshotId() |
FsPermission |
getFsPermission(Snapshot snapshot) |
short |
getFsPermissionShort() |
String |
getGroupName(Snapshot snapshot) |
long |
getId()
Get inode id
|
byte[] |
getLocalNameBytes() |
long |
getModificationTime(Snapshot snapshot) |
long |
getNsQuota()
Get the quota set for this inode
|
long |
getPermissionLong() |
PermissionStatus |
getPermissionStatus(Snapshot snapshot)
Get the
PermissionStatus |
INode |
getReferredINode() |
INodeAttributes |
getSnapshotINode(Snapshot snapshot) |
String |
getUserName(Snapshot snapshot) |
boolean |
isDirectory()
Check whether it's a directory
|
boolean |
isFile()
Check whether it's a file.
|
boolean |
isReference()
Check whether it's a reference.
|
boolean |
isSymlink()
Check whether it's a symlink
|
void |
setAccessTime(long accessTime)
Set last access time of inode.
|
void |
setLocalName(byte[] name)
Set local file name
|
void |
setModificationTime(long modificationTime)
Set the last modification time of inode.
|
void |
setReferredINode(INode referred) |
static int |
tryRemoveReference(INode inode)
Try to remove the given reference and then return the reference count.
|
INode |
updateModificationTime(long mtime,
Snapshot latest,
INodeMap inodeMap)
Update modification time if it is larger than the current value.
|
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
public static int tryRemoveReference(INode inode)
public final INode getReferredINode()
public final void setReferredINode(INode referred)
public final boolean isReference()
INode
isReference
in class INode
public final INodeReference asReference()
INode
INodeReference
.asReference
in class INode
public final boolean isFile()
INode
public final INodeFile asFile()
INode
INodeFile
.public final boolean isDirectory()
INode
isDirectory
in class INode
public final INodeDirectory asDirectory()
INode
INodeDirectory
.asDirectory
in class INode
public final boolean isSymlink()
INode
public final INodeSymlink asSymlink()
INode
INodeSymlink
.public byte[] getLocalNameBytes()
public void setLocalName(byte[] name)
INode
setLocalName
in class INode
public final long getId()
INode
public final PermissionStatus getPermissionStatus(Snapshot snapshot)
INode
PermissionStatus
public final String getUserName(Snapshot snapshot)
snapshot
- if it is not null, get the result from the given snapshot;
otherwise, get the result from the current inode.public final String getGroupName(Snapshot snapshot)
snapshot
- if it is not null, get the result from the given snapshot;
otherwise, get the result from the current inode.public final FsPermission getFsPermission(Snapshot snapshot)
snapshot
- if it is not null, get the result from the given snapshot;
otherwise, get the result from the current inode.public final short getFsPermissionShort()
public long getPermissionLong()
public final long getModificationTime(Snapshot snapshot)
snapshot
- if it is not null, get the result from the given snapshot;
otherwise, get the result from the current inode.public final INode updateModificationTime(long mtime, Snapshot latest, INodeMap inodeMap) throws QuotaExceededException
INode
updateModificationTime
in class INode
QuotaExceededException
public final void setModificationTime(long modificationTime)
INode
setModificationTime
in class INode
public final long getAccessTime(Snapshot snapshot)
snapshot
- if it is not null, get the result from the given snapshot;
otherwise, get the result from the current inode.public final void setAccessTime(long accessTime)
INode
setAccessTime
in class INode
public Quota.Counts cleanSubtree(Snapshot snapshot, Snapshot prior, INode.BlocksMapUpdateInfo collectedBlocks, List<INode> removedINodes, boolean countDiffChange) throws QuotaExceededException
INode
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 anINodeFile
. 1.1.1 Ifprior
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 anINodeDirectory
. 1.2.1 Ifprior
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 aFileWithSnapshot
. Call recordModification(..) to capture the current states. Mark the INode as deleted. 1.4 The current inode is aINodeDirectoryWithSnapshot
. 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 cleanINodeFile
: do nothing. 2.2 To cleanINodeDirectory
: recursively clean its children. 2.3 To cleanFileWithSnapshot
: delete the corresponding snapshot in its diff list. 2.4 To cleanINodeDirectoryWithSnapshot
: delete the corresponding snapshot in its diff list. Recursively clean its children.
cleanSubtree
in class INode
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
inodeMapQuotaExceededException
public void destroyAndCollectBlocks(INode.BlocksMapUpdateInfo collectedBlocks, List<INode> removedINodes)
INode
destroyAndCollectBlocks
in class INode
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
inodeMappublic Content.Counts computeContentSummary(Content.Counts counts)
INode
Content.Counts
.computeContentSummary
in class INode
counts
- The subtree counts for returning.public Quota.Counts computeQuotaUsage(Quota.Counts counts, boolean useCache, int lastSnapshotId)
INode
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 aINodeReference.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 aINodeReference.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 theINodeReference.WithName
node. We do not count in the size of the diff list.
computeQuotaUsage
in class INode
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.public final INodeAttributes getSnapshotINode(Snapshot snapshot)
getSnapshotINode
in class INode
public final long getNsQuota()
INode
getNsQuota
in class INode
public final long getDsQuota()
getDsQuota
in class INode
public final void clear()
INode
public void dumpTreeRecursively(PrintWriter out, StringBuilder prefix, Snapshot snapshot)
INode
dumpTreeRecursively
in class INode
prefix
- The prefix string that each line should print.public int getDstSnapshotId()
Copyright © 2013 Apache Software Foundation. All rights reserved.