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

[cziegeler]

Author: cziegeler
Date: Mon Aug 25 09:11:44 2014
New Revision: 1620281

URL: http://svn.apache.org/r1620281
Log:
SLING-3868 : Provide a way to get/set a resource resolver associated to the 
current threadSLING-3868 : Provide a way to get/set a resource resolver 
associated to the current thread

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=1620281&r1=1620280&r2=1620281&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
 Mon Aug 25 09:11:44 2014
@@ -161,11 +161,11 @@ public interface ResourceResolverFactory
      * If such permission is missing, a {@code LoginException} is thrown.
      *
      * @param authenticationInfo A map of further service information which may
-     *            be used by the implementation to parametrize how the resource
+     *            be used by the implementation to parameterize how the 
resource
      *            resolver is created. This may be <code>null</code>.
      * @return A {@link ResourceResolver} with appropriate permissions to
      *         execute the service.
-     * @throws LoginException If an error occurrs creating the new
+     * @throws LoginException If an error occurs creating the new
      *             <code>ResourceResolver</code> for the service represented by
      *             the calling bundle.
      * @since 2.4 (bundle version 2.5.0) to replace
@@ -175,4 +175,18 @@ public interface ResourceResolverFactory
      *      Authentication</a>
      */
     ResourceResolver getServiceResourceResolver(Map<String, Object> 
authenticationInfo) throws LoginException;
+
+    /**
+     * Returns the {@link ResourceResolver} for the current thread.
+     * <p>
+     * Each resource resolver created by {@link #getResourceResolver(Map)} is 
associated with
+     * the thread of its creation time. From within this thread, this method 
returns
+     * the last non-closed resource resolver. When a resource resolver is 
closed, the
+     * association is removed.
+     *
+     * @return A {@link ResourceResolver} created from the current thread or 
<code>null</code>.
+     *
+     * @since 2.6
+     */
+    ResourceResolver getThreadResourceResolver();
 }