Author: fmeschbe
Date: Wed Jul 3 09:06:36 2013
New Revision: 1499283
URL: http://svn.apache.org/r1499283
Log:
Implement support for service based ResourceResolver and Session access
- Clarify deprecation and replacement
Modified:
sling/whiteboard/fmeschbe/deprecate_login_administrative/jcr/api/src/main/java/org/apache/sling/jcr/api/SlingRepository.java
Modified:
sling/whiteboard/fmeschbe/deprecate_login_administrative/jcr/api/src/main/java/org/apache/sling/jcr/api/SlingRepository.java
URL:
http://svn.apache.org/viewvc/sling/whiteboard/fmeschbe/deprecate_login_administrative/jcr/api/src/main/java/org/apache/sling/jcr/api/SlingRepository.java?rev=1499283&r1=1499282&r2=1499283&view=diff
==============================================================================
---
sling/whiteboard/fmeschbe/deprecate_login_administrative/jcr/api/src/main/java/org/apache/sling/jcr/api/SlingRepository.java
(original)
+++
sling/whiteboard/fmeschbe/deprecate_login_administrative/jcr/api/src/main/java/org/apache/sling/jcr/api/SlingRepository.java
Wed Jul 3 09:06:36 2013
@@ -59,11 +59,18 @@ public interface SlingRepository extends
* requests a regular authenticated session retrieved through
* {@link #login(javax.jcr.Credentials, String)} or
* {@link Session#impersonate(javax.jcr.Credentials)} must be used.</i></b>
+ * <p>
+ * This method is deprecated. Services running in the Sling system should
+ * use the {@link #loginService(String serviceInfo, String workspace)}
+ * method instead. Implementations of this method should throw
+ * {@code javax.jcr.LoginException} if they don't support it.
*
* @param workspace The name of the workspace to which to get an
* administrative session. If <code>null</code> the
* {@link #getDefaultWorkspace()} default workspace is assumed.
- *
+ * @return The administrative Session
+ * @throws RepositoryException If an error occurrs creating the
+ * administrative session
* @deprecated as of 2.2 (bundle version 2.2.0) because of inherent
security
* issues. Services requiring specific permissions should use
* the {@link #loginService(String, String)} instead.
