Package org.apache.jackrabbit.api

Interface JackrabbitSession

All Superinterfaces:
Session
All Known Implementing Classes:
SessionImpl
@ProviderType public interface JackrabbitSession extends Session
Jackrabbit specific extension of the JCR Session interface.

  • Field Details

  • Method Details

    • hasPermission

      boolean hasPermission(@NotNull @NotNull String absPath, @NotNull @NotNull String... actions) throws RepositoryException
      Returns true if this Session has permission to perform the specified actions at the specified absPath and false otherwise.

      The actions parameter is a list of action strings. Apart from the actions defined on Session, this variant also allows to specify the following additional actions to provide better permission discovery:

      • add_property: If hasPermission(path, "add_property") returns true, then this Session has permission to add a new property at path.
      • modify_property: If hasPermission(path, "modify_property") returns true, then this Session has permission to change a property at path.
      • remove_property: If hasPermission(path, "remove_property") returns true, then this Session has permission to remove a property at path.
      • remove_node: If hasPermission(path, "remove_node") returns true, then this Session has permission to remove a node at path.
      • node_type_management: If hasPermission(path, "node_type_management") returns true, then this Session has permission to explicitly set or change the node type information associated with a node at path.
      • versioning: If hasPermission(path, "versioning") returns true, then this Session has permission to perform version related operations on a node at path.
      • locking: If hasPermission(path, "locking") returns true, then this Session has permission to lock and unlock a node at path.
      • read_access_control: If hasPermission(path, "read_access_control") returns true, then this Session has permission to read access control content stored at an item at path.
      • modify_access_control: If hasPermission(path, "modify_access_control") returns true, then this Session has permission to modify access control content at an item at path.
      • user_management: If hasPermission(path, "user_management") returns true, then this Session has permission to perform user management operations at an item at path.
      When more than one action is specified, this method will only return true if this Session has permission to perform all of the listed actions at the specified path.

      The information returned through this method will only reflect the permission status (both JCR defined and implementation-specific) and not other restrictions that may exist, such as node type or other implementation enforced constraints. For example, even though hasPermission may indicate that a particular Session may add a property at /A/B/C, the node type of the node at /A/B may prevent the addition of a property called C.

      Parameters:
      absPath - an absolute path.
      actions - one or several actions.
      Returns:
      true if this Session has permission to perform the specified actions at the specified absPath.
      Throws:
      RepositoryException - if an error occurs.
      See Also:

    • getPrincipalManager

      PrincipalManager getPrincipalManager() throws AccessDeniedException, UnsupportedRepositoryOperationException, RepositoryException
      Returns the PrincipalManager for the current Session.
      Returns:
      the PrincipalManager associated with this Session.
      Throws:
      AccessDeniedException - If the session lacks privileges to access the principal manager or principals in general.
      UnsupportedRepositoryOperationException - If principal management is not supported.
      RepositoryException - If another error occurs.
      See Also:

    • getUserManager

      UserManager getUserManager() throws AccessDeniedException, UnsupportedRepositoryOperationException, RepositoryException
      Returns the UserManager for the current Session.
      Returns:
      the UserManager associated with this Session.
      Throws:
      AccessDeniedException - If this session is not allowed to to access user data.
      UnsupportedRepositoryOperationException - If user management is not supported.
      RepositoryException - If another error occurs.
      See Also:

    • getItemOrNull

      Item getItemOrNull(String absPath) throws RepositoryException
      Returns the node at the specified absolute path in the workspace. If no such node exists, then it returns the property at the specified path. If no such property exists, then it return null.
      Parameters:
      absPath - An absolute path.
      Returns:
      the specified Item or null.
      Throws:
      RepositoryException - if another error occurs.
      Since:
      2.11.1

    • getPropertyOrNull

      Property getPropertyOrNull(String absPath) throws RepositoryException
      Returns the property at the specified absolute path in the workspace or null if no such node exists.
      Parameters:
      absPath - An absolute path.
      Returns:
      the specified Property or null.
      Throws:
      RepositoryException - if another error occurs.
      Since:
      2.11.1

    • getNodeOrNull

      Node getNodeOrNull(String absPath) throws RepositoryException
      Returns the node at the specified absolute path in the workspace or null if no such node exists.
      Parameters:
      absPath - An absolute path.
      Returns:
      the specified Node or null.
      Throws:
      RepositoryException - If another error occurs.
      Since:
      2.11.1

    • getParentOrNull

      @Nullable default @Nullable Node getParentOrNull(@NotNull @NotNull Item item) throws RepositoryException
      Returns the parent of the given Item or null if no parent exists (either because the given Item represents the root node or the current session does not have sufficient access to retrieve the parent).
      Parameters:
      item - An Item that has been obtained by the current session.
      Returns:
      The parent node of the given Item or null.
      Throws:
      RepositoryException - If another error occurs.
      Since:
      1.42
      See Also:

    • getExpandedName

      @NotNull @NotNull String getExpandedName(@NotNull @NotNull Item item) throws RepositoryException
      Returns the expanded name of the given Item.
      Parameters:
      item - the item for which to retrieve the name
      Returns:
      the name of the item in expanded form.
      Throws:
      NamespaceException - when no expanded name can be determined (for instance, if the registered namespace (name) is invalid)
      RepositoryException - if another error occurs
      Since:
      1.78.0
      See Also:

    • getExpandedPath

      @NotNull @NotNull String getExpandedPath(@NotNull @NotNull Item item) throws RepositoryException
      Returns the expanded path of the given Item.
      Parameters:
      item - the item for which to retrieve the name
      Returns:
      the path of the item in expanded form.
      Throws:
      NamespaceException - when no expanded name can be determined (for instance, if the registered namespace (name) is invalid)
      RepositoryException - if another error occurs.
      Since:
      1.78.0
      See Also:

    • getBoundPrincipals

      @NotNull default @NotNull Set<Principal> getBoundPrincipals() throws RepositoryException
      Returns the set of principals associated with this session.
      Returns:
      the set of principals associated with this session. Usually this set is unmodifiable.
      Throws:
      RepositoryException - in case principal information cannot be retrieved.
      IllegalStateException - if user information is not available or if the user is a system user.
      Since:
      1.84