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:03 UTC

[sling-org-apache-sling-jcr-contentparser] branch issue/SLING-8598 created (now 6be73c3)

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

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


      at 6be73c3  SLING-8598 - Deprecate org.apache.sling.jcr.contentparser

This branch includes the following new commits:

     new 6be73c3  SLING-8598 - Deprecate org.apache.sling.jcr.contentparser

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.



[sling-org-apache-sling-jcr-contentparser] 01/01: SLING-8598 - Deprecate org.apache.sling.jcr.contentparser

Posted by ra...@apache.org.
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;