You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sling.apache.org by ra...@apache.org on 2019/07/31 10:37:04 UTC
[sling-org-apache-sling-jcr-contentparser] 01/01: SLING-8598 - Deprecate org.apache.sling.jcr.contentparser

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

radu pushed a commit to branch issue/SLING-8598
in repository https://gitbox.apache.org/repos/asf/sling-org-apache-sling-jcr-contentparser.git

commit 6be73c303a85aff23e6b8567f50f1a9380951034
Author: Radu Cotescu <ra...@apache.org>
AuthorDate: Wed Jul 31 12:29:17 2019 +0200

    SLING-8598 - Deprecate org.apache.sling.jcr.contentparser
---
 README.md                                                             | 4 ++--
 src/main/java/org/apache/sling/jcr/contentparser/ContentHandler.java  | 4 ++++
 src/main/java/org/apache/sling/jcr/contentparser/ContentParser.java   | 4 ++++
 .../java/org/apache/sling/jcr/contentparser/ContentParserFactory.java | 4 ++++
 src/main/java/org/apache/sling/jcr/contentparser/ContentType.java     | 3 +++
 .../java/org/apache/sling/jcr/contentparser/JsonParserFeature.java    | 3 +++
 src/main/java/org/apache/sling/jcr/contentparser/ParseException.java  | 3 +++
 src/main/java/org/apache/sling/jcr/contentparser/ParserOptions.java   | 3 +++
 src/main/java/org/apache/sling/jcr/contentparser/package-info.java    | 1 +
 9 files changed, 27 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index dfe5a49..fcc7262 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 [<img src="https://sling.apache.org/res/logos/sling.png"/>](https://sling.apache.org)
 
- [![Build Status](https://builds.apache.org/buildStatus/icon?job=Sling/sling-org-apache-sling-jcr-contentparser/master)](https://builds.apache.org/job/Sling/job/sling-org-apache-sling-jcr-contentparser/job/master) [![Test Status](https://img.shields.io/jenkins/t/https/builds.apache.org/job/Sling/job/sling-org-apache-sling-jcr-contentparser/job/master.svg)](https://builds.apache.org/job/Sling/job/sling-org-apache-sling-jcr-contentparser/job/master/test_results_analyzer/) [![Maven Central] [...]
+ [![Build Status](https://builds.apache.org/buildStatus/icon?job=Sling/sling-org-apache-sling-jcr-contentparser/master)](https://builds.apache.org/job/Sling/job/sling-org-apache-sling-jcr-contentparser/job/master) [![Test Status](https://img.shields.io/jenkins/t/https/builds.apache.org/job/Sling/job/sling-org-apache-sling-jcr-contentparser/job/master.svg)](https://builds.apache.org/job/Sling/job/sling-org-apache-sling-jcr-contentparser/job/master/test_results_analyzer/) [![Maven Central] [...]
 
 # Apache Sling JCR Content Parser
 
@@ -9,4 +9,4 @@ This module is part of the [Apache Sling](https://sling.apache.org) project.
 Parser for JCR repository content stored in files (e.g. JSON, FileVault XML).
 
 ### Note
-This module will soon be deprecated in favour of https://github.com/apache/sling-org-apache-sling-contentparser-api.
+This module has been deprecated in favour of https://github.com/apache/sling-org-apache-sling-contentparser-api.
diff --git a/src/main/java/org/apache/sling/jcr/contentparser/ContentHandler.java b/src/main/java/org/apache/sling/jcr/contentparser/ContentHandler.java
index 8c88d84..1f755df 100644
--- a/src/main/java/org/apache/sling/jcr/contentparser/ContentHandler.java
+++ b/src/main/java/org/apache/sling/jcr/contentparser/ContentHandler.java
@@ -26,7 +26,11 @@ import org.osgi.annotation.versioning.ConsumerType;
  * Handler that gets notified while parsing content with {@link ContentParser}.
  * The resources are always reported in order of their paths as found in the content fragment.
  * Parents are always reported before their children.
+ *
+ * @deprecated since version 1.2.8 of the {@code org.apache.sling.jcr.contentparser} bundle;
+ * see <a href="https://github.com/apache/sling-org-apache-sling-contentparser-api">{@code org.apache.sling.contentparser.api}</a>
  */
+@Deprecated
 @ConsumerType
 public interface ContentHandler {
 
diff --git a/src/main/java/org/apache/sling/jcr/contentparser/ContentParser.java b/src/main/java/org/apache/sling/jcr/contentparser/ContentParser.java
index 4876986..c65879c 100644
--- a/src/main/java/org/apache/sling/jcr/contentparser/ContentParser.java
+++ b/src/main/java/org/apache/sling/jcr/contentparser/ContentParser.java
@@ -26,8 +26,12 @@ import org.osgi.annotation.versioning.ProviderType;
 /**
  * Parses repository content from a file.
  * Implementations have to be thread-safe.
+ *
+ * @deprecated since version 1.2.8 of the {@code org.apache.sling.jcr.contentparser} bundle;
+ * see <a href="https://github.com/apache/sling-org-apache-sling-contentparser-api">{@code org.apache.sling.contentparser.api}</a>
  */
 @ProviderType
+@Deprecated
 public interface ContentParser {
 
     /**
diff --git a/src/main/java/org/apache/sling/jcr/contentparser/ContentParserFactory.java b/src/main/java/org/apache/sling/jcr/contentparser/ContentParserFactory.java
index 8894de6..bf7cab1 100644
--- a/src/main/java/org/apache/sling/jcr/contentparser/ContentParserFactory.java
+++ b/src/main/java/org/apache/sling/jcr/contentparser/ContentParserFactory.java
@@ -25,7 +25,11 @@ import org.osgi.annotation.versioning.ProviderType;
 
 /**
  * Factory for content parsers.
+ *
+ * @deprecated since version 1.2.8 of the {@code org.apache.sling.jcr.contentparser} bundle;
+ * see <a href="https://github.com/apache/sling-org-apache-sling-contentparser-api">{@code org.apache.sling.contentparser.api}</a>
  */
+@Deprecated
 @ProviderType
 public final class ContentParserFactory {
 
diff --git a/src/main/java/org/apache/sling/jcr/contentparser/ContentType.java b/src/main/java/org/apache/sling/jcr/contentparser/ContentType.java
index ab8f935..54b3d37 100644
--- a/src/main/java/org/apache/sling/jcr/contentparser/ContentType.java
+++ b/src/main/java/org/apache/sling/jcr/contentparser/ContentType.java
@@ -22,6 +22,9 @@ import org.osgi.annotation.versioning.ProviderType;
 
 /**
  * Content types.
+ *
+ * @deprecated since version 1.2.8 of the {@code org.apache.sling.jcr.contentparser} bundle;
+ * see <a href="https://github.com/apache/sling-org-apache-sling-contentparser-api">{@code org.apache.sling.contentparser.api}</a>
  */
 @ProviderType
 public enum ContentType {
diff --git a/src/main/java/org/apache/sling/jcr/contentparser/JsonParserFeature.java b/src/main/java/org/apache/sling/jcr/contentparser/JsonParserFeature.java
index 59c5a23..f48f0cd 100644
--- a/src/main/java/org/apache/sling/jcr/contentparser/JsonParserFeature.java
+++ b/src/main/java/org/apache/sling/jcr/contentparser/JsonParserFeature.java
@@ -20,6 +20,9 @@ package org.apache.sling.jcr.contentparser;
 
 /**
  * Feature flags for parsing JSON files.
+ *
+ * @deprecated since version 1.2.8 of the {@code org.apache.sling.jcr.contentparser} bundle;
+ * see <a href="https://github.com/apache/sling-org-apache-sling-contentparser-api">{@code org.apache.sling.contentparser.api}</a>
  */
 public enum JsonParserFeature {
 
diff --git a/src/main/java/org/apache/sling/jcr/contentparser/ParseException.java b/src/main/java/org/apache/sling/jcr/contentparser/ParseException.java
index 38970b8..2e0bba6 100644
--- a/src/main/java/org/apache/sling/jcr/contentparser/ParseException.java
+++ b/src/main/java/org/apache/sling/jcr/contentparser/ParseException.java
@@ -22,6 +22,9 @@ import org.osgi.annotation.versioning.ProviderType;
 
 /**
  * Parsing exception.
+ *
+ * @deprecated since version 1.2.8 of the {@code org.apache.sling.jcr.contentparser} bundle;
+ * see <a href="https://github.com/apache/sling-org-apache-sling-contentparser-api">{@code org.apache.sling.contentparser.api}</a>
  */
 @ProviderType
 public final class ParseException extends RuntimeException {
diff --git a/src/main/java/org/apache/sling/jcr/contentparser/ParserOptions.java b/src/main/java/org/apache/sling/jcr/contentparser/ParserOptions.java
index 1c006ea..de20469 100644
--- a/src/main/java/org/apache/sling/jcr/contentparser/ParserOptions.java
+++ b/src/main/java/org/apache/sling/jcr/contentparser/ParserOptions.java
@@ -28,6 +28,9 @@ import org.osgi.annotation.versioning.ProviderType;
 
 /**
  * Options for content parser.
+ *
+ * @deprecated since version 1.2.8 of the {@code org.apache.sling.jcr.contentparser} bundle;
+ * see <a href="https://github.com/apache/sling-org-apache-sling-contentparser-api">{@code org.apache.sling.contentparser.api}</a>
  */
 @ProviderType
 public final class ParserOptions {
diff --git a/src/main/java/org/apache/sling/jcr/contentparser/package-info.java b/src/main/java/org/apache/sling/jcr/contentparser/package-info.java
index 51afb23..15831f8 100644
--- a/src/main/java/org/apache/sling/jcr/contentparser/package-info.java
+++ b/src/main/java/org/apache/sling/jcr/contentparser/package-info.java
@@ -19,5 +19,6 @@
 /**
  * Parser for repository content serialized e.g. as JSON or JCR XML.
  */
+@Deprecated
 @org.osgi.annotation.versioning.Version("1.3.0")
 package org.apache.sling.jcr.contentparser;