svn commit: r1577564 - in /sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource: ModifiableValueMap.java PersistableValueMap.java ValueMap.java

[cz...@apache.org]

Author: cziegeler
Date: Fri Mar 14 15:06:27 2014
New Revision: 1577564

URL: http://svn.apache.org/r1577564
Log:
SLING-3451 : Support for deep reads from a value map

Modified:
    sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/ModifiableValueMap.java
    sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/PersistableValueMap.java
    sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/ValueMap.java

Modified: sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/ModifiableValueMap.java
URL: http://svn.apache.org/viewvc/sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/ModifiableValueMap.java?rev=1577564&r1=1577563&r2=1577564&view=diff
==============================================================================
--- sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/ModifiableValueMap.java (original)
+++ sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/ModifiableValueMap.java Fri Mar 14 15:06:27 2014
@@ -54,7 +54,7 @@ import aQute.bnd.annotation.ConsumerType
  *
  * A modifiable value map should value {@link ResourceResolver#PROPERTY_RESOURCE_TYPE}
  * to set the resource type of a resource.
- *
+ * <p>
  * A modifiable value map must not support deep writes. A call of a modification method
  * with a path should result in an IllegalArgumentException.
  *

Modified: sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/PersistableValueMap.java
URL: http://svn.apache.org/viewvc/sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/PersistableValueMap.java?rev=1577564&r1=1577563&r2=1577564&view=diff
==============================================================================
--- sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/PersistableValueMap.java (original)
+++ sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/PersistableValueMap.java Fri Mar 14 15:06:27 2014
@@ -22,10 +22,13 @@ package org.apache.sling.api.resource;
  * The <code>PersistableValueMap</code> is an extension
  * of the {@link ValueMap} which allows to modify and
  * persist the properties.
- *
+ * <p>
  * Note, that each time you call {@link Resource#adaptTo(Class)}
  * you get a new map instance which does not share modified
  * properties with other representations.
+ * <p>
+ * A <code>PersistableValueMap</code> might not support deep
+ * reading of values.
  *
  * @deprecated Use the {@link ModifiableValueMap} instead.
  */

Modified: sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/ValueMap.java
URL: http://svn.apache.org/viewvc/sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/ValueMap.java?rev=1577564&r1=1577563&r2=1577564&view=diff
==============================================================================
--- sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/ValueMap.java (original)
+++ sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/ValueMap.java Fri Mar 14 15:06:27 2014
@@ -27,9 +27,10 @@ import aQute.bnd.annotation.ConsumerType
 
 /**
  * The <code>ValueMap</code> is an easy way to access properties of a resource.
- * With resources you can use {@link Resource#adaptTo(Class)} to adapt the
- * resource to a value map. The various getter methods can be used to get the
+ * With resources you can use {@link Resource#getValueMap()} to obtain the
+ * value map of a resource. The various getter methods can be used to get the
  * properties of the resource.
+ * <p>
  * In addition a value map returned by a resource supports getting of deep
  * values, like get("content/title") which is equivalent to call
  * getChild("content") on the resource, get the value map of that resource