org.apache.jackrabbit.oak.plugins.version

Class ReadWriteVersionManager

java.lang.Object

org.apache.jackrabbit.oak.plugins.version.ReadOnlyVersionManager

org.apache.jackrabbit.oak.plugins.version.ReadWriteVersionManager

public class ReadWriteVersionManager
extends ReadOnlyVersionManager

Extends the ReadOnlyVersionManager with methods to modify the version store.

Constructor Summary

Constructors

Constructor and Description
ReadWriteVersionManager(NodeBuilder versionStorageNode, NodeBuilder workspaceRoot)

Method Summary

Modifier and Type	Method and Description
protected String	calculateVersion(NodeBuilder history, NodeBuilder versionable) Copied from Apache Jackrabbit Core
void	checkin(NodeBuilder versionable)
void	checkout(NodeBuilder versionable)
protected ReadOnlyNodeTypeManager	getNodeTypeManager()
NodeBuilder	getOrCreateVersionHistory(NodeBuilder versionable, Map<String,Object> infoMap) Gets or creates the version history for the given versionable node.
protected Tree	getVersionStorage()
protected Root	getWorkspaceRoot() /**
void	removeVersionLabel(String historyRelPath, String label) Removes a version label from the jcr:versionLabels node of the referenced version history.
void	restore(NodeBuilder versionable, String versionUUID, org.apache.jackrabbit.oak.plugins.version.VersionSelector selector)

Methods inherited from class org.apache.jackrabbit.oak.plugins.version.ReadOnlyVersionManager

checkVersionable, getBaseVersion, getIdentifierManager, getInstance, getVersion, getVersionable, getVersionHistory, getVersionHistoryPath, isCheckedOut, isVersionable, isVersionStoreTree

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ReadWriteVersionManager

public ReadWriteVersionManager(NodeBuilder versionStorageNode,
                               NodeBuilder workspaceRoot)

Method Detail

getVersionStorage

@Nonnull
protected Tree getVersionStorage()

Specified by:

getVersionStorage in class ReadOnlyVersionManager

Returns:

the read-only Tree for the jcr:versionStorage node. The returned Tree instance must be up-to-date with the Root returned by ReadOnlyVersionManager.getWorkspaceRoot().

getWorkspaceRoot

@Nonnull
protected Root getWorkspaceRoot()

Description copied from class: ReadOnlyVersionManager

/**

Specified by:

getWorkspaceRoot in class ReadOnlyVersionManager

Returns:

the Root of the workspace.

getNodeTypeManager

@Nonnull
protected ReadOnlyNodeTypeManager getNodeTypeManager()

Specified by:

getNodeTypeManager in class ReadOnlyVersionManager

Returns:

the node type manager of this repository.

getOrCreateVersionHistory

@Nonnull
public NodeBuilder getOrCreateVersionHistory(@Nonnull
                                                       NodeBuilder versionable,
                                                       @Nonnull
                                                       Map<String,Object> infoMap)
                                                throws CommitFailedException

Gets or creates the version history for the given versionable node.

Parameters:

versionable - the versionable node.

infoMap - The additional information as provided by CommitInfo.getInfo()

Returns:

the version history node.

Throws:

IllegalArgumentException - if the given node does not have a jcr:uuid property.

CommitFailedException

checkout

public void checkout(NodeBuilder versionable)

checkin

public void checkin(@Nonnull
                    NodeBuilder versionable)
             throws CommitFailedException

Throws:

CommitFailedException

restore

public void restore(@Nonnull
                    NodeBuilder versionable,
                    @Nonnull
                    String versionUUID,
                    @Nullable
                    org.apache.jackrabbit.oak.plugins.version.VersionSelector selector)
             throws CommitFailedException

Throws:

CommitFailedException

removeVersionLabel

public void removeVersionLabel(@Nonnull
                               String historyRelPath,
                               @Nonnull
                               String label)
                        throws CommitFailedException

Removes a version label from the jcr:versionLabels node of the referenced version history.

Parameters:

historyRelPath - relative path from the jcr:versionStorage node to the version history node.

label - the version label.

Throws:

CommitFailedException - if there is no such version history or if there is no label with the given name.

calculateVersion

protected String calculateVersion(@Nonnull
                                  NodeBuilder history,
                                  @Nonnull
                                  NodeBuilder versionable)
                           throws IllegalStateException

Copied from Apache Jackrabbit Core

Calculates the name of the new version that will be created by a checkin call. The name is determined as follows:

• first the predecessor version with the shortest name is searched.
• if that predecessor version is the root version, the new version gets the name "{number of successors}+1" + ".0"
• if that predecessor version has no successor, the last digit of it's version number is incremented.
• if that predecessor version has successors but the incremented name does not exist, that name is used.
• otherwise a ".0" is added to the name until a non conflicting name is found.

Example Graph:

 jcr:rootVersion
  |     |
 1.0   2.0
  |
 1.1
  |
 1.2 ---\  ------\
  |      \        \
 1.3   1.2.0   1.2.0.0
  |      |
 1.4   1.2.1 ----\
  |      |        \
 1.5   1.2.2   1.2.1.0
  |      |        |
 1.6     |     1.2.1.1
  |-----/
 1.7
 

Parameters:

history - the version history

versionable - the node to checkin

Returns:

the new version name

Throws:

IllegalStateException - if mandatory version properties are missing.