(jackrabbit) branch trunk updated: JCR-5096: JcrConstants: refer to the constants in javax.jcr.Property and javax.jcr.nodetype.NodeType (#214)

[re...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

reschke pushed a commit to branch trunk
in repository https://gitbox.apache.org/repos/asf/jackrabbit.git


The following commit(s) were added to refs/heads/trunk by this push:
     new 85e5d0cca JCR-5096: JcrConstants: refer to the constants in javax.jcr.Property and javax.jcr.nodetype.NodeType (#214)
85e5d0cca is described below

commit 85e5d0cca855a2a4c43972fb2f97042a6b81e7e3
Author: Julian Reschke <re...@apache.org>
AuthorDate: Wed Aug 7 15:22:48 2024 +0200

    JCR-5096: JcrConstants: refer to the constants in javax.jcr.Property and javax.jcr.nodetype.NodeType (#214)
---
 .../src/main/java/org/apache/jackrabbit/JcrConstants.java  | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/jackrabbit-jcr-commons/src/main/java/org/apache/jackrabbit/JcrConstants.java b/jackrabbit-jcr-commons/src/main/java/org/apache/jackrabbit/JcrConstants.java
index 3b15c90d8..d66c1313e 100644
--- a/jackrabbit-jcr-commons/src/main/java/org/apache/jackrabbit/JcrConstants.java
+++ b/jackrabbit-jcr-commons/src/main/java/org/apache/jackrabbit/JcrConstants.java
@@ -19,11 +19,19 @@ package org.apache.jackrabbit;
 import javax.jcr.Session;
 
 /**
- * This Interface defines some of the item names that are defined in the
- * jcr spec 1.0, using the default prefixes 'jcr', 'nt' and 'mix'. Please note
- * that those prefixes can by redefined by an application using the
+ * This interface defines some of the item names that are defined in the <a
+ * href=https://s.apache.org/jcr-1.0-javadoc/">JCR Specification 1.0</a>, using
+ * the default prefixes 'jcr', 'nt' and 'mix'.
+ * <p>
+ * Please note that those prefixes can by redefined by an application using the
  * {@link Session#setNamespacePrefix(String, String)} method. As a result, the
  * constants may not refer to the respective items.
+ * <p>
+ * On the other hand, the constants in {@link javax.jcr.nodetype.NodeType} and
+ * {@link javax.jcr.Property} are more complete (covering
+ * <a href="https://s.apache.org/jcr-2.0-javadoc/">JCR 2.0</a> as well) and also
+ * define names using <i>expanded</i> form, which is immune to session local
+ * remappings.
  */
 public interface JcrConstants {
     /**