You are viewing a plain text version of this content. The canonical link for it is here.
Posted to oak-commits@jackrabbit.apache.org by mr...@apache.org on 2018/05/23 07:47:29 UTC

svn commit: r1832079 - /jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences.md

Author: mreutegg
Date: Wed May 23 07:47:29 2018
New Revision: 1832079

URL: http://svn.apache.org/viewvc?rev=1832079&view=rev
Log:
OAK-301 - Document Oak

Add compatibility note about JCR namespaces in Oak

Modified:
    jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences.md

Modified: jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences.md
URL: http://svn.apache.org/viewvc/jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences.md?rev=1832079&r1=1832078&r2=1832079&view=diff
==============================================================================
--- jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences.md (original)
+++ jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences.md Wed May 23 07:47:29 2018
@@ -270,6 +270,17 @@ Manually adding a property with the name
 unexpected effects as Oak maintains an unique index on `jcr:uuid` properties. As the namespace
 `jcr` is reserved, doing so is strongly discouraged.
 
+Namespaces
+----------
+
+JCR namespace support is mostly compatible with Jackrabbit 2.x. However, Oak
+does not support remapping an existing namespace URI to a different prefix in
+the namespace registry. Once registered, such a repository wide namespace prefix
+to namespace URI mapping cannot be changed through the namespace registry
+anymore. The mapping *can* be changed on a per session level, but this remapping
+is only visible to the current session and bound to the session lifetime. See
+[`Session.setNamespacePrefix(String, String)`][0].
+
 Versioning
 ----------
 
@@ -305,4 +316,6 @@ Node Name Length Limit
 
 With the document storage backend (MongoDB, RDBMS), there is currently 
 a limit of 150 UTF-8 bytes on the length of the node names.
-See also OAK-2644.
\ No newline at end of file
+See also OAK-2644.
+
+[0]: https://docs.adobe.com/content/docs/en/spec/jsr170/javadocs/jcr-2.0/javax/jcr/Session.html#setNamespacePrefix(java.lang.String,%20java.lang.String)