Class ReadOnlyVersionManager

  • Direct Known Subclasses:

    public abstract class ReadOnlyVersionManager
    extends Object
    ReadOnlyVersionManager provides implementations for read-only version operations modeled after the ones available in VersionManager.
    • Constructor Detail

      • ReadOnlyVersionManager

        public ReadOnlyVersionManager()
    • Method Detail

      • getInstance

        public static @NotNull ReadOnlyVersionManager getInstance​(Root root,
                                                                  NamePathMapper namePathMapper)
        Return a new instance of ReadOnlyVersionManager that reads version information from the tree at VersionConstants.VERSION_STORE_PATH.
        root - The root to read version information from.
        namePathMapper - The NamePathMapper to use.
        a new instance of ReadOnlyVersionManager.
      • isCheckedOut

        public boolean isCheckedOut​(@NotNull
                                    @NotNull Tree tree)
        Returns true if the tree is checked out; otherwise false. The root node is always considered checked out.
        tree - the tree to check.
        whether the tree is checked out or not.
      • getVersion

        public @Nullable Tree getVersion​(@NotNull
                                         @NotNull String uuid)
        Returns the version tree with the given uuid.
        uuid - the uuid of the version tree.
        the version tree or null if there is none.
      • getVersionHistoryPath

        public @NotNull String getVersionHistoryPath​(@NotNull
                                                     @NotNull String uuid)
        Returns the path of the version history for the given uuid. The returned path is relative to the version storage tree as returned by getVersionStorage().
        uuid - the uuid of the versionable node
        the relative path of the version history for the given uuid.
      • getBaseVersion

        public @Nullable Tree getBaseVersion​(@NotNull
                                             @NotNull Tree versionable)
                                      throws UnsupportedRepositoryOperationException,
        Returns the tree representing the base version of the given versionable tree or null if none exists yet. This is the case when a versionable node is created, but is not yet saved.
        versionable - the versionable tree.
        the tree representing the base version or null.
        UnsupportedRepositoryOperationException - if the versionable tree is not actually versionable.
        RepositoryException - if an error occurs while checking the node type of the tree.
      • isVersionStoreTree

        public static boolean isVersionStoreTree​(@NotNull
                                                 @NotNull Tree tree)
        Returns true if the specified tree has VersionConstants.REP_VERSIONSTORAGE defines as primary node type i.e. is part of the intermediate version storage structure that contains the version histories and the versions.
        tree - The tree to be tested.
        true if the target node has VersionConstants.REP_VERSIONSTORAGE defines as primary node type; false otherwise.
      • getVersionable

        public @Nullable Tree getVersionable​(@NotNull
                                             @NotNull Tree versionTree,
                                             @NotNull String workspaceName)
        Tries to retrieve the tree corresponding to specified versionTree outside of the version storage based on versionable path information stored with the version history. The following cases are distinguished:
        • Version History: If the given tree is a version history the associated versionable tree in the specified workspace is being returned based on the information stored in the versionable path property. If no versionable path property is present null is returned.
        • Version: Same as for version history.
        • Version Labels: Same as for version history.
        • Frozen Node: If the given tree forms part of a frozen node the path of the target node is computed from the versionable path and the relative path of the frozen node.
        • Other Nodes: If the specified tree is not part of the tree structure defined by a version history, null will be returned.
        Please note that this method will not verify if the tree at the versionable path or the computed subtree actually exists. This must be asserted by the caller before operating on the tree.
        versionTree - The tree from within the version storage for which that versionable correspondent should be retrieved.
        workspaceName - The name of the workspace for which the target should be retrieved.
        A existing or non-existing tree pointing to the location of the correspondent tree outside of the version storage or null if the versionable path property for the specified workspace is missing or if the given tree is not located within the tree structure defined by a version history.
        See Also: