svn commit: r1363323 - /jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Tree.java

[an...@apache.org]

Author: angela
Date: Thu Jul 19 13:12:29 2012
New Revision: 1363323

URL: http://svn.apache.org/viewvc?rev=1363323&view=rev
Log:
OAK-194: Define behavior of Tree#getProperty(String) in case of lack of access
OAK-195: State that Tree#hasProperty returns false of the property is not accessible

Modified:
    jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Tree.java

Modified: jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Tree.java
URL: http://svn.apache.org/viewvc/jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Tree.java?rev=1363323&r1=1363322&r2=1363323&view=diff
==============================================================================
--- jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Tree.java (original)
+++ jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Tree.java Thu Jul 19 13:12:29 2012
@@ -98,9 +98,10 @@ public interface Tree {
 
     /**
      * Get a property state
-     * @param name name of the property state
-     * @return  the property state with the given {@code name} or {@code null}
-     *          if no such property state exists.
+     *
+     * @param name The name of the property state.
+     * @return the property state with the given {@code name} or {@code null}
+     * if no such property state exists or the property is not accessible.
      */
     @CheckForNull
     PropertyState getProperty(String name);
@@ -115,10 +116,11 @@ public interface Tree {
     Status getPropertyStatus(String name);
 
     /**
-     * Determine if a property state exists
-     * @param name  name of the property state
-     * @return  {@code true} if and only if a property with the given {@code name}
-     *          exists.
+     * Determine if a property state exists and is accessible.
+     *
+     * @param name The name of the property state
+     * @return {@code true} if and only if a property with the given {@code name}
+     *          exists and is accessible.
      */
     boolean hasProperty(String name);