[sling-org-apache-sling-servlets-post] branch master updated: SLING-6722 - explain deprecation

[bd...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

bdelacretaz pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/sling-org-apache-sling-servlets-post.git


The following commit(s) were added to refs/heads/master by this push:
     new 4484228  SLING-6722 - explain deprecation
4484228 is described below

commit 44842281471fc12f19a965d68beab4147acdc603
Author: Bertrand Delacretaz <bd...@apache.org>
AuthorDate: Thu Jun 11 10:29:52 2020 +0200

    SLING-6722 - explain deprecation
---
 .../java/org/apache/sling/servlets/post/AbstractPostOperation.java  | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/main/java/org/apache/sling/servlets/post/AbstractPostOperation.java b/src/main/java/org/apache/sling/servlets/post/AbstractPostOperation.java
index 755ef15..135006a 100644
--- a/src/main/java/org/apache/sling/servlets/post/AbstractPostOperation.java
+++ b/src/main/java/org/apache/sling/servlets/post/AbstractPostOperation.java
@@ -48,7 +48,11 @@ import org.slf4j.LoggerFactory;
  * {@link PostOperation} service interface providing actual implementations with
  * useful tooling and common functionality like preparing the change logs or
  * saving or refreshing the JCR Session.
- * @deprecated
+ *
+ * @deprecated (SLING-6722): this class mixes Sling and JCR APIs which is not
+ *  optimal as nowadays we favor the Sling APIs. There's no intention to remove
+ *  it however, if you're using JCR APIs anyways in your project it's fine to
+ *  use it. Theres no public replacement for it as I write this.
  */
 @Deprecated
 public abstract class AbstractPostOperation implements PostOperation {