public interface NodeStore
This is a low-level interface that doesn't cover functionality like merging concurrent changes or rejecting new tree states based on some higher-level consistency constraints.
Modifier and Type | Method and Description |
---|---|
String |
checkpoint(long lifetime)
Creates a new checkpoint of the latest root of the tree.
|
String |
checkpoint(long lifetime,
Map<String,String> properties)
Creates a new checkpoint of the latest root of the tree.
|
Map<String,String> |
checkpointInfo(String checkpoint)
Retrieve the properties associated with a checkpoint.
|
Blob |
createBlob(InputStream inputStream)
Create a
Blob from the given input stream. |
Blob |
getBlob(String reference)
Get a blob by its reference.
|
NodeState |
getRoot()
Returns the latest state of the tree.
|
NodeState |
merge(NodeBuilder builder,
CommitHook commitHook,
CommitInfo info)
|
NodeState |
rebase(NodeBuilder builder)
|
boolean |
release(String checkpoint)
Releases the provided checkpoint.
|
NodeState |
reset(NodeBuilder builder)
Reset the passed
builder by throwing away all its changes and
setting its base state to the current root state. |
NodeState |
retrieve(String checkpoint)
Retrieves the root node from a previously created repository checkpoint.
|
NodeState getRoot()
NodeState merge(NodeBuilder builder, CommitHook commitHook, CommitInfo info) throws CommitFailedException
builder
- the builder whose changes to applycommitHook
- the commit hook to apply while merging changesinfo
- commit info associated with this merge operationCommitFailedException
- if the merge failedIllegalArgumentException
- if the builder is not acquired
from a root state of this storeNodeState rebase(NodeBuilder builder)
base
and
head
states
of the given builder on top of the current root state.
The base state of the given builder becomes the latest
root
state of the repository, and the
head state will contain the rebased changes.builder
- the builder to rebaseIllegalArgumentException
- if the builder is not acquired
from a root state of this storeNodeState reset(NodeBuilder builder)
builder
by throwing away all its changes and
setting its base state to the current root state.builder
- the builder to resetIllegalArgumentException
- if the builder is not acquired
from a root state of this storeBlob createBlob(InputStream inputStream) throws IOException
Blob
from the given input stream. The input stream
is closed after this method returns.inputStream
- The input stream for the Blob
Blob
representing inputStream
IOException
- If an error occurs while reading from the streamBlob getBlob(String reference)
reference
- reference to the blobnull
if the reference does not resolve to a blob.Blob.getReference()
String checkpoint(long lifetime, Map<String,String> properties)
The properties
passed to this methods are associated with the
checkpoint and can be retrieved through the checkpointInfo(String)
method. Its semantics is entirely application specific.
lifetime
- time (in milliseconds, > 0) that the checkpoint
should remain availableproperties
- properties to associate with the checkpointString checkpoint(long lifetime)
This method is a shortcut for checkpoint(long, Map)
passing
an empty map for its 2nd argument.
lifetime
- time (in milliseconds, > 0) that the checkpoint
should remain availableMap<String,String> checkpointInfo(String checkpoint)
checkpoint
- string reference of a checkpointcheckpoint
or an empty map when there is no such
checkpoint.NodeState retrieve(String checkpoint)
checkpoint
- string reference of a checkpointnull
if the checkpoint is no longer availableboolean release(String checkpoint)
true
.checkpoint
- string reference of a checkpointtrue
if the checkpoint was successfully removed, or if it doesn't exist"Copyright © 2006 - 2015 Adobe Systems Incorporated. All Rights Reserved"