public class MemoryNodeBuilder extends java.lang.Object implements NodeBuilder
A MemoryNodeBuilder
instance tracks uncommitted changes without
relying on weak references or requiring hard references on the entire
accessed subtree. It does this by relying on MutableNodeState
instances for tracking uncommitted changes and on Head
instances for tracking the connectedness of the builder. A builder keeps
a reference to the parent builder and knows its own name, which is used
to check for relevant changes in its parent builder and update its state
accordingly.
A builder is in one of three possible states, which is tracked within
its Head
instance:
MutableNodeState
instance. Before each access the connected builder checks whether its
parents base state has been reset and if so, resets its own base state
accordingly.
Constructor and Description |
---|
MemoryNodeBuilder(@NotNull NodeState base)
Creates a new in-memory node state builder rooted at
and based on the passed
base state. |
Modifier and Type | Method and Description |
---|---|
@NotNull NodeBuilder |
child(@NotNull java.lang.String name)
Returns a builder for constructing changes to the named child node.
|
Blob |
createBlob(java.io.InputStream stream) |
boolean |
exists()
Checks whether this builder represents a node that exists.
|
@NotNull NodeState |
getBaseState()
Returns the original base state that this builder is modifying.
|
boolean |
getBoolean(@NotNull java.lang.String name)
Returns the boolean value of the named property.
|
@NotNull NodeBuilder |
getChildNode(@NotNull java.lang.String name)
Returns a builder for constructing changes to the named child node.
|
long |
getChildNodeCount(long max)
Returns the current number of child nodes.
|
@NotNull java.lang.Iterable<java.lang.String> |
getChildNodeNames()
Returns the names of current child nodes.
|
@Nullable java.lang.String |
getName(@NotNull java.lang.String name)
Returns the name value of the named property.
|
@NotNull java.lang.Iterable<java.lang.String> |
getNames(@NotNull java.lang.String name)
Returns the name values of the named property.
|
@NotNull NodeState |
getNodeState()
Returns an immutable node state that matches the current state of
the builder.
|
java.lang.String |
getPath() |
@NotNull java.lang.Iterable<? extends PropertyState> |
getProperties()
Returns the current properties.
|
PropertyState |
getProperty(java.lang.String name)
Returns the current state of the named property, or
null
if the property is not set. |
long |
getPropertyCount()
Returns the current number of properties.
|
@Nullable java.lang.String |
getString(@NotNull java.lang.String name)
Returns the name value of the named property.
|
boolean |
hasChildNode(@NotNull java.lang.String name)
Checks whether the named child node currently exists.
|
boolean |
hasProperty(java.lang.String name)
Checks whether the named property exists.
|
boolean |
isModified()
Check whether this builder represents a modified node, which has either modified properties
or removed or added child nodes.
|
boolean |
isNew()
Check whether this builder represents a new node, which is not present in the base state.
|
boolean |
isNew(java.lang.String name)
Check whether the named property is new, i.e.
|
boolean |
isReplaced()
Check whether this builder represents a node that used to exist but
was then replaced with other content, for example as a result of
a
NodeBuilder.setChildNode(String) call. |
boolean |
isReplaced(java.lang.String name)
Check whether the named property exists in the base state but is
replaced with other content, for example as a result of
a
NodeBuilder.setProperty(PropertyState) call. |
boolean |
isRoot() |
boolean |
moveTo(@NotNull NodeBuilder newParent,
@NotNull java.lang.String newName)
This implementation has the same semantics as adding this node
with name
newName as a new child of newParent followed
by removing this node. |
boolean |
remove()
Remove this child node from its parent.
|
@NotNull NodeBuilder |
removeProperty(java.lang.String name)
Remove the named property.
|
void |
reset(@NotNull NodeState newBase)
Throws away all changes in this builder and resets the base to the
given node state.
|
@NotNull NodeBuilder |
setChildNode(@NotNull java.lang.String name)
Adds the named child node and returns a builder for modifying it.
|
@NotNull NodeBuilder |
setChildNode(@NotNull java.lang.String name,
@NotNull NodeState state)
Adds or replaces a subtree.
|
@NotNull NodeBuilder |
setProperty(@NotNull PropertyState property)
Set a property state
|
<T> @NotNull NodeBuilder |
setProperty(java.lang.String name,
T value)
Set a property state
|
<T> @NotNull NodeBuilder |
setProperty(java.lang.String name,
T value,
Type<T> type)
Set a property state
|
java.lang.String |
toString() |
public MemoryNodeBuilder(@NotNull @NotNull NodeState base)
base
state.base
- base state of the new builderpublic final boolean isRoot()
true
iff this is the root builderpublic void reset(@NotNull @NotNull NodeState newBase)
newBase
- new base state@NotNull public @NotNull NodeState getNodeState()
NodeBuilder
getNodeState
in interface NodeBuilder
@NotNull public @NotNull NodeState getBaseState()
NodeBuilder
exists
method
returns false
) if this builder represents a new node that
didn't exist in the base content tree.getBaseState
in interface NodeBuilder
public boolean exists()
NodeBuilder
exists
in interface NodeBuilder
true
if the node exists, false
otherwisepublic boolean isNew()
NodeBuilder
isNew
in interface NodeBuilder
true
for a new nodepublic boolean isNew(java.lang.String name)
NodeBuilder
isNew
in interface NodeBuilder
name
- property nametrue
for a new propertypublic boolean isModified()
NodeBuilder
isModified
in interface NodeBuilder
true
for a modified nodepublic boolean isReplaced()
NodeBuilder
NodeBuilder.setChildNode(String)
call.isReplaced
in interface NodeBuilder
true
for a replaced nodepublic boolean isReplaced(java.lang.String name)
NodeBuilder
NodeBuilder.setProperty(PropertyState)
call.isReplaced
in interface NodeBuilder
name
- property nametrue
for a replaced propertypublic long getChildNodeCount(long max)
NodeBuilder
If an implementation does know the exact value, it returns it (even if the value is higher than max). If the implementation does not know the exact value, and the child node count is higher than max, it may return Long.MAX_VALUE. The cost of the operation is at most O(max).
getChildNodeCount
in interface NodeBuilder
max
- the maximum value@NotNull public @NotNull java.lang.Iterable<java.lang.String> getChildNodeNames()
NodeBuilder
getChildNodeNames
in interface NodeBuilder
public boolean hasChildNode(@NotNull @NotNull java.lang.String name)
NodeBuilder
hasChildNode
in interface NodeBuilder
name
- child node nametrue
if the named child node exists,
false
otherwise@NotNull public @NotNull NodeBuilder child(@NotNull @NotNull java.lang.String name)
NodeBuilder
All updates to the returned child builder will implicitly affect
also this builder, as if a
setNode(name, childBuilder.getNodeState())
method call
had been made after each update. Repeated calls to this method with
the same name will return the same child builder instance until an
explicit NodeBuilder.setChildNode(String, NodeState)
or
NodeBuilder.remove()
call is made, at which point the link
between this builder and a previously returned child builder for
that child node name will get broken.
child
in interface NodeBuilder
name
- name of the child node@NotNull public @NotNull NodeBuilder getChildNode(@NotNull @NotNull java.lang.String name)
NodeBuilder
IllegalStateException
s to be thrown.getChildNode
in interface NodeBuilder
name
- name of the child node@NotNull public @NotNull NodeBuilder setChildNode(@NotNull @NotNull java.lang.String name)
NodeBuilder
setChildNode
in interface NodeBuilder
name
- name of the child node@NotNull public @NotNull NodeBuilder setChildNode(@NotNull @NotNull java.lang.String name, @NotNull @NotNull NodeState state)
NodeBuilder
setChildNode
in interface NodeBuilder
name
- name of the child node containing the new subtreestate
- subtreepublic boolean remove()
NodeBuilder
remove
in interface NodeBuilder
true
for existing nodes, false
otherwisepublic boolean moveTo(@NotNull @NotNull NodeBuilder newParent, @NotNull @NotNull java.lang.String newName) throws java.lang.IllegalArgumentException
newName
as a new child of newParent
followed
by removing this node. As a consequence this implementation allows
moving this node into the subtree rooted here, the result of which
is the same as removing this node.
See also the general contract
for MoveTo
.
moveTo
in interface NodeBuilder
newParent
- builder for the new parent.newName
- name of this child at the new parenttrue
on success, false
otherwisejava.lang.IllegalArgumentException
- if the given name string is empty
or contains the forward slash characterpublic long getPropertyCount()
NodeBuilder
getPropertyCount
in interface NodeBuilder
@NotNull public @NotNull java.lang.Iterable<? extends PropertyState> getProperties()
NodeBuilder
getProperties
in interface NodeBuilder
public boolean hasProperty(java.lang.String name)
NodeBuilder
getProperty(name) != null
, but may be optimized
to avoid having to load the property value.hasProperty
in interface NodeBuilder
name
- property nametrue
if the named property exists,
false
otherwisepublic PropertyState getProperty(java.lang.String name)
NodeBuilder
null
if the property is not set.getProperty
in interface NodeBuilder
name
- property namepublic boolean getBoolean(@NotNull @NotNull java.lang.String name)
NodeBuilder
PropertyState property = builder.getProperty(name);
return property != null
&& property.getType() == Type.BOOLEAN
&& property.getValue(Type.BOOLEAN);
getBoolean
in interface NodeBuilder
name
- property namefalse
@Nullable public @Nullable java.lang.String getString(@NotNull @NotNull java.lang.String name)
NodeBuilder
PropertyState property = builder.getProperty(name);
if (property != null && property.getType() == Type.STRING) {
return property.getValue(Type.STRING);
} else {
return null;
}
getString
in interface NodeBuilder
name
- property namenull
@Nullable public @Nullable java.lang.String getName(@NotNull @NotNull java.lang.String name)
NodeBuilder
PropertyState property = builder.getProperty(name);
if (property != null && property.getType() == Type.NAME) {
return property.getValue(Type.NAME);
} else {
return null;
}
getName
in interface NodeBuilder
name
- property namenull
@NotNull public @NotNull java.lang.Iterable<java.lang.String> getNames(@NotNull @NotNull java.lang.String name)
NodeBuilder
PropertyState property = builder.getProperty(name);
if (property != null && property.getType() == Type.NAMES) {
return property.getValue(Type.NAMES);
} else {
return Collections.emptyList();
}
getNames
in interface NodeBuilder
name
- property name@NotNull public @NotNull NodeBuilder setProperty(@NotNull @NotNull PropertyState property)
NodeBuilder
setProperty
in interface NodeBuilder
property
- The property state to set@NotNull public <T> @NotNull NodeBuilder setProperty(java.lang.String name, @NotNull T value)
NodeBuilder
setProperty
in interface NodeBuilder
T
- The type of this property. Must be one of String, Blob, byte[], Long, Integer, Double, Boolean, BigDecimal
name
- The name of this propertyvalue
- The value of this property@NotNull public <T> @NotNull NodeBuilder setProperty(java.lang.String name, @NotNull T value, Type<T> type)
NodeBuilder
setProperty
in interface NodeBuilder
T
- The type of this property.name
- The name of this propertyvalue
- The value of this property@NotNull public @NotNull NodeBuilder removeProperty(java.lang.String name)
NodeBuilder
name
does not exist.removeProperty
in interface NodeBuilder
name
- name of the propertypublic Blob createBlob(java.io.InputStream stream) throws java.io.IOException
createBlob
in interface NodeBuilder
java.io.IOException
public final java.lang.String getPath()
public java.lang.String toString()
toString
in class java.lang.Object
Copyright © 2010 - 2020 Adobe. All Rights Reserved