W-17525042: RevAPI JPMS support.

pom.xml

@@ -109,9 +109,17 @@
                 <type>pom</type>
                 <scope>import</scope>
             </dependency>
+            <dependency>
+                <groupId>org.junit</groupId>
+                <artifactId>junit-bom</artifactId>
+                <version>5.11.3</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
         </dependencies>
     </dependencyManagement>
 
+
     <dependencies>
         <dependency>
             <groupId>org.mule.runtime</groupId>
@@ -133,11 +141,6 @@
         </dependency>
 
         <!-- test -->
-        <dependency>
-            <groupId>junit</groupId>
-            <artifactId>junit</artifactId>
-            <scope>test</scope>
-        </dependency>
         <dependency>
             <groupId>org.hamcrest</groupId>
             <artifactId>hamcrest</artifactId>
@@ -149,6 +152,16 @@
             <type>pom</type>
             <scope>test</scope>
         </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-params</artifactId>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
 
     <build>

src/main/java/org/mule/tools/revapi/ApiBoundary.java

@@ -0,0 +1,61 @@
+/*
+ * Copyright 2023 Salesforce, Inc. All rights reserved.
+ * The software in this package is published under the terms of the CPAL v1.0
+ * license, a copy of which has been included with this distribution in the
+ * LICENSE.txt file.
+ */
+package org.mule.tools.revapi;
+
+import static java.util.Objects.requireNonNull;
+
+import org.revapi.Element;
+import org.revapi.java.spi.JavaTypeElement;
+
+public interface ApiBoundary {
+
+  /**
+   * @param element The element that is going to be checked.
+   * @return True if the element is part of the API.
+   */
+  default boolean isApi(Element<?> element) {
+    return isApi(findParentJavaTypeElement(element));
+  }
+
+  /**
+   * @param element The element that is going to be checked
+   * @return True if the element is part of the API.
+   */
+  boolean isApi(JavaTypeElement element);
+
+  /**
+   * @return true if any valid call to {@link #isApi(Element)} or {@link #isApi(JavaTypeElement)} will return false.
+   */
+  boolean isEmpty();
+
+  default String getPackageName(JavaTypeElement element) {
+    String canonicalName = element.getDeclaringElement().getQualifiedName().toString();
+    int index = canonicalName.lastIndexOf(".");
+    return canonicalName.substring(0, index);
+  }
+
+  /**
+   * Walks the {@link Element} hierarchy up in order to return the top parent {@link JavaTypeElement} found.
+   * 
+   * @param element The element that will be walked.
+   * @return The top {@link JavaTypeElement} found.
+   * @throws IllegalStateException If no {@link JavaTypeElement} could be found.
+   */
+  private static JavaTypeElement findParentJavaTypeElement(Element<?> element) {
+    requireNonNull(element, "Element must not be null.");
+    Element<?> typeElement = element;
+    while (typeElement != null
+        && (!(typeElement instanceof JavaTypeElement) || typeElement.getParent() instanceof JavaTypeElement)) {
+      typeElement = typeElement.getParent();
+    }
+    if (typeElement == null) {
+      throw new IllegalStateException("Could not find the Java Type element for: " + element.getFullHumanReadableString());
+    }
+    return (JavaTypeElement) typeElement;
+  }
+
+}

src/main/java/org/mule/tools/revapi/CachedApiBoundary.java

@@ -0,0 +1,43 @@
+/*
+ * Copyright 2023 Salesforce, Inc. All rights reserved.
+ * The software in this package is published under the terms of the CPAL v1.0
+ * license, a copy of which has been included with this distribution in the
+ * LICENSE.txt file.
+ */
+package org.mule.tools.revapi;
+
+import org.revapi.java.spi.JavaTypeElement;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public class CachedApiBoundary implements ApiBoundary {
+
+  private final ApiBoundary delegate;
+  private final Map<JavaTypeElement, Boolean> isApiCache = new HashMap<>();
+
+  public CachedApiBoundary(ApiBoundary delegate) {
+    this.delegate = delegate;
+  }
+
+  @Override
+  public boolean isApi(JavaTypeElement element) {
+    if (isApiCache.containsKey(element)) {
+      return isApiCache.get(element);
+    } else {
+      final boolean isApi = delegate.isApi(element);
+      isApiCache.put(element, isApi);
+      return isApi;
+    }
+  }
+
+  @Override
+  public boolean isEmpty() {
+    return delegate.isEmpty();
+  }
+
+  @Override
+  public String toString() {
+    return delegate.toString();
+  }
+}