public class MemoryNodeBuilder extends 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(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 |
---|---|
NodeBuilder |
child(String name)
Returns a builder for constructing changes to the named child node.
|
Blob |
createBlob(InputStream stream) |
boolean |
exists()
Checks whether this builder represents a node that exists.
|
NodeState |
getBaseState()
Returns the original base state that this builder is modifying.
|
boolean |
getBoolean(String name)
Returns the boolean value of the named property.
|
NodeBuilder |
getChildNode(String name)
Returns a builder for constructing changes to the named child node.
|
long |
getChildNodeCount(long max)
Returns the current number of child nodes.
|
Iterable<String> |
getChildNodeNames()
Returns the names of current child nodes.
|
String |
getName(String name)
Returns the name value of the named property.
|
Iterable<String> |
getNames(String name)
Returns the name values of the named property.
|
NodeState |
getNodeState()
Returns an immutable node state that matches the current state of
the builder.
|
String |
getPath() |
Iterable<? extends PropertyState> |
getProperties()
Returns the current properties.
|
PropertyState |
getProperty(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.
|
String |
getString(String name)
Returns the name value of the named property.
|
boolean |
hasChildNode(String name)
Checks whether the named child node currently exists.
|
boolean |
hasProperty(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(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(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 |
moveTo(NodeBuilder newParent,
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.
|
NodeBuilder |
removeProperty(String name)
Remove the named property.
|
void |
reset(NodeState newBase)
Throws away all changes in this builder and resets the base to the
given node state.
|
NodeBuilder |
setChildNode(String name)
Adds the named child node and returns a builder for modifying it.
|
NodeBuilder |
setChildNode(String name,
NodeState state)
Adds or replaces a subtree.
|
NodeBuilder |
setProperty(PropertyState property)
Set a property state
|
<T> NodeBuilder |
setProperty(String name,
T value)
Set a property state
|
<T> NodeBuilder |
setProperty(String name,
T value,
Type<T> type)
Set a property state
|
String |
toString() |
public MemoryNodeBuilder(NodeState base)
base
state.base
- base state of the new builderpublic void reset(NodeState newBase)
newBase
- new base statepublic NodeState getNodeState()
NodeBuilder
getNodeState
in interface NodeBuilder
public 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(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(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 valuepublic Iterable<String> getChildNodeNames()
NodeBuilder
getChildNodeNames
in interface NodeBuilder
public boolean hasChildNode(String name)
NodeBuilder
hasChildNode
in interface NodeBuilder
name
- child node nametrue
if the named child node exists,
false
otherwisepublic NodeBuilder child(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 nodepublic NodeBuilder getChildNode(String name)
NodeBuilder
IllegalStateException
s to be thrown.getChildNode
in interface NodeBuilder
name
- name of the child nodepublic NodeBuilder setChildNode(String name)
NodeBuilder
setChildNode
in interface NodeBuilder
name
- name of the child nodepublic NodeBuilder setChildNode(String name, 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(NodeBuilder newParent, String newName) throws 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
otherwiseIllegalArgumentException
- if the given name string is empty
or contains the forward slash characterpublic long getPropertyCount()
NodeBuilder
getPropertyCount
in interface NodeBuilder
public Iterable<? extends PropertyState> getProperties()
NodeBuilder
getProperties
in interface NodeBuilder
public boolean hasProperty(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(String name)
NodeBuilder
null
if the property is not set.getProperty
in interface NodeBuilder
name
- property namepublic boolean getBoolean(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
public String getString(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
public String getName(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
public Iterable<String> getNames(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 namepublic NodeBuilder setProperty(PropertyState property)
NodeBuilder
setProperty
in interface NodeBuilder
property
- The property state to setpublic <T> NodeBuilder setProperty(String name, 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 propertypublic <T> NodeBuilder setProperty(String name, 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 propertypublic NodeBuilder removeProperty(String name)
NodeBuilder
name
does not exist.removeProperty
in interface NodeBuilder
name
- name of the propertypublic Blob createBlob(InputStream stream) throws IOException
createBlob
in interface NodeBuilder
IOException
public final String getPath()
"Copyright © 2006 - 2015 Adobe Systems Incorporated. All Rights Reserved"