org.apache.jackrabbit.oak.plugins.migration

Class FilteringNodeState

java.lang.Object

org.apache.jackrabbit.oak.spi.state.AbstractNodeState

org.apache.jackrabbit.oak.plugins.migration.AbstractDecoratedNodeState

org.apache.jackrabbit.oak.plugins.migration.FilteringNodeState

All Implemented Interfaces:

NodeState

public class FilteringNodeState
extends AbstractDecoratedNodeState

NodeState implementation that decorates another node-state instance in order to hide subtrees or partial subtrees from the consumer of the API.
The set of visible subtrees is defined by two parameters: include paths and exclude paths, both of which are sets of absolute paths.
Any paths that are equal or are descendants of one of the excluded paths are hidden by this implementation.
For all included paths, the direct ancestors, the node-state at the path itself and all descendants are visible. Any siblings of the defined path or its ancestors are implicitly hidden (unless made visible by another include path).
The implementation delegates to the decorated node-state instance and filters out hidden node-states in the following methods:

• AbstractDecoratedNodeState.exists()
• AbstractDecoratedNodeState.hasChildNode(String)
• AbstractDecoratedNodeState.getChildNodeEntries()

When referenceableFrozenNodes is set to false, then the implementation will hide the jcr:uuid property on nt:frozenNode nodes (see also OAK-9134).
Additionally, hidden node-state names are removed from the property :childOrder in the following two methods:

• AbstractDecoratedNodeState.getProperties()
• AbstractDecoratedNodeState.getProperty(String)

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.Set<java.lang.String>	ALL
static java.util.Set<java.lang.String>	NONE

Fields inherited from class org.apache.jackrabbit.oak.plugins.migration.AbstractDecoratedNodeState

delegate

Fields inherited from interface org.apache.jackrabbit.oak.spi.state.NodeState

EXISTS

Method Summary

Modifier and Type	Method and Description
protected @NotNull NodeState	decorateChild(@NotNull java.lang.String name, @NotNull NodeState child)
protected PropertyState	decorateProperty(@NotNull PropertyState propertyState)
protected boolean	hideChild(@NotNull java.lang.String name, @NotNull NodeState delegateChild)
static @NotNull NodeState	wrap(@NotNull java.lang.String path, @NotNull NodeState delegate, @Nullable java.util.Set<java.lang.String> includePaths, @Nullable java.util.Set<java.lang.String> excludePaths, @Nullable java.util.Set<java.lang.String> fragmentPaths, @Nullable java.util.Set<java.lang.String> excludedFragments, boolean referenceableFrozenNodes) Factory method that conditionally decorates the given node-state iff the node-state is (a) hidden itself or (b) has hidden descendants.

Methods inherited from class org.apache.jackrabbit.oak.plugins.migration.AbstractDecoratedNodeState

builder, compareAgainstBaseState, equals, exists, fixChildOrderPropertyState, getChildNode, getChildNodeEntries, getDelegate, getNewPropertyStates, getProperties, getProperty, hasChildNode, hideProperty

Methods inherited from class org.apache.jackrabbit.oak.spi.state.AbstractNodeState

checkValidName, compareAgainstBaseState, comparePropertiesAgainstBaseState, count, equals, getBoolean, getBoolean, getChildNodeCount, getChildNodeNames, getLong, getLong, getName, getName, getNames, getNames, getPropertyCount, getString, getString, getStrings, getStrings, hashCode, hasProperty, isValidName, toString, toString

Methods inherited from class java.lang.Object

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

Field Detail

ALL

public static final java.util.Set<java.lang.String> ALL

NONE

public static final java.util.Set<java.lang.String> NONE

Method Detail

wrap

@NotNull
public static @NotNull NodeState wrap(@NotNull
                                               @NotNull java.lang.String path,
                                               @NotNull
                                               @NotNull NodeState delegate,
                                               @Nullable
                                               @Nullable java.util.Set<java.lang.String> includePaths,
                                               @Nullable
                                               @Nullable java.util.Set<java.lang.String> excludePaths,
                                               @Nullable
                                               @Nullable java.util.Set<java.lang.String> fragmentPaths,
                                               @Nullable
                                               @Nullable java.util.Set<java.lang.String> excludedFragments,
                                               boolean referenceableFrozenNodes)

Factory method that conditionally decorates the given node-state iff the node-state is (a) hidden itself or (b) has hidden descendants.

Parameters:

path - The path where the node-state should be assumed to be located.

delegate - The node-state to decorate.

includePaths - A Set of paths that should be visible. Defaults to ["/"] if null.

excludePaths - A Set of paths that should be hidden. Empty if null.

fragmentPaths - A Set of paths that should support the fragments (see below). Empty if null.

excludedFragments - A Set of name fragments that should be hidden. Empty if null.

referenceableFrozenNodes - Whether nt:frozenNode are referenceable on the target.

Returns:

The decorated node-state if required, the original node-state if decoration is unnecessary.

decorateChild

@NotNull
protected @NotNull NodeState decorateChild(@NotNull
                                                    @NotNull java.lang.String name,
                                                    @NotNull
                                                    @NotNull NodeState child)

Specified by:

decorateChild in class AbstractDecoratedNodeState

hideChild

protected boolean hideChild(@NotNull
                            @NotNull java.lang.String name,
                            @NotNull
                            @NotNull NodeState delegateChild)

Overrides:

hideChild in class AbstractDecoratedNodeState

decorateProperty

protected PropertyState decorateProperty(@NotNull
                                         @NotNull PropertyState propertyState)

Specified by:

decorateProperty in class AbstractDecoratedNodeState