org.apache.jackrabbit.oak.spi.state

Interface NodeStoreBranch

public interface NodeStoreBranch

An instance of this class represents a private branch of the tree in a NodeStore to which transient changes can be applied and later merged back or discarded.

Method Summary

Modifier and Type	Method and Description
NodeState	getBase() Returns the base state of this branch.
NodeState	getHead() Returns the head state of this branch.
NodeState	merge(CommitHook hook, CommitInfo info) Merges the changes in this branch to the main content tree.
void	rebase() Rebase the changes from this branch on top of the current root.
void	setRoot(NodeState newRoot) Updates the state of the content tree of this private branch.

Method Detail

getBase

@Nonnull
NodeState getBase()

Returns the base state of this branch. The base state is the state of the tree as it was at the time this branch was created.

Returns:

root node state

getHead

@Nonnull
NodeState getHead()

Returns the head state of this branch. The head state is the state resulting from the base state by applying all subsequent modifications to this branch by setRoot(NodeState).

Returns:

root node state

Throws:

IllegalStateException - if the branch is already merged

setRoot

void setRoot(NodeState newRoot)

Updates the state of the content tree of this private branch.

Parameters:

newRoot - new root node state

Throws:

IllegalStateException - if the branch is already merged

merge

@Nonnull
NodeState merge(@Nonnull
                         CommitHook hook,
                         @Nonnull
                         CommitInfo info)
                  throws org.apache.jackrabbit.oak.api.CommitFailedException

Merges the changes in this branch to the main content tree. Merging is done by rebasing the changes in this branch on top of the current head revision followed by a fast forward merge.

Parameters:

hook - the commit hook to apply while merging changes

info - commit info associated with this merge operation

Returns:

the node state resulting from the merge.

Throws:

org.apache.jackrabbit.oak.api.CommitFailedException - if the merge failed

IllegalStateException - if the branch is already merged

rebase

void rebase()

Rebase the changes from this branch on top of the current root.