Author: kwin
Date: Fri Mar  6 12:41:15 2015
New Revision: 1664603

URL: http://svn.apache.org/r1664603
Log:
SLING-4387 document validation of sub resources

Modified:
    sling/site/trunk/content/documentation/bundles/validation.mdtext

Modified: sling/site/trunk/content/documentation/bundles/validation.mdtext
URL: 
http://svn.apache.org/viewvc/sling/site/trunk/content/documentation/bundles/validation.mdtext?rev=1664603&r1=1664602&r2=1664603&view=diff
==============================================================================
--- sling/site/trunk/content/documentation/bundles/validation.mdtext (original)
+++ sling/site/trunk/content/documentation/bundles/validation.mdtext Fri Mar  6 
12:41:15 2015
@@ -24,6 +24,20 @@ To validate a resource one first needs t
         // give out error message that the validation model is invalid!
     }
     
+Apart from that it is also possible to validate resources including all child 
resources having their own validation model (i.e. a merged view of the 
validation models is applied). The appropriate validation model is being looked 
up by getting the resource type for each node. Since by default the JCR will 
return the primary type in case there is no `sling:resourceType` property found 
on the node, either the 2nd parameter `enforceValidation` should be set to 
`false` or some resource types must be explicitly ignored to also properly 
support validation models which have children on its own.
+
+    ::java
+    try {
+       ValidationResult result = 
validationService.validateAllResourceTypesInResource(resource, false, null);
+       if (!result.isValid()) {
+               // give out validation messages from result.get
+       }
+        
+    } catch (IllegalStateException e) {
+        // give out error message that an invalid validation model for at 
least one sub resource was found
+    } catch (IllegalArgumentException e) {
+        // one of the resource types is absolute or there was no validation 
model found for at least one sub resource
+    }
     
 # Validation Model Resources
 The `ValidationModel` is constructed from resources with the resourceType 
**sling/validation/model**. Those resources are considered validation model 
resources if they are located


Reply via email to