svn commit: r1330569 - /sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/ResourceResolverFactory.java

[fm...@apache.org]

Author: fmeschbe
Date: Wed Apr 25 21:33:14 2012
New Revision: 1330569

URL: http://svn.apache.org/viewvc?rev=1330569&view=rev
Log:
Add note on using getAdministrativeResourceResolver

Modified:
    sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/ResourceResolverFactory.java

Modified: sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/ResourceResolverFactory.java
URL: http://svn.apache.org/viewvc/sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/ResourceResolverFactory.java?rev=1330569&r1=1330568&r2=1330569&view=diff
==============================================================================
--- sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/ResourceResolverFactory.java (original)
+++ sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/ResourceResolverFactory.java Wed Apr 25 21:33:14 2012
@@ -100,6 +100,12 @@ public interface ResourceResolverFactory
      * {@link #USER_IMPERSONATION} attribute the <code>ResourceResolver</code>
      * returned will only have administrative privileges if the user identified
      * by the property has administrative privileges.
+     * <p>
+     * <b><i>NOTE: This method is intended for use by infrastructure bundles to
+     * access the repository and provide general services. This method MUST not
+     * be used to handle client requests of whatever kinds. To handle client
+     * requests a regular authenticated resource resolver retrieved
+     * through {@link #getResourceResolver(Map)} must be used.</i></b>
      *
      * @param authenticationInfo A map of further credential information which
      *            may be used by the implementation to parametrize how the