Package org.apache.jackrabbit.oak.namepath

Interface NameMapper

All Known Subinterfaces:
NamePathMapper
All Known Implementing Classes:
GlobalNameMapper, LocalNameMapper, NamePathMapper.Default, NamePathMapperImpl
@ProviderType public interface NameMapper
TODO document

  • Method Summary

    Modifier and Type
    Method
    Description
    @NotNull String
    getJcrName(@NotNull String oakName)
    Returns the JCR name for the given Oak name.
    @NotNull String
    getOakName(@NotNull String jcrName)
    Returns the Oak name for the specified JCR name.
    @Nullable String
    getOakNameOrNull(@NotNull String jcrName)
    Returns the Oak name for the given JCR name, or null if no such mapping exists because the given JCR name contains an unknown namespace URI or prefix, or is otherwise invalid.
    @NotNull Map<String,String>
    getSessionLocalMappings()
    Returns the local namespace prefix mappings, or an empty map if there aren't any local mappings.

  • Method Details

    • getOakNameOrNull

      @Nullable @Nullable String getOakNameOrNull(@NotNull @NotNull String jcrName)
      Returns the Oak name for the given JCR name, or null if no such mapping exists because the given JCR name contains an unknown namespace URI or prefix, or is otherwise invalid.
      Parameters:
      jcrName - JCR name
      Returns:
      Oak name, or null

    • getOakName

      @NotNull @NotNull String getOakName(@NotNull @NotNull String jcrName) throws RepositoryException
      Returns the Oak name for the specified JCR name. In contrast to getOakNameOrNull(String) this method will throw a RepositoryException if the JCR name is invalid and cannot be resolved.
      Parameters:
      jcrName - The JCR name to be converted.
      Returns:
      A valid Oak name.
      Throws:
      RepositoryException - If the JCR name cannot be resolved.

    • getSessionLocalMappings

      @NotNull @NotNull Map<String,String> getSessionLocalMappings()
      Returns the local namespace prefix mappings, or an empty map if there aren't any local mappings.
      Returns:
      local namespace prefix to URI mappings

    • getJcrName

      @NotNull @NotNull String getJcrName(@NotNull @NotNull String oakName)
      Returns the JCR name for the given Oak name. The given name is expected to have come from a valid Oak repository that contains only valid names with proper namespace mappings. If that's not the case, either a programming error or a repository corruption has occurred and an appropriate unchecked exception gets thrown.
      Parameters:
      oakName - Oak name
      Returns:
      JCR name