[apex] Internalize ApexParser and ApexHandler

docs/pages/release_notes.md

@@ -103,6 +103,11 @@ The command line version of PMD continues to use **scala 2.13**.
     [Testing your implementation](pmd_devdocs_major_adding_new_cpd_language.html#testing-your-implementation)
     in the developer documentation.
 
+#### Internal API
+
+*   {% jdoc apex::lang.apex.ApexParser %}
+*   {% jdoc apex::lang.apex.ApexHandler %}
+
 ### External Contributions
 
 *   [#2349](https://github.com/pmd/pmd/pull/2349): \[java] Optimize UnusedPrivateMethodRule - [shilko2013](https://github.com/shilko2013)

pmd-apex/src/main/java/net/sourceforge/pmd/lang/apex/ApexHandler.java

@@ -8,6 +8,7 @@ import java.io.Writer;
 import java.util.Arrays;
 import java.util.List;
 
+import net.sourceforge.pmd.annotation.InternalApi;
 import net.sourceforge.pmd.lang.AbstractLanguageVersionHandler;
 import net.sourceforge.pmd.lang.Parser;
 import net.sourceforge.pmd.lang.ParserOptions;
@@ -26,6 +27,11 @@ import net.sourceforge.pmd.lang.metrics.internal.AbstractLanguageMetricsProvider
 import net.sourceforge.pmd.lang.rule.RuleViolationFactory;
 
 
+/**
+ * @deprecated Internal API
+ */
+@Deprecated
+@InternalApi
 public class ApexHandler extends AbstractLanguageVersionHandler {
 
     private final ApexMetricsProvider myMetricsProvider = new ApexMetricsProvider();

pmd-apex/src/main/java/net/sourceforge/pmd/lang/apex/ApexParser.java

@@ -7,7 +7,9 @@ package net.sourceforge.pmd.lang.apex;
 import java.io.Reader;
 import java.util.Map;
 
+import net.sourceforge.pmd.annotation.InternalApi;
 import net.sourceforge.pmd.lang.AbstractParser;
+import net.sourceforge.pmd.lang.LanguageVersionHandler;
 import net.sourceforge.pmd.lang.ParserOptions;
 import net.sourceforge.pmd.lang.TokenManager;
 import net.sourceforge.pmd.lang.ast.Node;
@@ -15,7 +17,11 @@ import net.sourceforge.pmd.lang.ast.ParseException;
 
 /**
  * Adapter for the Apex jorje parser
+ *
+ * @deprecated This is internal API, use {@link LanguageVersionHandler#getParser(ParserOptions)}.
  */
+@InternalApi
+@Deprecated
 public class ApexParser extends AbstractParser {
     private net.sourceforge.pmd.lang.apex.ast.ApexParser apexParser;
 

pmd-apex/src/main/java/net/sourceforge/pmd/lang/apex/ast/ApexParser.java

@@ -10,6 +10,7 @@ import java.util.Map;
 
 import org.apache.commons.io.IOUtils;
 
+import net.sourceforge.pmd.annotation.InternalApi;
 import net.sourceforge.pmd.lang.apex.ApexJorjeLogging;
 import net.sourceforge.pmd.lang.apex.ApexParserOptions;
 import net.sourceforge.pmd.lang.ast.ParseException;
@@ -23,6 +24,11 @@ import apex.jorje.semantic.ast.compilation.UserTrigger;
 import apex.jorje.semantic.ast.visitor.AdditionalPassScope;
 import apex.jorje.semantic.ast.visitor.AstVisitor;
 
+/**
+ * @deprecated Internal API
+ */
+@InternalApi
+@Deprecated
 public class ApexParser {
     protected final ApexParserOptions parserOptions;